setConsent

Adobe 2.0標準consent物件

如果您將資料傳送至Adobe Experience Platform，您會在設定檔結構描述中包含隱私權結構描述欄位群組。 如需Adobe Experience Platform 2.0標準的詳細資訊，請參閱Adobe中的治理、隱私權和安全性。 您可以在對應於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結構描述。 請參閱資料集準備指南中有關更新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標幟。 如果您有客戶的自訂身分，請務必填寫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"
    }
  }]
});