setConsent

Adobe 2.0 標準 consent オブジェクト

Adobe Experience Platformにデータを送信する場合、プロファイルスキーマにプライバシースキーマフィールドグループを含める必要があります。 Adobe 2.0 標準について詳しくは、Adobe Experience Platformにおけるガバナンス、プライバシー、セキュリティ ​ を参照してください。 consents プロファイルフィールドグループの Consents and Preferences フィールドのスキーマに対応する、以下の値オブジェクト内にデータを追加できます。

• standard：選択する同意標準。 このプロパティをAdobe 2.0 標準の "Adobe" に設定します。

• version：同意標準のバージョンを表す文字列。 このプロパティをAdobe 2.0 標準の "2.0" に設定します。

• value：同意値を含むオブジェクト。

  • value.collect.val：同意値。 これを「ユーザーがオプトインする際に "y"」および「ユーザーがオプトアウトする際に "n"」に設定します。
  • value.metadata.time：ユーザーが同意設定を最後に更新した際のタイムスタンプ。

// Set consent using the Adobe 2.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "2.0",
    "value": {
      "collect": {
        "val": "y"
      },
      "metadata": {
        "time": "YYYY-03-17T15:48:42-07:00"
      }
    }
  }]
});

IAB TCF 2.0 標準 consent オブジェクト

Interactive Advertising Bureau Europe （IAB）の Transparency and Consent Framework （TCF）標準で提供されるユーザー同意環境設定を記録するには、以下に示すように同意文字列を設定します。

この方法で同意が設定されると、リアルタイム顧客プロファイルが同意情報で更新されます。 これを機能させるには、プロファイル XDM スキーマに ​ プロファイルプライバシースキーマフィールドグループ ​ を含める必要があります。 イベントを送信する場合、IAB 同意情報をイベント XDM オブジェクトに手動で追加する必要があります。 Web SDKは、イベントに同意情報を自動的に含めません。

イベントで同意情報を送信するには、Profile 対応の XDM ExperienceEvent スキーマに Experience Event Privacy フィールドグループを追加する必要があります。 これを設定する手順については、データセット準備ガイドの ExperienceEvent スキーマの更新 ​ に関する節を参照してください。

• standard：選択する同意標準。 IAB TCF 2.0 標準の場合、このプロパティを "IAB TCF" に設定します。
• version：同意標準のバージョンを表す文字列。 IAB TCF 2.0 標準の場合、このプロパティを "2.0" に設定します。
• value：同意値を含む文字列。
• gdprApplies：この同意値に GDPR が適用されるかどうかを決定するブール値。 デフォルト値は true です。
• gdprContainsPersonalData：このユーザーに関連付けられたイベントデータに個人データが含まれているかどうかを判断するブール値。 デフォルト値は false です。

// Set consent using the IAB TCF 2.0 standard
alloy("setConsent", {
  consent: [{
    "standard": "IAB TCF",
    "version": "2.0",
    "value": "CO052l-O052l-DGAMBFRACBgAIBAAAAABIYgEawAQEagAAAA",
    "gdprApplies": true,
    "gdprContainsPersonalData": true
  }]
});

IAB TCF 2.0 API は、顧客が同意を更新した場合にのイベントを提供します。 この問題は、顧客が最初に環境設定を行い、顧客が環境設定を更新した場合に発生します。 イベントリスナーを追加して、setConsent のコマンドを実行できます。

const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

上記のコードブロックは useractioncomplete イベントをリッスンして同意を設定し、同意文字列と gdprApplies フラグを渡します。 顧客のカスタム ID がある場合は、必ず identityMap 変数に入力します。

Adobe 1.0 標準 consent オブジェクト

• standard：選択する同意標準。 Adobe 1.0 標準の場合、このプロパティを "Adobe" に設定します。
• version：同意標準のバージョンを表す文字列。 Adobe 1.0 標準の場合、このプロパティを "1.0" に設定します。
• value.general：同意値。 これを「ユーザーがオプトインする際に "in"」および「ユーザーがオプトアウトする際に "out"」に設定します。

// Set consent using the Adobe 1.0 standard
alloy("setConsent", {
  "consent": [{
    "standard": "Adobe",
    "version": "1.0",
    "value": {
      "general": "in"
    }
  }]
});