インストール | Salesforce用Tealium | Tealiumドキュメント

要件

Salesforce管理者アクセス
AudienceStreamまたはEventStream用に有効化されたTealiumアカウント

ソリューションのインストール

Tealium for Salesforceソリューションは、Tealium Collectサービス用のApexクラスとオブジェクト更新をトリガーするための1つ以上のクラスとしてインストールされます。また、Customer Data HubからのレコードをSalesforceにリンクし、SalesforceからTealiumへのHTTPリクエストの送信を許可するために、Salesforce構成の更新が必要です。

Customer Data HubからSalesforceへのレコードリンク

Tealium for Salesforceソリューションは、共有識別子属性を指定することで、Customer Data HubからSalesforceにレコードをリンクできます。Customer Data Hubでは、この属性は摂取同期から来るレコードを一意に識別する任意の訪問ID属性にすることができます。Salesforceでは、そのCustomer Data Hub属性をキャプチャするためにオブジェクトにTealium IDというカスタムフィールドを作成する必要があります。

詳細については、Salesforce Connector Setup Guide for AudienceStreamを参照してください。

リードオブジェクトにこのカスタムフィールドを追加するには：

構成からリード > フィールドへ進みます。
次の構成でテキストタイプの新しいカスタムフィールドを追加します：
- フィールドラベル: Tealium ID.
- 長さ: 100.
- フィールド名: tealium_id_teal.
_teal接尾辞は、これらの変数がTealiumに特有であることを示します。
保存をクリックします。

`TealiumCollect` Apexクラスの作成

このTealiumCollect Apexクラスは、Tealium CollectサービスへのHTTPリクエストを生成します。それはTealium構成とデータレイヤー値を取り、必要なURL形式にフォーマットします。

詳細については、Apex Developer Guide: Introducing Apexを参照してください。

TealiumCollect Apexクラスを追加するには：

開発者コンソールでTealiumCollectという名前のクラスを作成します。
次のコードをコピーして貼り付け、アカウント、プロファイル、データソースキーを指定してください：

public class TealiumCollect {
    private static Boolean debug = true;
    /* TEALIUM CONFIGURATION */
    private static String tealiumAccount       = "YOUR_ACCOUNT";
    private static String tealiumProfile       = "YOUR_PROFILE";
    private static String tealiumDataSourceKey = "YOUR_DATASOURCE_KEY";
    private static String tealiumEventType     = "derived";
    private static String tealiumEndpoint      = "https://collect.tealiumiq.com/event";
    @future(callout=true)
    public static void track(Map<String, String> tealiumData){
        List<String> tealiumParams = New List<String>();
        tealiumParams.add("tealium_account"    + "=" + tealiumAccount);
        tealiumParams.add("tealium_profile"    + "=" + tealiumProfile);
        tealiumParams.add("tealium_datasource" + "=" + tealiumDataSourceKey);
        tealiumParams.add("tealium_event_type" + "=" + tealiumEventType);
        tealiumParams.add("tealium_event"      + "=" +
            EncodingUtil.urlEncode(tealiumData.get("tealium_event"), "UTF-8"));
        String tealiumVid = tealiumData.get("tealium_visitor_id");
        if(tealiumVid == null || tealiumVid == ""){
            tealiumData.remove("tealium_visitor_id");
        }
        for(String key : tealiumData.keySet()){
            try{
                String value = tealiumData.get(key);
                Boolean valueTest = (value != null);
                tealiumParams.add(key + "=" + (valueTest ? EncodingUtil.urlEncode(value, "UTF-8") : ""));
            }catch(Exception e){}
        }
        HttpRequest req = new HttpRequest();
        String tealCollect = tealiumEndpoint + "?" + String.join(tealiumParams, "&");
        req.setEndpoint(tealCollect);
        if(debug){
            System.debug(tealCollect);
        }
        req.setMethod("GET");
        Http http = new Http();
        HTTPResponse res = http.send(req);
    }
}

リードまたはコンタクト更新のためのApexトリガーの作成

このトリガーは、Salesforceオブジェクトの更新に基づいてアクティブ化されます。トリガーは多くの他のオブジェクトステージでアクティブ化するように変更でき、特定のシナリオにフィルタリングしてカスタマイズすることができます。

詳細については、Apex Developer Guide: Triggersを参照してください。

Tealiumトリガーを作成するための手順は次のとおりです：

開発者コンソール内で、TealiumLeadUpdate（またはオブジェクトに基づいてTealiumContactUpdate）という名前のトリガーを作成します。
以下のコンタクトオブジェクトトリガーコードまたはリードオブジェクトトリガーコードをコピーして貼り付けます。
トラッキングしているオブジェクト（ContactまたはLead）に合わせてコードを変更します。

コンタクトオブジェクトトリガー

trigger tealiumContactUpdate on Contact (after insert, after update) {
    String tealiumEvent = "crm_contact_update";

    /* POPULATE TEALIUM DATA LAYER */
    Map<string,string> tealiumData = new Map<string,string>();
    for (Contact sfdcObj : Trigger.new ){
        /* REQUIRED TEALIUM DATA */
        tealiumData.put("tealium_event", tealiumEvent);
        tealiumData.put("tealium_visitor_id", sfdcObj.tealium_id_teal__c);

        /* SFDC DATA */
        tealiumData.put("customer_email",      sfdcObj.Email);
        tealiumData.put("crm_lead_source",     sfdcObj.LeadSource);
        tealiumData.put("has_opted_out_email", String.valueOf(sfdcObj.HasOptedOutOfEmail));
        tealiumData.put("has_opted_out_phone", String.valueOf(sfdcObj.DoNotCall));
        tealiumData.put("mobile_phone_number", String.valueOf(sfdcObj.MobilePhone));
        tealiumData.put("home_phone_number",   String.valueOf(sfdcObj.Phone));
        tealiumData.put("customer_first_name", sfdcObj.FirstName);
        tealiumData.put("customer_last_name",  sfdcObj.LastName);
        tealiumData.put("customer_title",      sfdcObj.Title);
        tealiumData.put("crm_account",         String.valueOf(sfdcObj.Account));
        /* Addition Custom Fields */
        /* tealiumData.put("custom_field", sfdcObj.customField); */

        TealiumCollect.track(tealiumData);
    }
}

リードオブジェクトトリガー

trigger tealiumLeadUpdate on Lead (after insert, after update) {
    String tealiumEvent = "crm_lead_update";

    /* POPULATE TEALIUM DATA LAYER */
    Map<string,string> tealiumData = new Map<string,string>();
    for (Lead sfdcObj : Trigger.new ){
        /* REQUIRED TEALIUM DATA */
        tealiumData.put("tealium_event", tealiumEvent);
        tealiumData.put("tealium_visitor_id", sfdcObj.tealium_id_teal__c);

        /* SFDC DATA */
        tealiumData.put("customer_email",      sfdcObj.Email);
        tealiumData.put("crm_lead_status",     sfdcObj.Status);
        tealiumData.put("crm_lead_source",     sfdcObj.LeadSource);
        tealiumData.put("crm_lead_rating",     sfdcObj.Rating);
        tealiumData.put("crm_lead_industry",   sfdcObj.Industry);
        tealiumData.put("crm_lead_company",    sfdcObj.Company);
        tealiumData.put("has_opted_out_email", String.valueOf(sfdcObj.HasOptedOutOfEmail));
        tealiumData.put("has_opted_out_phone", String.valueOf(sfdcObj.DoNotCall));
        tealiumData.put("mobile_phone_number", String.valueOf(sfdcObj.MobilePhone));
        tealiumData.put("home_phone_number",   String.valueOf(sfdcObj.Phone));
        tealiumData.put("customer_first_name", sfdcObj.FirstName);
        tealiumData.put("customer_last_name",  sfdcObj.LastName);
        /* Addition Custom Fields */
        /* tealiumData.put("custom_field", sfdcObj.customField); */

        TealiumCollect.track(tealiumData);
    }
}

リード変換マッピング

カスタムフィールド Tealium ID をリードからコンタクトへの変換時に保持するためには、Lead.Tealium ID を Contact.Tealium ID にマッピングする必要があります。

詳細については、Salesforce Sales Cloud Basics: Map Custom Lead Fields for Lead Conversionを参照してください。

カスタムフィールドマッピングを作成するには、以下の手順に従ってください：

Lead > Fields に移動します。
Map Fields をクリックします。
Contact をクリックします。
Lead列の tealium_id をContact列の Tealium ID にマッピングします。
Save をクリックします。

リモートサイト構成の有効化

Tealium Collectエンドポイントは、HTTPリクエストを送信するためにSalesforceのリモートサイト構成に登録する必要があります。

詳細については、Apex Developer Guide: Adding Remote Site Settingsを参照してください。

以下の構成でリモートサイトを作成します：

リモートサイト名: TealiumCollect
リモートサイトURL: https://collect.tealiumiq.com
プロトコルセキュリティの無効化: 有効

リモートサイトの例

Salesforceイベント属性の追加

Apexトリガーコードで使用されるSalesforce変数は、Tealiumのイベント属性として定義する必要があります。Salesforceからどのようなデータが来ているかを確認するには、トリガーコードを調べるか、Live Eventsを使用してリアルタイムでデータを確認してください。

イベント属性を追加するには、以下の手順に従ってください：

Enrich > Attributes に移動します。
+ Add Attribute をクリックします。
スコープを選択：Event。
タイプを選択：Universal Data Object。
データタイプを選択：String。
トリガーコードで使用されている変数名と同じ Name を構成します。例えば crm_lead_status など。
保存して公開します。

要件