將IAB TCF 2.0支援與Platform Web SDK整合

本指南說明如何不使用標籤，將互動式廣告局透明與同意架構2.0版(IAB TCF 2.0)與Adobe Experience Platform Web SDK整合。 如需與IAB TCF 2.0整合的概觀，請參閱 概述. 如需如何與標籤整合的指南，請參閱 標籤適用的IAB TCF 2.0指南.

快速入門

本指南使用 __tcfapi 存取同意資訊的介面。 直接與雲端管理提供者(CMP)整合可能會更輕鬆。 不過，本指南中的資訊可能仍很實用，因為CMP通常提供與TCF API類似的功能。

注意

這些範例假設在執行程式碼時， window.__tcfapi 在頁面上定義。 CMP可提供連結，讓您在 __tcfapi 物件已就緒。

若要搭配標籤和Adobe Experience Platform Web SDK擴充功能使用IAB TCF 2.0，您必須有可用的XDM結構。 如果您尚未設定其中一個，請先檢視此頁面，再繼續操作。

此外，本指南也要求您妥善了解Adobe Experience Platform Web SDK。 如需快速複習，請閱讀 Adobe Experience Platform Web SDK概述 和 常見問題 檔案。

啟用預設同意

如果您想要對所有未知使用者一視同仁，您可以將預設同意設為 pending 或 out. 在收到同意偏好設定之前，此會讓系統排入佇列或捨棄體驗事件。

如需預設同意的詳細資訊，請參閱 預設同意區段 在Platform Web SDK設定檔案中。

根據設定預設同意 gdprApplies

有些CMP能判斷一般資料保護規範(GDPR)是否適用於客戶。 若您想對未套用GDPR的客戶採取同意，可使用 gdprApplies 標幟。

下列範例說明執行此作業的方法：

var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
    window.alloy("configure", alloyConfiguration);
  }
});

在此範例中， configure 命令會在 tcData 從TCF API取得。 若 gdprApplies 為true，則預設同意設為 pending. 若 gdprApplies 為false，則預設同意設為 in. 請務必填入 alloyConfiguration 變數。

注意

當預設同意設為 in, setConsent 命令仍可用來記錄客戶同意偏好設定。

使用setConsent事件

IAB TCF 2.0 API提供客戶更新同意時的事件。 這發生在客戶最初設定其偏好設定和客戶更新其偏好設定時。

下列範例說明執行此作業的方法：

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 變數。 請參閱 支援同意 有關呼叫的詳細資訊 setConsent.

在sendEvent中包含同意資訊

在XDM結構中，您可以儲存Experience Events的同意偏好設定資訊。 有兩種方式可將此資訊新增至每個事件。

首先，您可以在每個 sendEvent 呼叫。 下列範例說明執行此作業的方法：

var sendEventOptions = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    sendEventOptions.xdm.consentStrings = [{
      consentStandard: "IAB TCF"
      consentStandardVersion: "2.0"
      consentStringValue: tcData.tcString,
      gdprApplies: tcData.gdprApplies
    }];
    window.alloy("sendEvent", sendEventOptions);
  }
});

此範例會取得TCF API的同意資訊，然後傳送包含已新增至XDM結構之同意資訊的事件。 請參閱 追蹤事件 了解應包含在 sendEvent 命令。

將同意資訊新增至每個請求的另一種方式是使用 onBeforeEventSend 回呼。 閱讀 全局修改事件 ，以取得如何執行此動作的詳細資訊。

後續步驟

現在您已了解如何搭配Platform Web SDK擴充功能使用IAB TCF 2.0，您也可以選擇與Adobe Analytics或Adobe Real-time Customer Data Platform等其他Adobe解決方案整合。 請參閱 IAB透明與同意架構2.0概觀 以取得更多資訊。

本頁內容