Salesforce Data 360 - Kameleoon Documentation

Salesforce Data 360 で構築されたカスタマープロファイル（オーディエンスの所属や行動属性を含む）は、デフォルトでは Kameleoon から参照できません。2 つのプラットフォームを直接つなぐ仕組みがなければ、マーケティングチームや製品チームはこの統合されたカスタマーデータを使って実験をターゲティングしたり、サイト上のエクスペリエンスをパーソナライズしたりできません。 Salesforce Data 360 は、Amazon S3 や Secure File Transfer Protocol（SFTP）など、外部ファイルストレージの宛先にセグメントとプロファイル属性をアクティベートします。Kameleoon はこれらのアクティベーションファイルを取り込み、Salesforce データを kameleoon_visitor_code を使用して対応する Kameleoon 訪問者に関連付けます。同期後、Salesforce オーディエンスと属性を Kameleoon カスタムデータとして公開して、Kameleoon セグメントビルダーのターゲティング条件として使用できます。

この統合はオンデマンドで提供されます。詳細については、カスタマーサクセスマネージャー(CSM)にお問い合わせください。

ユースケース：

特定の Salesforce オーディエンス（例えば 高価値顧客 など）に属する訪問者をターゲットします。
特定の属性（例えば customer_tier が Gold など）に基づいて顧客をターゲットします。
loyalty_status、lifetime_value_band、churn_risk などの行動データに基づいてエクスペリエンスをパーソナライズします。
Salesforce データを他の Kameleoon ターゲティング条件とネイティブに組み合わせます。

Salesforce Data 360 の同期がどのように機能するか

統合は、Kameleoon 訪問者コードが両プラットフォーム間の共通識別子として機能することに依存しています。 同期は、以下の継続的なワークフローに従います：

識別子を送信する： ユーザーの訪問中に、ウェブサイトは Kameleoon 訪問者コードを Salesforce Data 360 に送信します。
データをエクスポートする： Salesforce は定期的に、オーディエンスメンバーシップと選択した顧客属性を S3 または SFTP の宛先に公開します。
データを取り込む： Kameleoon はこれらのアクティベーションファイルを処理し、Salesforce データを対応する kameleoon_visitor_code に対して保存します。
訪問者をターゲットする： 訪問者の次の操作時に、Kameleoon はこの情報をカスタムデータを通じて取得し、アクティブなターゲティングセグメントに対して評価します。

Salesforce Data 360 統合の前提条件

Kameleoon と Salesforce Data 360 間の統合を設定する前に、以下の要件を満たしていることを確認してください：

Salesforce Data 360 アカウントがあり、データモデルオブジェクト、マッピング、セグメント、接続、およびアクティベーション対象を設定する管理権限があります。
アクティブな Kameleoon プロジェクトがあります。
Kameleoon 担当者が、プロジェクト用の特定の S3 または SFTP 接続認証情報を提供しています。

ステップ 1：Kameleoon 訪問者コードを Salesforce に送信する

Salesforce プロファイルを Kameleoon 訪問者に関連付けるには、環境が Kameleoon 訪問者コードを Salesforce Interactions に送信する必要があります。 Kameleoon の グローバルスクリプト に以下の JavaScript を追加します。このロジックにより、スクリプトは訪問ごとに正確に 1 回だけ訪問者コードを Salesforce に送信し、Salesforce オブジェクトがページで利用可能になったときにのみ実行されることが保証されます：

// 現在の訪問の最初のページビューでのみ実行することを確認
if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Core.runWhenConditionTrue(
        function () {
            // Salesforce Interactions SDK が初期化されるのを待つ
            return (
                typeof window.SalesforceInteractions !== "undefined" &&
                typeof window.SalesforceInteractions.sendEvent === "function"
            );
        },
        function () {
            // Kameleoon 訪問者コードを Salesforce に送信する
            window.SalesforceInteractions.sendEvent({
                user: {
                    attributes: {
                        eventType: "kameleoonIdentity",
                        kameleoonVisitorCode: Kameleoon.API.Visitor.code
                    }
                }
            });
        },
        500 // ポーリング間隔（ミリ秒）
    );
}

ステップ 2：Salesforce Data 360 で訪問者コードを追加およびマップする

訪問者コードが Salesforce 環境に流れ込む状態で、Salesforce Individual Data Model Object（DMO）に、それを保存するための宛先フィールドを作成します。

Salesforce Data 360 でフィールドを作成する

Salesforce Data 360 で、Data Model に移動します。
Individual DMO を開き、Edit をクリックします。
Add Field をクリックし、以下の正確な値を使用して設定します：

Setting	Value
Field label	Kameleoon visitor code
Field API name	`kameleoon_visitor_code`
Data type	Text
Primary key	No
Enable value suggestion	No

Save をクリックして、DMO を更新します。

フィールドを Data Lake Object にマップする

DMO フィールドを作成しても、自動的には入力されません。受け取ったデータレイクオブジェクト（DLO）からのフィールドを、新しい DMO フィールドにマップする必要があります。

関連するデータレイクオブジェクト（例えば、ウェブサイト DLO）に移動します。
Kameleoon 訪問者識別子を含むソースフィールドを Individual.kameleoon_visitor_code にマップします。

ステップ 3：Salesforce と Kameleoon の間の接続を設定する

Kameleoon は、Amazon S3 または SFTP を通じた Salesforce Data 360 アクティベーションをサポートしています。Kameleoon 担当者が提供した認証情報に基づいて、以下の転送方法の 1 つを選択して設定します。

Kameleoon は、統合の設定に SFTP オプションを使用することを推奨します。

オプション A：Salesforce Data 360 用に Amazon S3 を設定する

Salesforce Data 360 で、Data Cloud Setup に移動します。
External Integrations で、More Connectors > New を選択します。
Target で、Amazon S3 を選択します。
接続名を入力します（例：Kameleoon integration）。
Access Key/Secret Based authentication を選択します。
Kameleoon が提供した AWS Access Key、AWS Secret Access Key、S3 バケット、および Parent Directory を入力します。
Test Connection をクリックしてから、Save をクリックします。
Activation Targets > New に移動します。
File Storage で、Amazon S3 を選択し、新しく作成した Kameleoon 接続を選択します。
ファイル形式として CSV を選択し、対象名を入力（例：Kameleoon audience sync）してから、Save をクリックします。

オプション B：Salesforce Data 360 用に SFTP を設定する

Salesforce Data 360 で、Data Cloud Setup に移動します。
External Integrations で、Other Connectors を選択します。
New をクリックして、Target > Secure File Transfer (SFTP) を選択します。
接続名を入力します（例：Kameleoon integration）。
Kameleoon が提供した Kameleoon SFTP ホスト、ポート、ユーザー名、および Parent Directory を入力します。
SSH 秘密鍵とオプションのパスフレーズを入力します。
Test Connection をクリックしてから、Save をクリックします。
Activation Targets > New に移動します。
File Storage で、SFTP を選択し、新しく作成した Kameleoon 接続を選択します。
ファイル形式として CSV を選択し、対象名を入力（例：Kameleoon audience sync）してから、Save をクリックします。

ステップ 4：Salesforce オーディエンスと属性を Kameleoon にアクティベートする

接続が確立されたら、Kameleoon にプッシュする特定の Salesforce Data 360 セグメントと属性を選択します。

Salesforce Data 360 で、Segments に移動します。
Kameleoon と同期するセグメントを選択します。
Activations タブで、New をクリックして、Kameleoon Audience Sync 対象を選択します。
Individual を Activation Membership オブジェクトとして選択します。
Add Attributes をクリックして、Individual エンティティを展開し、kameleoon_visitor_code を追加します。
Kameleoon でのターゲティングに使用する追加の Salesforce 属性を追加します（例：customer_tier または churn_risk）。

kameleoon_visitor_code 属性は必須です。この属性がないと、Kameleoon はデータを正しい訪問者プロファイルにマップできません。

Salesforce でアクティベーション更新タイプを設定する際は、Incremental を選択してください。この設定により、すべての実行でオーディエンス全体を転送するのではなく、変更されたレコードのみを更新して、オーディエンスメンバーシップと属性が効率的に同期されます。

ステップ 5：グローバルスクリプトで Salesforce データを取得する

同期された Salesforce データをターゲティングに利用可能にするには、Kameleoon リモートデータストアから取得し、JavaScript Activation API を使用してカスタムデータとして登録します。このコードを、訪問者コードを Salesforce に送信する同じグローバルスクリプトに追加してください。カスタムデータ独自の取得コードではなく、グローバルスクリプトに追加します。取得呼び出しは非同期で、コールバックが必要です。ここで一度呼び出すことにより、各属性とオーディエンスを 1 つのサーバーレスポンスから登録でき、各属性に対して別々のリモート検索をトリガーする必要がありません：

// 現在の訪問の最初のページビューでのみ実行することを確認
if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Data.retrieveDataFromRemoteSource(
        Kameleoon.API.Visitor.code,
        function (data) {
            // 同期された各 Salesforce オーディエンスメンバーシップを登録
            if (Array.isArray(data.salesforce_audiences)) {
                data.salesforce_audiences.forEach(function (audience) {
                    Kameleoon.API.Data.setCustomData("Salesforce Audiences", audience);
                });
            }

            // 同期された Salesforce Customer Tier 属性を登録
            if (data.customer_tier) {
                Kameleoon.API.Data.setCustomData("Salesforce Customer Tier", data.customer_tier);
            }
        }
    );
}

Activation API リファレンスで、retrieveDataFromRemoteSource() と setCustomData() の完全なドキュメントを確認してください。

Feature Experimentation 向けの Salesforce データを取得する

ウェブ実験の代わりに Kameleoon Feature Experimentation で訪問者をターゲットする場合、ブラウザではグローバルスクリプトは実行されません。代わりに Kameleoon SDK を使用してデータを取得します。getRemoteData() でペイロードを取得し、機能フラグを評価する前に addData() で各値を登録します：

import { KameleoonClient, CustomData } from '@kameleoon/javascript-sdk';

const client = new KameleoonClient({ siteCode: 'my_site_code' });

async function init() {
    await client.initialize();

    // 訪問者コードを取得
    const visitorCode = client.getVisitorCode();

    // この訪問者の同期された Salesforce ペイロードを取得
    const jsonData = await client.getRemoteData(visitorCode);
    const data = JSON.parse(jsonData);

    // 同期された Salesforce オーディエンスメンバーシップを 1 つの呼び出しで登録。
    // 同じカスタムデータ名での繰り返しの addData() 呼び出しは、追加する代わりに
    // 前の値を置き換えるため、すべてのオーディエンスを
    // 1 つの CustomData インスタンスに対する可変長引数として渡します。
    if (Array.isArray(data.salesforce_audiences) && data.salesforce_audiences.length > 0) {
        client.addData(visitorCode, new CustomData('Salesforce Audiences', ...data.salesforce_audiences));
    }

    // 同期された Salesforce Customer Tier 属性を登録
    if (data.customer_tier) {
        client.addData(visitorCode, new CustomData('Salesforce Customer Tier', data.customer_tier));
    }

    // 追加したデータを使用して機能フラグを評価
    const isActive = client.isFeatureFlagActive(visitorCode, 'my_feature_key');
}

init();

JavaScript SDK ドキュメントで、getRemoteData()、addData()、isFeatureFlagActive() の完全なドキュメントを確認してください。Feature Experimentation の完全なワークフローについては、外部データを使用してユーザーをターゲットするを参照してください。

ステップ 6：Kameleoon でカスタムデータを作成する

Kameleoon は受け取った Salesforce CSV アクティベーションファイルを自動的に処理します。このデータをターゲティングに使用するには、スクリプトが設定する値に一致する Kameleoon プラットフォームで カスタムデータ オブジェクトを作成します。 Settings > Custom data > New custom data に移動し、必要なデータ型に基づいてオブジェクトを設定します。 Kameleoon カスタムデータの詳細については、カスタムデータを作成するを参照してください。

例 1：Salesforce オーディエンスをマップする（リストデータ）

複数の Salesforce オーディエンスでの存在に基づいて訪問者をターゲットするには、以下の設定でカスタムデータを設定します：

Name: Salesforce Audiences
Retrieval method: Kameleoon Activation API
Type: List
Format: String
Scope: Visit

例 2：Salesforce プロファイル属性をマップする（文字列データ）

顧客層などの特定の単一プロファイル属性に基づいて訪問者をターゲットするには、以下の設定で別個のカスタムデータエントリを作成します：

Name: Salesforce Customer Tier
Retrieval method: Kameleoon Activation API
Type: Single
Format: String
Scope: Visitor

Kameleoon Feature Experimentation で訪問者をターゲットする場合は、Kameleoon Activation API の代わりに、両方のカスタムデータエントリに対する取得方法として Kameleoon SDK method を選択してください。

ステップ 7：Kameleoon で Salesforce オーディエンスをターゲットする

カスタムデータをマップすると、Salesforce 情報は Kameleoon セグメントビルダー内でネイティブに利用可能になります。 セグメントでデータを使用するには：

セグメントビルダー (Settings > Segments > New segment) に移動します。
新しく作成したカスタムデータ条件をセグメントルールにドラッグします。
ロジック演算子を設定します。例えば、高価値顧客をターゲットするには、以下のように設定します：
- Salesforce Audiences is among High-value customers

他の Kameleoon 基準とネイティブに組み合わせて、非常に具体的なセグメントを作成できます（例えば、Salesforce Customer Tier = Gold AND Device = Mobile）。セグメント作成の詳細については、セグメントを作成するを参照してください。

Salesforce Data 360 統合に関する考慮事項

Salesforce Data 360 と Kameleoon 間の統合を維持する際は、以下のシステム動作を考慮してください：

識別子の一貫性： Salesforce がエクスポートする kameleoon_visitor_code 文字列は、Kameleoon の訪問者のクッキー文字列と正確に一致する必要があります。識別子が Salesforce インポート処理中に変更またはハッシュされた場合、同期は失敗します。
データの鮮度： 統合は非同期ファイルドロップに依存しています。ユーザープロファイルへの変更は、Salesforce セグメントが更新され、Salesforce が CSV アクティベーションファイルを配信し、Kameleoon が結果のペイロードを取り込んだ後にのみ、Kameleoon で利用可能になります。
データプライバシー： 実験またはパーソナライズに必要な特定の属性のみをアクティベートしてください。より広い分類属性（例えば、一般的な LTV_band）で同じターゲティング目標を達成する場合は、個人識別情報（PII）のアクティベートを回避してください。

​Salesforce Data 360 の同期がどのように機能するか

​Salesforce Data 360 統合の前提条件

​ステップ 1：Kameleoon 訪問者コードを Salesforce に送信する

​ステップ 2：Salesforce Data 360 で訪問者コードを追加およびマップする

​Salesforce Data 360 でフィールドを作成する

​フィールドを Data Lake Object にマップする

​ステップ 3：Salesforce と Kameleoon の間の接続を設定する

​オプション A：Salesforce Data 360 用に Amazon S3 を設定する

​オプション B：Salesforce Data 360 用に SFTP を設定する

​ステップ 4：Salesforce オーディエンスと属性を Kameleoon にアクティベートする

​ステップ 5：グローバルスクリプトで Salesforce データを取得する

​Feature Experimentation 向けの Salesforce データを取得する

​ステップ 6：Kameleoon でカスタムデータを作成する

​例 1：Salesforce オーディエンスをマップする（リストデータ）

​例 2：Salesforce プロファイル属性をマップする（文字列データ）

​ステップ 7：Kameleoon で Salesforce オーディエンスをターゲットする

​Salesforce Data 360 統合に関する考慮事項

Salesforce Data 360 の同期がどのように機能するか

Salesforce Data 360 統合の前提条件

ステップ 1：Kameleoon 訪問者コードを Salesforce に送信する

ステップ 2：Salesforce Data 360 で訪問者コードを追加およびマップする

Salesforce Data 360 でフィールドを作成する

フィールドを Data Lake Object にマップする

ステップ 3：Salesforce と Kameleoon の間の接続を設定する

オプション A：Salesforce Data 360 用に Amazon S3 を設定する

オプション B：Salesforce Data 360 用に SFTP を設定する

ステップ 4：Salesforce オーディエンスと属性を Kameleoon にアクティベートする

ステップ 5：グローバルスクリプトで Salesforce データを取得する

Feature Experimentation 向けの Salesforce データを取得する

ステップ 6：Kameleoon でカスタムデータを作成する

例 1：Salesforce オーディエンスをマップする（リストデータ）

例 2：Salesforce プロファイル属性をマップする（文字列データ）

ステップ 7：Kameleoon で Salesforce オーディエンスをターゲットする

Salesforce Data 360 統合に関する考慮事項