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"
    }
  }]
});