为了使Adobe Experience Platform按照IAB Transparency & Consent Framework (TCF)2.0处理客户同意数据,必须将这些数据发送到模式包含TCF 2.0同意字段的数据集。
具体而言,捕获TCF 2.0同意数据需要两个数据集:
此文档提供了设置这两个数据集以收集IAB TCF 2.0同意数据的步骤。 有关为TCF 2.0配置平台数据操作的完整工作流程的概述,请参阅IAB TCF 2.0规范概述。
本教程需要对Adobe Experience Platform的以下组件进行有效的理解:
隐私详细信息混音提供TCF 2.0支持所需的客户同意字段。 此混音有两种版本:一个与XDM Individual Profile类兼容,另一个与XDM ExperienceEvent类兼容。
以下各节介绍了每个混合的结构,包括在摄取过程中预期的数据。
对于基于XDM Individual Profile的模式,隐私详细信息混音提供单个映射类型字段xdm:identityPrivacyInfo
,该字段将客户身份映射到其TCF同意偏好。 以下JSON是xdm:identityPrivacyInfo
在数据获取时所需数据类型的示例:
{
"xdm:identityPrivacyInfo": {
"ECID": {
"13782522493631189": {
"xdm:identityIABConsent": {
"xdm:consentTimestamp": "2020-04-11T05:05:05Z",
"xdm:consentString": {
"xdm:consentStandard": "IAB TCF",
"xdm:consentStandardVersion": "2.0",
"xdm:consentStringValue": "BObdrPUOevsguAfDqFENCNAAAAAmeAAA.PVAfDObdrA.DqFENCAmeAENCDA",
"xdm:gdprApplies": true,
"xdm:containsPersonalData": false
}
}
}
}
}
}
如示例所示,xdm:identityPrivacyInfo
的每个根级别键都与由Identity Service识别的标识命名空间相对应。 反过来,每个命名空间属性必须至少具有一个子属性,其密钥与该命名空间的相应标识值相匹配。 在本示例中,客户的Experience CloudID(ECID
)值为13782522493631189
。
上例使用单个命名空间/值对来表示客户的身份,您可以为其他命名空间添加附加密钥,并且每个命名空间可以具有多个身份值,每个身份值都具有自己的TCF同意偏好集。
标识值对象中是单个字段,xdm:identityIABConsent
。 此对象捕获指定身份命名空间和值的客户的TCF同意值。 此字段中包含的子属性如下所示:
属性 | 描述 |
---|---|
xdm:consentTimestamp |
TCF同意值更改时的ISO 8601时间戳。 |
xdm:consentString |
包含客户更新的同意数据和其他上下文信息的对象。 请参见同意字符串属性中的部分,了解此对象的必需子属性。 |
对于基于XDM ExperienceEvent的模式,隐私详细信息混音提供单个阵列类型字段:xdm:consentStrings
。 此数组中的每个项都必须是包含TCF同意字符串必需属性的对象,与用户档案混音中的xdm:consentString
字段类似。 有关这些子属性的详细信息,请参见下一节。
{
"xdm:consentStrings": [
{
"xdm:consentStandard": "IAB TCF",
"xdm:consentStandardVersion": "2.0",
"xdm:consentStringValue": "BObdrPUOevsguAfDqFENCNAAAAAmeAAA.PVAfDObdrA.DqFENCAmeAENCDA",
"xdm:gdprApplies": true,
"xdm:containsPersonalData": false
}
]
}
隐私详细信息混音的两个版本都至少需要一个对象,该对象捕获描述客户的TCF同意字符串的必要字段。 这些属性说明如下:
属性 | 描述 |
---|---|
xdm:consentStandard |
数据适用的同意框架。 对于TCF规范,值必须为IAB TCF 。 |
xdm:consentStandardVersion |
由xdm:consentStandard 指示的同意框架的版本号。 对于TCF 2.0规范,值必须为2.0 。 |
xdm:consentStringValue |
由同意管理平台(CMP)根据客户的选定设置生成的同意字符串。 |
xdm:gdprApplies |
一个布尔值,用于指示GDPR是否适用于此客户。 必须将值设置为true ,才能执行TCF 2.0。 如果不包括,则默认为false 。 |
xdm:containsPersonalData |
指示同意更新是否包含个人数据的布尔值。 如果不包括,则默认为false 。 |
要创建捕获同意数据的数据集,您必须首先创建XDM模式,以基于这些数据集。
在平台UI中,在左侧导航中选择模式以打开模式工作区。 从此处,请按照以下各节中的步骤创建每个必需的模式。
如果您现有的XDM模式要用来捕获同意数据,则可以编辑这些模式,而不是创建新数据。 但是,如果现有模式已启用在实时客户用户档案中,则其主要标识不能是基于兴趣的广告中禁止使用的直接可识别字段,如电子邮件地址。 如果您不确定哪些字段受限,请咨询您的法律顾问。
此外,编辑现有模式时,只能进行附加(不中断)更改。 有关详细信息,请参见模式演化原则一节。
在模式工作区中,选择创建模式,然后从下拉菜单中选择XDM单个用户档案。
出现Schema Editor,显示画布中模式的结构。 使用右边栏为模式提供名称和说明,然后在画布左侧的Mixins部分下选择添加。
出现添加mixin对话框。 从此处,从列表中选择隐私详细信息。 您可以选择使用搜索栏缩小结果范围,以便更轻松地定位混音。 选择混音后,选择添加混音。
画布将重新出现,显示identityPrivacyInfo
字段已添加到模式结构。
从此处,重复上述步骤,向模式添加以下附加混音:
如果编辑的现有模式已启用在Real-time Customer Profile中使用,请选择保存以确认更改,然后跳到中根据您的同意模式创建数据集的部分。 如果要创建新模式,请继续执行下面子节中概述的步骤。
为了使平台将其收到的同意数据与特定客户用户档案关联,必须启用同意模式以在Real-time Customer Profile中使用。
本节中显示的示例模式使用其identityMap
字段作为主标识。 如果您希望将另一个字段设置为主要标识,请确保您使用的是Cookie ID等间接标识符,而不是基于兴趣的广告中禁止使用的直接可识别字段,如电子邮件地址。 如果您不确定哪些字段受限,请咨询您的法律顾问。
有关如何为模式设置主标识字段的步骤,请参阅模式创建教程。
要启用Profile的模式,请在左边栏中选择模式的名称,以打开右边栏中的模式属性对话框。 从此处选择用户档案切换按钮。
出现一个弹出窗口,表示缺少主标识。 选中此复选框以使用备用主标识,因为主标识将包含在identityMap
字段中。
最后,选择保存以确认更改。
在模式工作区中,选择创建模式,然后从下拉菜单中选择XDM ExperienceEvent。
出现Schema Editor,显示画布中模式的结构。 使用右边栏为模式提供名称和说明,然后在画布左侧的Mixins部分下选择添加。
出现添加mixin对话框。 从此处,从列表中选择隐私详细信息。 您可以选择使用搜索栏缩小结果范围,以便更轻松地定位混音。 选择混音后,选择添加混音。
画布将重新出现,显示consentStrings
数组已添加到模式结构。
从此处,重复上述步骤,向模式添加以下附加混音:
添加混音后,选择保存即可完成。
对于上述每个必需模式,您必须创建一个数据集,以最终收集客户同意数据。 必须为Real-time Customer Profile启用基于记录模式的数据集,而基于时间序列模式的数据集不应启用Profile。
首先,在左侧导航中选择数据集,然后选择右上角的创建数据集。
在下一页上,选择从模式创建数据集。
将显示从模式创建数据集工作流,从选择模式步骤开始。 在提供的列表中,找到您之前创建的同意模式之一。 您可以选择使用搜索栏缩小结果范围并更轻松地定位模式。 选择所需模式旁的单选按钮,然后选择下一步继续。
出现配置数据集步骤。 在选择完成之前,为数据集提供唯一、易于识别的名称和说明。
此时将显示新创建数据集的详细信息页面。 如果数据集基于您的时间序列模式,则该过程已完成。 如果数据集基于您的记录模式,则该过程的最后一步是启用数据集以用于Real-time Customer Profile。
在右边栏中,选择用户档案切换,然后在确认窗口中选择启用以启用Profile的模式。
再次按照上述步骤创建符合TCF 2.0要求的其他必需数据集。
通过遵循本教程,您创建了两个数据集,现在可用于收集客户同意数据:
您现在可以返回IAB TCF 2.0概述以继续配置平台以符合TCF 2.0的过程。