创建数据集以捕获IAB TCF 2.0同意数据

为了使Adobe Experience Platform按照IAB Transparency & Consent Framework (TCF)2.0处理客户同意数据,必须将这些数据发送到模式包含TCF 2.0同意字段的数据集。

具体而言,捕获TCF 2.0同意数据需要两个数据集:

  • 基于XDM Individual Profile类的数据集,在Real-time Customer Profile中启用。
  • 基于XDM ExperienceEvent类的数据集。

此文档提供了设置这两个数据集以收集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字段已添加到模式结构。

从此处,重复上述步骤,向模式添加以下附加混音:

  • IdentityMap
  • 用户档案的数据捕获区域
  • 人口统计详细信息
  • 个人联系人详细信息

如果编辑的现有模式已启用在Real-time Customer Profile中使用,请选择​保存​以确认更改,然后跳到中根据您的同意模式创建数据集的部分。 如果要创建新模式,请继续执行下面子节中概述的步骤。

启用模式以在Real-time Customer Profile中使用

为了使平台将其收到的同意数据与特定客户用户档案关联,必须启用同意模式以在Real-time Customer Profile中使用。

注意

本节中显示的示例模式使用其identityMap字段作为主标识。 如果您希望将另一个字段设置为主要标识,请确保您使用的是Cookie ID等间接标识符,而不是基于兴趣的广告中禁止使用的直接可识别字段,如电子邮件地址。 如果您不确定哪些字段受限,请咨询您的法律顾问。

有关如何为模式设置主标识字段的步骤,请参阅模式创建教程

要启用Profile的模式,请在左边栏中选择模式的名称,以打开右边栏中的​模式属性​对话框。 从此处选择​用户档案​切换按钮。

出现一个弹出窗口,表示缺少主标识。 选中此复选框以使用备用主标识,因为主标识将包含在identityMap字段中。

最后,选择​保存​以确认更改。

创建基于时间序列的同意模式

在​模式​工作区中,选择​创建模式,然后从下拉菜单中选择​XDM ExperienceEvent

出现Schema Editor,显示画布中模式的结构。 使用右边栏为模式提供名称和说明,然后在画布左侧的​Mixins​部分下选择​添加

出现​添加mixin​对话框。 从此处,从列表中选择​隐私详细信息。 您可以选择使用搜索栏缩小结果范围,以便更轻松地定位混音。 选择混音后,选择​添加混音

画布将重新出现,显示consentStrings数组已添加到模式结构。

从此处,重复上述步骤,向模式添加以下附加混音:

  • IdentityMap
  • 环境详细信息
  • Web详细信息
  • 实施详细信息

添加混音后,选择​保存​即可完成。

根据您同意的模式创建数据集

对于上述每个必需模式,您必须创建一个数据集,以最终收集客户同意数据。 必须为Real-time Customer Profile启用基于记录模式的数据集,而基于时间序列模式​的数据集不应​启用Profile。

首先,在左侧导航中选择​数据集,然后选择右上角的​创建数据集

在下一页上,选择​从模式​创建数据集。

将显示​从模式​创建数据集工作流,从​选择模式​步骤开始。 在提供的列表中,找到您之前创建的同意模式之一。 您可以选择使用搜索栏缩小结果范围并更轻松地定位模式。 选择所需模式旁的单选按钮,然后选择​下一步​继续。

出现​配置数据集​步骤。 在选择​完成​之前,为数据集提供唯一、易于识别的名称和说明。

此时将显示新创建数据集的详细信息页面。 如果数据集基于您的时间序列模式,则该过程已完成。 如果数据集基于您的记录模式,则该过程的最后一步是启用数据集以用于Real-time Customer Profile。

在右边栏中,选择​用户档案​切换,然后在确认窗口中选择​启用​以启用Profile的模式。

再次按照上述步骤创建符合TCF 2.0要求的其他必需数据集。

后续步骤

通过遵循本教程,您创建了两个数据集,现在可用于收集客户同意数据:

  • 支持在实时客户用户档案中使用的基于记录的数据集。
  • 未为Profile启用的基于时间序列的数据集。

您现在可以返回IAB TCF 2.0概述以继续配置平台以符合TCF 2.0的过程。

在此页面上