Experience Platform Web SDKを統合して顧客の同意データを処理する

Adobe Experience Platform Web SDKを使用すると、Consent Management Platform （CMP）によって生成された顧客の同意シグナルを取得し、同意変更イベントが発生するたびにAdobe Experience Platformに送信できます。

SDKは、初期設定では、どの CMP ともインターフェイスを行いません。 SDKを web サイトに統合する方法を決め、CMP で同意の変更をリッスンして、適切なコマンドを呼び出すかどうかは、ユーザー次第です。 このドキュメントでは、CMP をExperience Platform web SDKと統合する方法に関する一般的なガイダンスを提供します。

前提条件 prerequisites

このチュートリアルでは、CMP 内で同意データを生成する方法を既に決定しており、Adobe標準または IAB Transparency and Consent Framework （TCF） 2.0 標準に準拠する同意フィールドを含むデータセットを作成していることを前提としています。 このデータセットをまだ作成していない場合は、このガイドに戻る前に次のチュートリアルを参照してください。

このガイドは、UI でタグ拡張機能を使用してSDKをセットアップするワークフローに従います。 拡張機能を使用せず、スタンドアロンバージョンのSDKをサイトに直接埋め込む場合は、このガイドの代わりに次のドキュメントを参照してください。

このガイドのインストール手順では、タグ拡張機能と、web アプリケーションへのインストール方法について、実際に理解しておく必要があります。 詳しくは、次のドキュメントを参照してください。

データストリームの設定

SDKがExperience Platformにデータを送信するには、まずデータストリームを設定する必要があります。 データ収集 UI またはExperience Platform UI で、左側のナビゲーションから データストリーム を選択します。

新しいデータストリームを作成するか、既存のデータストリームを選択して編集した後、Adobe Experience Platform の横にある切り替えボタンを選択します。 次に、以下に示す値を使用してフォームを完成させます。

終了したら、画面の下部にある「保存」を選択し、追加のプロンプトに従って続行して設定を完了します。

Experience Platform Web SDKのインストールと設定

前の節で説明したようにデータストリームを作成したら、最終的にサイトにデプロイするExperience Platform Web SDK拡張機能を設定する必要があります。 タグプロパティにSDK拡張機能がインストールされていない場合は、左側のナビゲーションにある 拡張機能 を選択してから、「カタログ」タブを選択します。 次に、使用可能な拡張機能のリスト内にあるExperience Platform SDK拡張機能の下の「インストール」を選択します。

SDKを設定する際、「Edge設定」で、前の手順で作成したデータストリームを選択します。

「保存」を選択して、拡張機能をインストールします。

データ要素を作成してデフォルトの同意を設定

SDK拡張機能がインストールされている状態で、デフォルトのデータ収集同意値（collect.val）を表すデータ要素を作成するオプションがあります。 これは、欧州連合（EU）ユーザーの pending や北米ユーザーの in など、ユーザーに応じて異なるデフォルト値を使用する場合に便利です。

このユースケースでは、次のコードを実装して、ユーザーの地域に基づいてデフォルトの同意を設定できます。

ユーザーの地域が CMP によって決定される場合は、代わりに次の手順を使用できます。

UI でデータ要素を作成するには、左側のナビゲーションで データ要素 を選択してから、「データ要素の追加 を選択して、データ要素作成ダイアログに移動します。

ここから、adobeDefaultConsent に基づいて JavaScript変数 ​ データ要素を作成する必要があります。 完了したら、「保存」をクリックします。

データ要素が作成されたら、Web SDK拡張機能の設定ページに戻ります。 「​ プライバシー ​」セクションで データ要素によって提供 を選択し、提供されたダイアログを使用して、前に作成したデフォルトの同意データ要素を選択します。

Web サイトへの拡張機能のデプロイ

拡張機能の設定が完了したら、web サイトに統合できます。 更新されたライブラリビルドのデプロイ方法について詳しくは、タグのドキュメントの ​ 公開ガイド ​ を参照してください。

同意変更コマンドの実行 commands

SDK拡張機能を web サイトに統合したら、Experience Platform Web SDK setConsent コマンドを使用して、同意データをExperience Platformに送信することができます。

setConsent コマンドは、次の 2 つのアクションを実行します。

setConsent を呼び出すタイミング

サイトで setConsent を呼び出す必要があるシナリオは 2 つあります。

setConsent 構文

setConsent コマンドは、単一の配列タイプのプロパティ consent を含むペイロードオブジェクトを想定しています。 consent 配列には、Adobe標準に必要な同意フィールドを提供するオブジェクトが少なくとも 1 つ含まれている必要があります。

次の呼び出しの例では、Adobe標準の必須同意フィールド setConsent 示しています。

alloy("setConsent", {
  consent: [{
    standard: "Adobe",
    version: "2.0",
    value: {
      collect: {
        val: "y"
      },
      share: {
        val: "y"
      },
      personalize: {
        content: {
          val: "y"
        }
      },
      metadata: {
        time: "YYYY-10-12T15:52:25+00:00"
      }
    }
  }]
});

次のJavaScriptは、web サイト上の同意環境設定の変更を処理する関数の例を示しています。この関数は、イベントリスナーまたは CMP フック内のコールバックとして使用できます。

var setConsent = function () {

  // Retrieve the current consent data.
  var categories = getConsentData();

  // If the script is running on a consent change, generate a new timestamp.
  // If the script is running on page load, set the timestamp to when the consent values last changed.
  var now = new Date();
  var collectedAt = consentChanged ? now.toISOString() : categories.collectedAt;

  //  Map the consent values and timestamp to XDM
  var consentXDM = {
    collect: {
      val: categories.collect !== -1 ? "y" : "n"
    },
    personalize: {
      content: {
        val: categories.personalizeContent !== -1 ? "y" : "n"
      }
    },
    share: {
      val: categories.share !== -1 ? "y" : "n"
    },
    metadata: {
      time: collectedAt
    }
  };

  // Pass the XDM object to the Experience Platform Web SDK
  alloy("setConsent", {
    consent: [{
      standard: "Adobe",
      version: "2.0",
      value: consentXDM
    }]
  });
});

SDKの応答の処理

すべての Experience Platform SDK コマンドは、呼び出しが成功したか失敗したかを示すプロミスを返します。 その後、これらの応答を使用して、顧客に確認メッセージを表示するなどの追加のロジックを実行できます。 詳細については、「​ コマンドの応答 ​」を参照してください。

SDKで setConsent 呼び出しを正常に実行したら、Experience Platform UI のプロファイルビューアを使用して、データがプロファイルストアにランディングされているかどうかを確認できます。 詳しくは、ID によるプロファイルの参照 ​ の節を参照してください。

次の手順

このガイドに従って、同意データをExperience Platformに送信するようにExperience Platform Web SDK拡張機能を設定しました。 実装のテストに関するガイダンスについては、実装している同意標準のドキュメントを参照してください。