将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
对象已就绪。要将包含标记的IAB TCF 2.0和Adobe Experience Platform Web SDK扩展结合使用,您需要具有可用的XDM架构。 如果尚未设置这两个中的任何一个选项,请先查看此页面,然后再继续。
此外,本指南要求您实际了解Adobe Experience Platform Web SDK。 如想快速了解最新信息,请阅读 Adobe Experience Platform Web SDK概述 和 常见问题解答 文档。
启用默认同意
如果要对所有未知用户一视同仁,可以设置 defaultConsent
到 pending
或 out
. 在收到同意首选项之前,这将排队或丢弃体验事件。
设置默认同意依据 gdprApplies
某些CMP提供了确定《通用数据保护条例》(GDPR)是否适用于客户的能力。 如果您希望客户同意GDPR不适用的情况,则可以使用 gdprApplies
TCF API调用中的标记。
以下示例显示了执行此操作的一种方法:
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架构中,您可以存储来自体验事件的同意偏好设置信息。 可通过两种方式将此信息添加到每个事件。
首先,您可以在每 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架构的同意信息。
向每个请求添加同意信息的另一种方法是 onBeforeEventSend
回调。
后续步骤
现在,您已了解如何将IAB TCF 2.0与Platform Web SDK扩展结合使用,您还可以选择与其他Adobe解决方案(如Adobe Analytics或Adobe Real-time Customer Data Platform)集成。 请参阅 IAB透明度和同意框架2.0概述 以了解更多信息。