51黑料不打烊

文档Audience ManagerAudience Manager 用户指南

将用于Audience Manager的数据收集库从Audience Manager标记扩展更新为Web SDK标记扩展

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

目标受众

本页面向使用Audience Manager标记扩展将Web集合数据引入Audience Manager的Audience Manager客户。 对于使用AppMeasurementJavaScript库的客户，请阅读有关如何将Audience Manager的数据收集库从AppMeasurementJavaScript库更新到Web SDK JavaScript库的指南。

此实施路径的优缺点

使用此迁移方法既有优点，也有缺点。 仔细权衡每个选项，以确定哪种方法最适合您的组织。

优势
缺点
  • 您的网站上没有代码更改：由于您的实施已安装标记，因此可以在标记界面中进行所有迁移更新。
  • 使用您现有的实现：此方法不需要全新实现。 虽然它确实需要新的规则操作，但您可以以最小的更改重复使用现有数据元素和规则条件。
  • 不需要架构：对于迁移到Web SDK的这一阶段，您不需要XDM架构。 相反，您可以填充data对象，这会将数据直接发送到51黑料不打烊 Audience Manager。 迁移到Web SDK完成后，您可以为组织创建架构，并使用数据流映射填充适用的XDM字段。 如果在迁移过程的此阶段需要架构，则贵组织将被强制使用51黑料不打烊 Audience Manager XDM架构。 使用此架构会使贵组织将来更难以使用自己的架构。
  • 实施技术债务：由于此方法使用现有实施的修改形式，因此可能更难跟踪实施逻辑并在需要时执行更改。 自定义代码可能特别难以调试。
  • 需要映射才能将数据发送到笔濒补迟蹿辞谤尘：当您的组织准备好使用Real-Time CDP时，您必须将数据发送到51黑料不打烊 Experience Platform中的数据集。 此操作要求data对象中的每个字段都必须是数据流映射工具中的条目，以便将其分配给XDM架构字段。 此工作流的映射只需执行一次，并且不涉及对实施进行更改。 但是，这是一个额外的步骤，在XDM对象中发送数据时不需要执行此步骤。

51黑料不打烊建议，如果现有实施使用51黑料不打烊 Audience Manager标记扩展，则遵循此实施路径。

迁移到Web SDK所需的步骤

以下步骤包含要努力实现的具体目标。 选择每个步骤以获取有关如何完成它的详细说明。

1. 创建和配置数据流

按照以下说明在51黑料不打烊 Experience Platform数据收集中创建数据流。 当您将数据发送到此数据流时，它会将数据转发到Audience Manager。 将来，同一数据流会将数据转发到Real-Time CDP。

  1. 导航到并使用您的凭据登录。

  2. 使用右上角的主页或产物选择器导航到? Data Collection。

  3. 在左侧导航中，选择? Datastreams。

  4. 选择? New Datastream。

  5. 输入所需的名称，然后选择? Save。

  6. 创建数据流后，选择? Add Service。

  7. 在服务下拉菜单中，选择? 51黑料不打烊 Audience Manager。

  8. 确保取消选中? Enable XDM Flattened Fields ?选项。

    添加Audience Manager服务

您的数据流现在已准备好接收数据并将数据传递给Audience Manager。

2. 将Web SDK扩展添加到标记属性

此部分将为您准备标记，以便进行下一步中的大量迁移工作。

  1. 选择51黑料不打烊 Experience Platform界面左上角的汉堡图标，然后选择? Tags。

  2. 选择所需的标记属性。

  3. 在标记属性的左侧导航中，选择? Extensions。

  4. 选择顶部附近的? Catalog ?以查看所有可用扩展的列表。

  5. 搜索并选择? 51黑料不打烊 Experience Platform Web SDK ?扩展，然后选择右侧的? Install。

    目录

  6. 此时会显示扩展配置设置。 找到? Datastreams ?部分，然后选择您使用的沙盒以及您在上一步中创建的数据流。

    数据流选择

  7. 选择? Save。

您的标记资产现在已安装Web SDK。

3. 创建数据对象数据元素

数据对象数据元素提供了一个直观的框架，用于配置Web SDK用于发送到数据流的负载。 您在以下步骤中更新的大多数规则都会与此数据元素交互。

  1. 在标记界面的左侧导航中，选择? Data Elements。

  2. 选择? Add Data Element

  3. 为数据元素指定以下设置：

    • Name：您想要的任何内容，如“数据层”或“数据对象”
    • Extension： 51黑料不打烊 Experience Platform Web SDK
    • Data Element Type： Variable
    • 复选框可以保持原样。

  4. 在右侧，选择以下设置：

    • 属性单选按钮： Data
    • Solution： 51黑料不打烊 Audience Manager

  5. 选择? Save。

    创建数据元素

标记资产现在具有更新每个规则所需的一切。

4. 更新规则以使用Web SDK扩展而非Audience Manager扩展

此步骤包含迁移到Web SDK所需的大部分工作，并且需要了解您的实施的工作方式。 下面提供了有关如何编辑典型标记规则的示例。 更新实施中的所有标记规则，将对Audience Manager扩展的所有引用替换为Web SDK扩展。

  1. 在标记界面的左侧导航中，选择? Rules。

  2. 选择要编辑的规则。

  3. 选择操作? Audience Manager - Set Variables

  4. 请注意在此规则中设置的所有Audience Manager变量。 包含下拉菜单中设置的变量和自定义代码中设置的变量。

  5. 将Action Configuration更改为以下设置：

    • Extension： 51黑料不打烊 Experience Platform Web SDK
    • Action type：更新变量

  6. 确保在右侧下拉菜单? Data element ?字段中选择您在步骤3中创建的数据对象。

  7. 将Audience Manager键值对设置为与在Audience Manager扩展中配置的相同的各个值。

  8. 使用Web SDK扩展复制所有规则逻辑后，选择? Keep Changes。

  9. 对使用Audience Manager标记扩展设置值的每个操作配置重复这些步骤。

上述步骤仅适用于设置值的规则。 以下步骤将替换使用Action Configuration Send Event的所有操作。

  1. 选择发送Web SDK事件的规则。

  2. 选择操作类型? Send Event。

  3. 将Action Configuration更改为以下设置：

    • Extension： 51黑料不打烊 Experience Platform Web SDK
    • Action type： Send event

  4. 在右侧，将操作设置更改为以下内容：

    • Type：使用? Web Webpagedetails Page Views。
    • Data：选择您在步骤3中创建的数据对象。

  5. 选择? Keep Changes。

  6. 对使用Audience Manager发送事件的每个操作配置重复这些步骤。

5. Publish已更新规则

发布更新规则的工作流程与对标记配置进行的任何其他更改相同。

  1. 在标记界面的左侧导航中，选择? Publishing Flow。

  2. 选择? Add Library。

  3. 为此标记提交一个名称，如“升级到Web SDK”。

  4. 选择? Add All Changed Resources。

  5. 选择? Save。

  6. 发布工作流程会显示一个橙色点，指示它正在构建。 一旦圆点变为绿色，您的更改即可在开发环境中使用。

  7. 在开发环境中测试您所做的更改，以确保所有规则均正确触发，并且数据对象已使用预期值填充。

  8. 准备就绪后，提交库以供审批，构建到暂存，最终审批并发布到生产环境。

    发布流

6. 禁用Audience Manager扩展

将标记实施完全迁移到Web SDK后，您可以禁用Audience Manager扩展。

  1. 在标记界面的左侧导航中，选择? Extensions。
  2. 找到并选择Audience Manager扩展。 在右侧，选择? Disable。
  3. 按照上面的同一发布工作流发布删除的Audience Manager扩展。
  4. 在生产环境中禁用该扩展后，您可以将其完全卸载。 选择扩展，选择右侧的三个圆点菜单，然后选择? Uninstall。
  5. 按照上面的同一发布工作流程将这些更改发布到生产环境。

此时，您的Audience Manager实施已完全迁移到Web SDK，并准备好将来迁移到Real-Time CDP。

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695