从Adobe Analytics标记扩展迁移到Web SDK标记扩展

此实施路径涉及从Adobe Analytics标记扩展迁移到Web SDK标记扩展的方法迁移。 其他实施路径将在单独的页面上介绍:

  • AppMeasurement到Web SDK JavaScript库:一种流畅、系统地迁移到Web SDK的方法,只不过它不使用标记。 而是手动删除Adobe Analytics数据收集库(AppMeasurement.js)并将其替换为Web SDK JavaScript库(alloy.js)。
  • Web SDK标记扩展:一个全新的Web SDK安装,您可以在其中使用Adobe Experience Platform数据收集中的标记管理实施。 它需要Adobe Analytics ExperienceEvent字段组,其中包括要包含在XDM架构中的典型Analytics变量。
  • Web SDK JavaScript库:使用Web SDK JavaScript库(alloy.js)的全新Web SDK安装。 自行管理实施,而不是使用标记UI。 它需要Adobe Analytics ExperienceEvent字段组,其中包括要包含在XDM架构中的典型Analytics变量。

此实施路径的优缺点

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

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

Adobe建议在以下情况下遵循此实施路径:

  • 您已有使用Adobe Analytics标记扩展的实施项目。 如果您有一个使用AppMeasurement的实现,请改为遵循从AppMeasurement迁移到Web SDK
  • 您打算在将来使用Customer Journey Analytics,但不希望从头开始使用Web SDK实施来替换Analytics实施。 在Web SDK上从头开始替代实施需要做出最大努力,但同时需要提供最可行的长期实施架构。 如果贵组织愿意进行干净的Web SDK实施,请参阅Customer Journey Analytics用户指南中的通过Adobe Experience Platform Web SDK摄取数据

迁移到Web SDK所需的步骤

以下步骤包含要努力实现的具体目标。 单击每个步骤以了解完成该操作的详细说明。

1. 创建和配置数据流

在Adobe Experience Platform数据收集中创建数据流。 当您将数据发送到此数据流时,它会将数据转发到Adobe Analytics。 将来,同一数据流会将数据转发到Customer Journey Analytics。

  1. 导航到experience.adobe.com并使用您的凭据登录。
  2. 使用右上角的主页或产品选择器导航到​ 数据收集
  3. 在左侧导航中,选择​ 数据流
  4. 选择​ 新数据流
  5. 输入所需的名称,然后选择​ 保存
  6. 创建数据流后,选择​ 添加服务
  7. 在服务下拉菜单中,选择​ Adobe Analytics
  8. 输入与您当前将分析数据发送到的网站相同的报表包ID。 单击​ 保存

添加Adobe Analytics服务

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

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

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

  1. 单击Adobe Experience Platform界面左上角的汉堡图标,然后选择​ 标记

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

  3. 在标记属性的左侧导航中,选择​ 扩展

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

  5. 搜索并选择​ Adobe Experience Platform Web SDK ​扩展,然后单击右侧的​ 安装

    目录

  6. 此时会显示扩展配置设置。 找到数据流部分,然后选择在上一步中创建的数据流。

    数据流选择

  7. 选择​ 保存

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

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

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

  1. 在标记界面的左侧导航中,选择​ 数据元素

  2. 选择​ 添加数据元素

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

    • 名称:您需要的任何内容,如“数据层”或“数据对象”
    • 扩展:Adobe Experience Platform Web SDK
    • 数据元素类型: 变量
    • 复选框可以保持原样
  4. 在右侧,选择以下设置:

    • 属性单选按钮: 数据
    • 解决方案:Adobe Analytics
  5. 选择​ 保存

创建数据元素

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

4. 更新规则以使用Web SDK扩展而不是Analytics扩展

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

  1. 在标记界面的左侧导航中,选择​ 规则

  2. 选择要编辑的规则。

  3. 选择操作​ Adobe Analytics — 设置变量

  4. 记下在此规则中设置的所有Analytics变量。 包含下拉菜单中设置的变量和自定义代码中设置的变量。

  5. 将操作配置更改为以下设置:

    • 扩展:Adobe Experience Platform Web SDK
    • 操作类型:更新变量
  6. 确保在右侧的下拉列表中选择数据对象。

  7. 将Analytics变量设置为其各自的值,这些值与Analytics扩展中配置的值相同。

    • 在标记界面中设置的变量可以直接转换为相同的值。
    • 在自定义代码中设置的字符串变量需要进行的调整最少。 请改用data.__adobe.analytics,而不要使用s对象。 例如,s.eVar1将转换为data.__adobe.analytics.eVar1
    • 自定义代码中的Analytics配置变量和方法调用可能需要修改实施逻辑。 查看每个相应的变量,以确定如何使用Web SDK实现等效变量。
  8. 使用Web SDK扩展复制所有规则逻辑后,选择​ 保留更改

  9. 对使用Adobe Analytics扩展设置值的每个操作配置重复这些步骤。 此步骤包括使用标记界面设置的变量和使用自定义代码设置的变量。 自定义代码块不能在任何地方引用s对象。

上述步骤仅适用于设置值的规则。 以下步骤将替换使用操作配置 发送信标的所有操作。

  1. 选择发送信标的规则。

  2. 选择操作​ Adobe Analytics — 发送信标

  3. 记下右侧跟踪单选按钮的当前值(s.t()s.tl())。

  4. 将操作配置更改为以下设置:

    • 扩展:Adobe Experience Platform Web SDK
    • 操作类型: 发送事件
  5. 在右侧,将操作设置更改为以下内容:

    • 类型:对于s.t(),使用​ Web网页详细信息页面查看次数。 对于s.tl(),使用​ Web Webinteraction链接点击次数。 如果使用s.tl(),则还必须在数据对象中包含以下字段。 执行更新变量操作配置时,这些字段列在其他属性下:

  6. 选择​ 保留更改

  7. 对使用Adobe Analytics发送信标的每个操作配置重复这些步骤。

5. Publish已更新规则

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

  1. 在标记界面的左侧导航中,选择​ 发布流
  2. 选择​ 添加库
  3. 为此标记提交一个名称,如“升级到Web SDK”。
  4. 选择​ 添加所有更改的资源
  5. 选择​ 保存
  6. 发布工作流程会显示一个橙色点,指示它正在构建。 一旦圆点变为绿色,您的更改即可在开发环境中使用。
  7. 在开发环境中测试您所做的更改,以确保所有规则均正确触发,并且数据对象已使用预期值填充。
  8. 准备就绪后,提交库以供审批,构建到暂存,最终审批并发布到生产环境。

发布流

6. 禁用Analytics扩展

标记实施完全在Web SDK上后,您可以禁用Adobe Analytics扩展。

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

此时,您的Analytics实施已完全放在Web SDK上,并准备好将来迁移到Customer Journey Analytics。

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690