本指南說明如何不使用標籤,將互動式廣告局透明與同意架構2.0版(IAB TCF 2.0)與Adobe Experience Platform Web SDK整合。 如需與IAB TCF 2.0整合的概觀,請參閱overview。 如需如何與標籤整合的指南,請參閱IAB TCF 2.0指南中的標籤。
本指南使用__tcfapi
介面來存取同意資訊。 直接與雲端管理提供者(CMP)整合可能會更輕鬆。 不過,本指南中的資訊可能仍很實用,因為CMP通常提供與TCF API類似的功能。
這些範例假設,在執行程式碼時,已在頁面上定義window.__tcfapi
。 __tcfapi
物件準備就緒時,CMP可提供一個掛接,讓您在其中執行這些函式。
若要搭配標籤和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的客戶採取同意,可在TCF API呼叫中使用gdprApplies
標幟。
下列範例說明執行此作業的方法:
var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
if (success) {
alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
window.alloy("configure", alloyConfiguration);
}
});
在此範例中,從TCF API取得tcData
後,會呼叫configure
命令。 如果gdprApplies
為true,則預設同意設為pending
。 如果gdprApplies
為false,則預設同意設為in
。 請務必使用您的設定填入alloyConfiguration
變數。
當預設同意設為in
時,仍可使用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
的詳細資訊,請參閱支援同意的指南。
在XDM結構中,您可以儲存Experience Events的同意偏好設定資訊。 有兩種方式可將此資訊新增至每個事件。
首先,您可以在每次sendEvent
呼叫時提供相關的XDM架構。 下列範例說明執行此作業的方法:
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解決方案整合,例如Adobe Analytics或即時客戶資料平台。 如需詳細資訊,請參閱IAB透明與同意架構2.0概觀 。