文档Audience ManagerAudience Manager 用户指南

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

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

目标受众

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

此实施路径的优缺点

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

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

如果您在使用Adobe Audience Manager标记扩展的现有实施，Adobe建议遵循此实施路径。

迁移到Web SDK所需的步骤

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

1. 创建和配置数据流

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

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

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

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

  4. 选择​ New Datastream。

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

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

  7. 在服务下拉菜单中，选择​ Adobe Audience Manager。

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

    添加Audience Manager服务

您的数据流现在可以接收数据并传递给Audience Manager。

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

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

  1. 选择Adobe Experience Platform界面左上角的汉堡图标，然后选择​ Tags。

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

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

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

  5. 搜索并选择​ Adobe Experience Platform Web SDK ​扩展，然后选择右侧的​ Install。

    目录

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

    数据流选择

  7. 选择​ Save。

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

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

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

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

  2. 选择​ Add Data Element

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

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

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

    • 属性单选按钮： Data
    • Solution： Adobe 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： Adobe 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： Adobe Experience Platform Web SDK
    • Action type： Send event

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

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

  5. 选择​ Keep Changes。

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

5. 发布更新的规则

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

  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