Platform Web SDK 拡張機能を使用して、同意管理プラットフォーム（CMP）との同意を実装

手順 2：同意環境設定の伝達

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

Platform 同意標準 1.0 での同意の設定

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

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

この同意の設定アクションで、「受信」、「送信」、または「データ要素によって提供」を渡すことを選択できます。 この場合、データ要素は「in」または「out」に解決される必要があります。

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

メモ：Web サイトの訪問者がオプトアウトすると、SDK では、ユーザーの同意を設定できません。

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

Platform Consent Standard 2.0 での同意の設定

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

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

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

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

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

次に、ルールを選択し、青い「ルールを追加」ボタンを選択して、「setConsent onLoad - Consent 2.0」という名前を入力します。 ルールトリガーとして「ウィンドウの読み込み」イベントを選択し、「アクション」で「追加」を選択します。 Platform Web SDK 拡張機能を選択し、「アクションタイプ」で「同意を設定」を選択します。 標準はAdobe、バージョンは 2.0 にしてください。値には、Platform に送信する必要がある収集と時間の値を含んだ、作成したばかりのデータ要素を使用します。

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

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

これで、Platform 同意標準ごとに 1 つ、2 つのルールが作成されました。 実際には、サイト全体で 1 つの標準を選択する可能性が高いでしょう。 次に、IAB TCF 2.0 同意標準を使用した例を作成します。

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

次に、この標準の同意データが web サイトの訪問者によって設定または変更された場合に、Web SDK で同意を設定するルールを作成します。 このルールでは、OneTrust や Sourcepoint などの CMP からの同意変更シグナルをキャプチャする方法も説明します。

ルールイベントの追加

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

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

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

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

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

次に、これらの値を使用して Platform に送信するように、同意ルールを設定アクションを設定します。