配置数据集以捕获同意和首选项数据

为了让Adobe Experience Platform处理您的客户同意/首选项数据,必须将该数据发送到架构中包含与同意和其他权限相关字段的数据集。 具体而言,此数据集必须基于XDM Individual Profile类,并且启用该类才能在Real-time Customer Profile中使用。

本文档提供了配置数据集以处理Experience Platform中的同意数据的步骤。 有关在Platform中处理同意/首选项数据的完整工作流程的概述,请参阅同意处理概述

重要

本指南中的示例使用一组标准化字段来表示客户同意值,具体由同意和首选项详细信息架构字段组定义。 这些字段的结构旨在提供一个高效的数据模型,以涵盖许多常见的同意收集用例。

但是,您也可以定义自己的字段组,以根据自己的数据模型表示同意。 根据以下选项,请咨询您的法律团队,以获得符合您业务需求的同意数据模型的批准:

  • 标准化的同意字段组
  • 由贵组织创建的自定义同意字段组
  • 自定义同意字段组提供的标准化同意字段组和其他字段的组合

先决条件

本教程需要对Adobe Experience Platform的以下组件有一定的了解:

重要

本教程假定您知道Platform中的Profile架构,您想要使用该架构来捕获客户属性信息。 无论您使用何种方法收集同意数据,此架构都必须为实时客户资料🔗启用。 此外,架构的主标识不能是禁止在基于兴趣的广告(如电子邮件地址)中使用的直接可识别字段。 如果您不确定哪些字段受到限制,请咨询您的法律顾问。

同意和首选项详 细信息字段组结构

同意和首选项详细信息字段组为架构提供标准化的同意字段。 目前,此字段组仅与基于XDM Individual Profile类的架构兼容。

字段组提供了一个对象类型字段consents,其子属性捕获一组标准化同意字段。 以下JSON是consents在摄取数据时所需的数据类型示例:

{
  "consents": {
    "collect": {
      "val": "y",
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "idSpecific": {
      "email": {
        "jdoe@example.com": {
          "marketing": {
            "email": {
              "val": "n"
            }
          }
        }
      }
    }
  },
  "metadata": {
    "time": "2019-01-01T15:52:25+00:00"
  }
}
注意

有关consents中子属性的结构和含义的更多信息,请参阅同意和首选项详细信息字段组上的概述。

将必填字段组添加到Profile架构

要使用Adobe标准收集同意数据,您必须具有启用了用户档案的架构,该架构包含以下两个字段组:

  • 同意和首选项详细信息
  • IdentityMap (使用Platform Web或Mobile SDK发送同意信号时需要使用此函数)

在Platform UI的左侧导航中,选择​架构,然后选择​Browse​选项卡以显示现有架构的列表。 从此处,选择要向其添加同意字段的已启用Profile架构的名称。 此部分中的屏幕截图使用在架构创建教程中构建的“忠诚会员”架构作为示例。

小贴士

您可以使用工作区的搜索和筛选功能来帮助更轻松地查找架构。 有关更多信息,请参阅探索XDM资源指南。

将出现Schema Editor,其中显示了画布中架构的结构。 在画布的左侧,选择​字段组​部分下的​Add

出现​添加字段组​对话框。 从此处,从列表中选择​同意和首选项详细信息。 您可以选择使用搜索栏来缩小结果范围,以便更轻松地找到字段组。

接下来,从列表中找到​IdentityMap​字段组,并将其选中。 在右边栏中列出两个字段组后,选择​添加字段组

画布将重新出现,显示consentsidentityMap字段已添加到架构结构中。 如果您需要标准字段组未捕获的其他同意和首选项字段,请参阅向架构添加自定义同意和首选项字段的附录部分。 否则,请选择​Save​以完成对架构的更改。

重要

如果要创建新架构,或编辑尚未为配置文件启用的现有架构,则必须在保存前启用配置文件的架构。

如果您编辑的架构由Platform Web SDK数据流中指定的配置文件数据集使用,则该数据集现在将包含新的同意字段。 现在,您可以返回同意处理指南以继续配置Experience Platform以处理同意数据的过程。 如果您尚未为此架构创建数据集,请按照下一部分中的步骤操作。

根据您的同意架构创建数据集

在创建包含同意字段的架构后,您必须创建一个数据集,以最终摄取客户的同意数据。 必须为Real-time Customer Profile启用此数据集。

要开始,请在左侧导航中选择​数据集,然后选择右上角的​创建数据集

在下一页,选择​从架构创建数据集

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

此时将显示​配置数据集​步骤。 在选择​完成​之前,为数据集提供唯一且易于识别的名称和描述。

此时会显示新创建数据集的详细信息页面。 如果数据集基于您的时间系列架构,则该过程会完成。 如果数据集基于您的记录架构,则此过程的最后一步是启用该数据集,以在Real-time Customer Profile中使用。

在右边栏中,选择​配置文件​切换开关。

最后,在确认弹出窗口中选择​启用​以启用Profile的架构。

数据集现已保存并启用,可在Profile中使用。 如果您计划使用Platform Web SDK将同意数据发送到配置文件,则在设置datastream时,必须将此数据集选为配置文件数据集。

后续步骤

通过阅读本教程,您向启用了Profile的架构添加了同意字段,该架构的数据集将用于使用Platform Web SDK或直接XDM摄取来摄取同意数据。

现在,您可以返回到同意处理概述以继续配置Experience Platform以处理同意数据。

附录

以下部分包含有关创建数据集以摄取客户同意和首选项数据的其他信息。

如果您需要捕获标准同意和首选项详细信息字段组所表示的同意信号以外的其他同意信号,则可以使用自定义XDM组件来增强您的同意架构,以满足您的特定业务需求。 本节概述了如何自定义同意模式以将这些信号摄取到用户档案的基本原则。

重要

平台Web SDK和移动SDK不支持在其同意更改命令中使用自定义字段。 目前,将自定义同意字段摄取到配置文件的唯一方法是通过批量摄取源连接

强烈建议您使用同意和首选项详细信息字段组作为同意数据结构的基线,并根据需要添加其他字段,而不是尝试从头开始创建整个结构。

要向标准字段组的结构添加自定义字段,您必须首先创建自定义字段组。 将同意和首选项详细信息字段组添加到架构后,在​字段组​部分中选择​加号(+)​图标,然后选择​创建新字段组。 为字段组提供名称和可选描述,然后选择​添加字段组

将重新显示Schema Editor,并在左边栏中选择新的自定义字段组。 在画布中,将显示用于向架构结构添加自定义字段的控件。 要添加新的同意或首选项字段,请选择consents对象旁边的加号(+)图标。

consents对象中会显示一个新字段。 由于您将自定义字段添加到标准XDM对象,因此新字段会在与租户ID命名的对象下创建。

在​字段属性​下的右边栏中,提供字段的名称和说明。 选择字段的​Type​时,必须为自定义同意或首选项字段使用相应的标准数据类型:

完成后,选择​Apply

同意或首选项字段将添加到架构结构中。 请注意,右边栏中显示的路径包含_tenantId命名空间。 每当您在数据操作中引用此字段的路径时,都必须包含此命名空间。

按照上述步骤继续添加您需要的同意和首选项字段。 完成后,选择​保存​以确认更改。

如果尚未为此架构创建数据集,请继续创建数据集上的部分。

在此页面上