Platform Web SDK 拡張機能を使用した同意管理プラットフォーム (CMP) への同意の実装

多くの法的プライバシー規制では、データ収集、パーソナライゼーション、その他のマーケティングの使用例に関して、アクティブで特定の同意に関する要件を導入しています。 これらの要件を満たすために、Adobe Experience Platformでは、個々の顧客プロファイルの同意情報を取り込み、それらの設定を、各顧客のデータがダウンストリームの Platform ワークフローでどのように使用されるかの決定要因として使用できます。

メモ

Adobe Experience Platform Launch は、データ収集テクノロジーのスイートとして Adobe Experience Platform に統合されています。 このコンテンツの使用中に注意が必要な、いくつかの用語の変更がインターフェイスにロールアウトされました。

  • platform launch(クライアント側)が tags になりました。
  • platform launchサーバー側が event forwarding になりました。
  • エッジ設定は datastreams になりました。

このチュートリアルでは、データ収集の Platform Web SDK 拡張機能を使用して、同意管理プラットフォーム (CMP) から取得した同意データを実装し、アクティブ化する方法について説明します。 Adobe標準と IAB TCF 2.0 同意標準の両方を使用して、OneTrust または Sourcepoint を CMP の例として使用します。

このチュートリアルでは、Platform Web SDK 拡張機能を使用して、Platform に同意データを送信します。 Web SDK の概要については、 このページ を参照してください。

前提条件

Web SDK を使用するための前提条件は、 ここ に記載されています。

このページには、「イベントデータセット」が必要で、そのように、エクスペリエンスイベントデータを保持するデータセットです。 イベントと共に同意情報を送信するには、[ プライバシーの詳細フィールドグループ ] (https://github.com/adobe/xdm/blob/master/docs/reference/field groups/experience-event/experienceevent-privacy.schema.md) をエクスペリエンスイベントスキーマに追加する必要があります。

Platform の同意標準 v2.0 の場合、Adobe Experience Profile にアクセスして、XDM の個別プロファイルスキーマとデータセットを作成する必要もあります。 スキーマの作成に関するチュートリアルについては、 スキーマエディター を使用したスキーマの作成を参照し、必要な環境設定の詳細プロファイルフィールドグループについては、XDM ドキュメント を参照してください。

このチュートリアルは、データ収集にアクセスできるユーザーが、Web SDK 拡張機能がインストールされ、開発用に作成および構築された作業用ライブラリを使用して、クライアント側のタグプロパティを作成していることを前提としています。 これらのトピックの詳細と実証は、次のドキュメントで行います。

また、Platform Debugger Chrome 拡張機能を使用して、実装を調べ、検証します。

独自のサイトに CMP を使用して IAB TCF の例を実装するには、OneTrust や Sourcepoint などの CMP にアクセスして提供するデータを生成する必要があります。または、ここで簡単に実行し、以下の結果を確認できます。

Web SDK とAdobe同意標準(v1.0 または v2.0)の使用

メモ

1.0 標準は廃止され、v2.0 に置き換えられています。2.0 標準を使用すると、同意設定を手動で実施するために使用できる同意データを追加できます。 Platform Web SDK 拡張機能の以下のスクリーンショットは、AdobeConsent Standard の v1.0 または v2.0 と互換性のある拡張機能のバージョン 2.4.0 のものです。

これらの標準の詳細については、 顧客の同意に関する設定 のサポートを参照してください。

手順 1:Web SDK 拡張機能での同意の設定

タグプロパティに Platform Web SDK 拡張機能をインストールしたら、拡張機能の設定画面で同意データに対処するためのオプションを設定できます。

ユーザーが事前に同意設定を指定していない場合、「プライバシー」セクションで SDK の同意レベルを設定します。 これにより、SDK での同意とイベントデータ収集のデフォルトの状態が設定されます。 選択した設定は、「ユーザーが明示的な同意設定をまだ提供していない場合、SDK はどうすればよいですか?」という質問に答えます。

  • :ユーザーが同意設定を提供する前に発生したイベントを収集します。
  • 出力 — ユーザーが同意設定を提供する前に発生したイベントを削除します。
  • 保留中 — ユーザーが同意設定を提供する前に発生したイベントをキューに入れます。
  • データ要素で指定

デフォルトの同意設定が「イン」の場合、明示的な同意を待つ必要はなく、ユーザーが同意設定を提供する前に発生したイベントを収集する必要があると SDK に伝えます。 これらの環境設定は通常、CMP で処理および保存されます。

デフォルトの同意設定が「Out」の場合、ユーザーのオプトイン設定が設定される前に発生したイベントを収集しないよう SDK に指示します。 同意設定の前に発生した訪問者のアクティビティは、同意の設定後に SDK から送信されるデータには含まれません。 例えば、同意バナーを選択する前に Web ページをスクロールして表示し、この「Out」設定を使用した場合、ユーザーが後でデータ収集に対して明示的な同意を提供した場合は、そのスクロール操作と表示時間は送信されません。

デフォルトの同意設定が「保留」の場合、SDK はユーザーが同意設定を指定する前に発生したイベントをキューに入れるので、同意設定の設定後、訪問中に SDK が最初に設定された後にイベントを送信できます。

この「保留」設定では、ユーザーのオプトイン設定を必要とするコマンド(イベントコマンドなど)を実行しようとすると、そのコマンドは SDK 内のキューに追加されます。 これらのコマンドは、ユーザーのオプトイン設定を SDK に伝えるまで処理されません。

CMP がユーザーの環境設定を収集したら、それらの設定を SDK に伝えることができます。 後の節では、そのオプトインデータを取得し、Web SDK 拡張機能と共に使用する方法を説明します。

「データ要素によって提供」を使用すると、サイト上のカスタムコードや CMP、またはデータレイヤーでキャプチャされた同意設定データを含むデータ要素にアクセスできます。 この目的で使用されるデータ要素は、「in」、「out」、「pending」に解決される必要があります。

注意:この SDK の設定は、ユーザーのプロファイルには保持されません。訪問者が明示的な同意設定をおこなう前に SDK の動作を設定することに特有です。

Web SDK 拡張機能の設定について詳しくは、「Platform Web SDK 拡張機能の概要 」および「 顧客の同意に関する設定 のサポート」を参照してください。

この例では、「Pending」のオプションを選択し、「Save」を選択して設定を保存します。

手順 2:同意設定の通信

SDK のデフォルトの動作が設定されたので、タグを使用して、訪問者の明示的な同意設定を Platform に送信できます。 Adobe1.0 または 2.0 標準を使用した同意データの送信は、タグルールで Web SDK の setConsent アクションを使用して簡単に実装できます。

ルールを作成して、これを示します。 Platform タグプロパティで、「ルール」を選択し、青い「ルールを追加」ボタンを選択します。 ルールに「setAdobeConsent」という名前を付け、イベントを追加する場合に選択します。 「イベントタイプ」で、「Window Loaded」を選択します。このルールは、ページが Web サイトに読み込まれるたびにトリガーされます。 次に、「アクション」で「追加」を選択して、アクション設定画面を開きます。 ここで同意データを設定します。 「拡張機能」ドロップダウンを選択し、「Platform Web SDK」を選択し、「アクションタイプ」を選択して、「同意を設定」を選択します。

「同意情報」で、「フォームに入力」を選択します。 このルールアクションでは、Web SDK を使用し、表示されるフォームに入力して、Adobe1.0 の同意標準に対する同意を設定します。

この同意設定アクションで、「In」、「Out」または「Provided by data element」を渡すことを選択できます。 ここのデータ要素は、「in」または「out」に解決される必要があります。

この例では、「受信」を選択して、Web SDK による Platform へのデータ送信を許可することに訪問者が同意したことを示します。 青い「変更を保持」ボタンを選択してこのアクションを保存し、「保存」を選択してこのルールを保存します。

注意: Web サイトの訪問者がオプトアウトすると、SDK ではに対するユーザーの同意を設定できなくなります。

タグルールは、様々な組み込みイベントまたはカスタム イベント によってトリガーできます。このイベントを使用して、訪問者セッション中に適切なタイミングでこの同意データを渡すことができます。 上記の例では、 window loaded イベントを使用してルールをトリガーしています。 後の節では、CMP の同意設定イベントを使用して、「Set Consent」アクションをトリガーにします。 オプトインの環境設定を示す任意のイベントでトリガーされるルールで、「同意を設定」アクションを使用できます。

Platform 同意標準のバージョン 2.0 は、XDM データで機能します。 また、「プライバシーの詳細」フィールドグループを Platform のプロファイルスキーマに追加する必要があります。 Adobe標準バージョン 2.0 とこのフィールドグループについて詳しくは、Platform での同意処理 を参照してください。

カスタムコードデータ要素を作成し、以下のスキーマに示す同意オブジェクトの collect プロパティと metadata プロパティにデータを渡します。

この「環境設定の詳細」フィールドグループには、ルールアクションで Platform Web SDK 拡張機能を使用して Platform に送信する同意設定データを含む、 同意と環境設定 XDM データ型 のフィールドが含まれています。 現在、Platform Consent Standard 2.0 を実装するために必要なプロパティは、収集値 (val) とメタデータ時間の値のみで、上の図で赤でハイライトされています。

このデータのデータ要素を作成します。 データ要素を選択し、青い「データ要素を追加」ボタンを選択します。 この名前を「xdm-consent 2.0」にし、Core 拡張機能を使用して、カスタムコードタイプを選択します。 次のデータを入力またはコピーして、カスタムコードエディターウィンドウに貼り付けることができます。

var dateString = new Date().toISOString();

return {
  collect: {
    val: "y"
  },
  metadata: {
    time: dateString
  }
}

時間フィールドには、ユーザーが同意設定を最後に更新した日時を指定する必要があります。 JavaScript の日付オブジェクトの標準的なメソッドを使用した例として、ここでタイムスタンプを作成します。 「保存」を選択してカスタムコードを保存し、もう一度「保存」を選択してデータ要素を保存します。

次に、「ルール」を選択し、青い「ルールを追加」ボタンを選択して、「setConsent onLoad - Consent 2.0」という名前を入力します。 「Window Loaded」イベントをルールイベントとして選択し、「トリガー」の下の「追加」を選択します。 「 Platform Web SDK Extension 」を選択し、「アクションタイプ」で「同意を設定」を選択します。 「標準」は「Adobe」、「バージョン」は「2.0」にする必要があります。「値」では、作成したデータ要素を使用し、Platform に送信する必要がある収集および時間の値を格納します。

この例のアクションを確認するには、Platform Web SDK 拡張機能から Set Consent を呼び出し、フォームから Standard と Version を渡し、先ほど作成したデータ要素から collect と time の値を渡します。

青い「保存」ボタンを選択し、ルールを保存します。

これで、プラットフォームの同意に関する標準ごとに 1 つずつ、2 つのルールが用意されました。 実際には、サイト全体で 1 つの標準を選択する場合が多くなります。 次に、IAB TCF 2.0 同意標準を使用した例を作成します。

IAB Transparency and Consent Framework のバージョン 2.0 について詳しくは、IAB Europe の Web サイト を参照してください。

この標準を使用して同意設定データを設定するには、「プライバシーの詳細」フィールドグループを Platform のエクスペリエンスイベントスキーマに追加する必要があります。

このフィールドグループには、IAB TCF 2.0 標準で必要な同意設定フィールドが含まれています。 スキーマとフィールドグループについて詳しくは、「XDM システムの概要 」を参照してください。

手順 1:同意データ要素の作成

IAB TCF 2.0 の同意標準を使用してタグから同意イベントデータを送信するには、最初に必要な同意フィールドを含む xdm データ要素を設定します。

クライアント側のタグのプロパティで、「データ要素」を選択し、青い「データ要素を追加」ボタンを選択します。 この例では、このデータ要素に「xdm-consentStrings」という名前を付けます。 これらの xdm フィールドには、IAB TCF 2.0 標準に必要なユーザー同意データが含まれます。

「拡張機能」ドロップダウンメニューで「Platform Web SDK」を選択し、「データ要素のタイプ」で「XDM オブジェクト」を選択します。 xdm マッパーが表示され、上のスクリーンショットに示したように「consentStrings」項目を選択して展開できます。

各 consentStrings を次のように設定します。

  • consentStandard: IAB TCF
  • consentStandardVersion: 2.0
  • consentStringValue: %IAB TCF Consent String%
  • containsPersonalData: False (「値を選択」ボタンから選択)
  • gdprApplies: %IAB TCF Consent GDPR%

consentStandard と consentStandardVersion は、どちらも、使用している標準(IAB TCF バージョン 2.0)のテキスト文字列に過ぎません。consentStringValue は、「IAB TCF Consent String」という名前のデータ要素を参照します。 テキストを囲むパーセント記号はデータ要素の名前を示します。後でそれを見てみます。 containsPersonalData プロパティは、IAB TCF 2.0 のコンセントストリングに、「True」または「False」のいずれかの個人データが含まれているかどうかを示します。 gdprApplies フィールドは、GDPR が適用される場合は「true」、GDPR が適用されない場合は「false」、GDPR が適用される場合は「未定義」を示します。 現在、Web SDK は「未定義」を「true」として扱うので、「gdprApplies」と共に送信される同意データは次のようになります。「未定義」は、GDPR が適用される領域に訪問者がいる場合と同じように扱われます。

これらのプロパティとタグの IAB TCF 2.0 について詳しくは、 同意に関するドキュメント を参照してください。

手順 2:IAB TCF 2.0 標準に対する同意を設定するルールの作成

次に、Web サイトの訪問者がこの標準の同意データを設定または変更した場合に、Web SDK との同意を設定するルールを作成します。 このルールでは、OneTrustSourcepoint などの CMP から、これらの同意の変更シグナルを取り込む方法も確認します。

ルールイベントの追加

Platform タグプロパティの「ルール」セクションを選択し、青い「ルールを追加」ボタンを選択します。 ルールに setConsent - IAB という名前を付け、「イベント」の下の「追加」を選択します。 このイベントに tcfapi addEventListener という名前を付け、「エディタを開く」を選択してカスタムコードエディタを開きます。

次のコードをコピーして、エディターウィンドウに貼り付けます。

// Wait for window.__tcfapi to be defined, then trigger when the customer has completed their consent and preferences.
function addEventListener() {
  if (window.__tcfapi) {
    window.__tcfapi("addEventListener", 2, function (tcData, success) {
      if (success && (tcData.eventStatus === "useractioncomplete" || tcData.eventStatus === "tcloaded")) {
        // save the tcData.tcString properties in data elements
        _satellite.setVar("IAB TCF Consent String", tcData.tcString);
        _satellite.setVar("IAB TCF Consent GDPR", tcData.gdprApplies);
        trigger();
      }
    });
  } else {
    // window.__tcfapi wasn't defined. Check again in 100 milliseconds
    setTimeout(addEventListener, 100);
  }
}
addEventListener();

このコードは、addEventListener という関数を作成して実行するだけです。 この関数は、ウィンドウが表示されているかどうかを確認します。__tcfapi オブジェクトが存在し、存在する場合は、API の仕様に従ってイベントリスナーを追加します。 これらの仕様について詳しくは、GitHub の IAB repo を参照してください。 このイベントリスナーが正常に追加され、Web サイトの訪問者が同意と環境設定の選択を完了した場合、コードは tcData tcString のカスタム変数にタグを設定し、GDPR 地域のインジケーターを設定します。 IAB TCF の詳細については、IAB Web サイト および GitHub リポジトリ を参照してください。 これらの値を設定した後、コードは、このルールを実行するトリガー関数をトリガーにします。

窓の場合。__tcfapi オブジェクトは、この関数を初めて実行したときに存在しなかったので、100 ミリ秒ごとに再度チェックされるので、イベントリスナーを追加できます。 コードの最後の行では、その上のコード行で定義された addEventListener 関数を実行します。

要約すると、Web サイトの訪問者が CMP(またはカスタム)同意バナーを使用して設定した同意のステータスを確認する関数を作成しました。 同意設定が設定されると、このコードは、ルールアクションで使用できる 2 つのカスタム変数(カスタムコードデータ要素)を作成します。 上記のコードをイベントのカスタムコードエディターウィンドウに貼り付けた後、青い「保存」ボタンを選択してルールイベントを保存します。

次に、これらの値を使用して Platform に送信する同意ルールを設定します。

ルールアクションの追加

「アクション」セクションの「追加」を選択します。 「拡張機能」の下で、ドロップダウンから「 Platform Web SDK 」を選択します。 「アクションタイプ」で、「同意を設定」を選択します。 このアクションに setConsent という名前を付けます。

「同意情報」の下のアクションの設定で、「フォームに入力」を選択します。 Standard の場合は、IAB TCF を選択し、バージョンには 2.0 を入力します。値には、イベントのカスタム変数を使用し、上記のルールイベントカスタム関数で取得した tcData から取得した%IAB TCF Consent String%を入力します。

「GDPR 適用」では、イベントの他のカスタム変数を使用し、上記のルールイベントカスタム関数で取得した tcData からもたらされる%IAB TCF Consent GDPR%と入力します。 この Web サイトの訪問者に対して GDPR が確実に適用されるか適用されないかを把握している場合は、カスタム変数(データ要素)の選択を使用する代わりに、該当する場合は「はい」または「いいえ」を選択できます。 また、データ要素で条件ロジックを使用して、GDPR が適用され、適切な値が返されるかどうかを確認することもできます。

「GDPR の個人データを含む」で、このユーザーのデータが個人データを含むかどうかを示すオプションを選択します。 ここで指定するデータ要素は、true または false に解決される必要があります。

青い「保存」ボタンを選択してアクションを保存し、青い「保存」(または「ライブラリに保存」)ボタンを選択してルールを保存します。 この時点で、IAB TCF 2.0 の同意標準に準拠した Web SDK 拡張機能を使用して同意を設定するためのデータ要素とルールをタグに実装できました。

手順 3:ライブラリに保存してビルド

作業用ライブラリ の前提条件を使用している場合は、これらの変更を既に保存し、開発用ライブラリを構築済みです。

手順 4:Inspectとデータ収集の検証

サイトで、ページを更新し、Debugger🔗 Chrome 拡張機能の「タグ」メニューセクションで、ライブラリのビルドを確認します。

また、Adobe1.0 または 2.0 標準に対する setConsent 呼び出しをデバッガーの Web SDK セクションで調べるには、{"consent":[{"value":{"general":"in"},"version… と表示されるネットワークリクエストのPOST本文行でを選択します。

IAB TCF 2.0 標準に対する setConsent 呼び出しとルールを検証するには、テストサイトの OneTrust 同意バナーを使用して同意設定を設定し、前述の tcData を作成します。

「I Accept」を選択した後、{"consent":[{"value":"someAlphaNumericCharacters… と表示されるネットワークリクエストのPOST本文行を選択することで、デバッガーの Web SDK の節で、IAB TCF 2.0 標準の setConsent 呼び出しを調べることができます。

ここでは、データ要素とタグルールで前に設定したデータを示します。 value プロパティには、先ほど確認したエンコード済みの tcString データが含まれます。

IAB TCF 2.0 標準を実装する OneTrust、Sourcepoint、その他の CMP は、すべてページで同様のデータを生成します。 このデータをキャプチャし、上で作成したルールのカスタムコードイベントを使用して、Web SDK 拡張機能でタグ内で使用できます。 IAB TCF 2.0 データの生成に使用する CMP に関係なく、カスタムコードは同じです。 カスタムコードは、プラットフォームの同意に関する標準(1.0 または 2.0)と組み合わせて使用することもできます。

エクスペリエンスイベントを使用した同意データの送信

どちらのルールでも、データ要素フィールドで先ほど作成した「xdm-consentStrings」データ要素が参照されていないことに気が付いたかもしれません。 このデータ要素は、エクスペリエンスイベントで同意データを送信する必要がある場合に使用します。

このデータ要素には IAB TCF 2.0 標準に必要なすべてのフィールドが含まれているので、エクスペリエンスイベントでこの xdm データを送信する際に、データ要素を参照するだけで済みます。

まとめ

データを調べて検証したので、Platform 用 Platform Web SDK 拡張機能を使用して、CMP から取得した同意データを実装し、アクティブ化する方法を確認する必要があります。

このページ