配置数据集以捕获同意和偏好设置数据

上次更新: 2023-11-27
  • 创建对象:
  • Developer
    User
    Admin
    Leader

为了让Adobe Experience Platform处理您的客户同意/偏好设置数据,必须将该数据发送到数据集,其架构包含与同意和其他权限相关的字段。 具体而言,此数据集必须基于 XDM Individual Profile 类,并启用以便在 Real-Time Customer Profile.

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

重要

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

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

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

先决条件

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

  • 体验数据模型(XDM):用于实现此目标的标准化框架 Experience Platform 组织客户体验数据。
  • Real-time Customer Profile:将来自不同来源的客户数据整合到一个完整、统一的视图中,同时为每次客户交互提供一个带有时间戳的可操作帐户。
重要

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

同意和偏好设置详细信息 字段组结构

此 同意和偏好设置详细信息 字段组为架构提供标准化的同意字段。 目前,此字段组仅与基于 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标准收集同意数据,您必须具有启用配置文件的架构,该架构包含以下两个字段组:

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

小贴士

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

此 Schema Editor 显示,显示画布中的架构结构。 在画布的左侧,选择 添加字段组 部分。

添加字段组 出现对话框。 从此处选择 同意和偏好设置详细信息 从名单上。 您可以选择使用搜索栏来缩小结果范围,以便更轻松地查找字段组。

接下来,查找 Identitymap 字段组并选择它。 一旦两个字段组都列在右边栏中,请选择 添加字段组.

画布将重新出现,并显示 consentsidentityMap 字段已添加到架构结构。 如果您需要标准字段组未捕获的其他同意和偏好设置字段,请参阅 将自定义同意和偏好设置字段添加到架构. 否则,选择 保存 以完成对架构的更改。

重要

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

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

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

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

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

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

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

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

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

在右边栏中,选择 个人资料 切换。

最后,选择 启用 在确认弹出框中启用架构 Profile.

数据集现已保存并启用以供使用 Profile. 如果您计划使用Platform Web SDK将同意数据发送到配置文件,则必须选择此数据集作为 配置文件数据集 设置您的 数据流.

后续步骤

在本教程之后,您已向添加同意字段 Profile — 支持的架构,其数据集将用于使用Platform Web SDK或直接XDM摄取来摄取同意数据。

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

附录

以下部分包含有关创建数据集以摄取客户同意和偏好设置数据的其他信息。

如果您需要捕获标准所表示同意信号以外的其他同意信号 同意和偏好设置详细信息 字段组,则可以使用自定义XDM组件来增强同意模式,以满足您的特定业务需求。 此部分概述如何自定义同意模式的基本原则,以便将这些信号摄取到配置文件中。

重要

Platform Web和Mobile SDK在其同意更改命令中不支持自定义字段。 目前,将自定义同意字段摄取到用户档案的唯一方法是通过 批量摄取源连接.

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

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

此 Schema Editor 会在左边栏中选择新的自定义字段组后重新显示。 在画布中显示控件,允许您向架构结构添加自定义字段。 要添加新的同意或偏好设置字段,请选择 加(+) 图标(位于 consents 对象。

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

在右边栏中,在 字段属性,提供字段的名称和描述。 选择字段的 类型​中,您必须为自定义同意或偏好设置字段使用相应的标准数据类型:

完成后,选择 应用.

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

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

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

在此页面上