从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所需的步骤
以下步骤包含要努力实现的具体目标。 单击每个步骤以了解完成该操作的详细说明。
在Adobe Experience Platform数据收集中创建数据流。 当您将数据发送到此数据流时,它会将数据转发到Adobe Analytics。 将来,同一数据流会将数据转发到Customer Journey Analytics。
- 导航到experience.adobe.com并使用您的凭据登录。
- 使用右上角的主页或产品选择器导航到 数据收集。
- 在左侧导航中,选择 数据流。
- 选择 新数据流。
- 输入所需的名称,然后选择 保存。
- 创建数据流后,选择 添加服务。
- 在服务下拉菜单中,选择 Adobe Analytics。
- 输入与您当前将分析数据发送到的网站相同的报表包ID。 单击 保存。
您的数据流现在可以接收数据并传递给Adobe Analytics。
此部分将为您准备标记,以便进行下一步中的大量迁移工作。
-
单击Adobe Experience Platform界面左上角的汉堡图标,然后选择 标记。
-
选择所需的标记属性。
-
在标记属性的左侧导航中,选择 扩展。
-
选择顶部附近的 目录,查看所有可用扩展的列表。
-
搜索并选择 Adobe Experience Platform Web SDK 扩展,然后单击右侧的 安装。
-
此时会显示扩展配置设置。 找到数据流部分,然后选择在上一步中创建的数据流。
-
选择 保存。
您的标记资产现在已安装Web SDK。
数据对象数据元素提供了一个直观的框架,用于配置Web SDK用于发送到数据流的负载。 您在以下步骤中更新的大多数规则都会与此数据元素交互。
-
在标记界面的左侧导航中,选择 数据元素。
-
选择 添加数据元素
-
为数据元素指定以下设置:
- 名称:您需要的任何内容,如“数据层”或“数据对象”
- 扩展:Adobe Experience Platform Web SDK
- 数据元素类型: 变量
- 复选框可以保持原样
-
在右侧,选择以下设置:
- 属性单选按钮: 数据
- 解决方案:Adobe Analytics
-
选择 保存。
标记资产现在具有更新每个规则所需的一切。
此步骤包含迁移到Web SDK所需的大部分工作,并且需要了解您的实施的工作方式。 以下提供了示例,作为如何编辑典型标记规则的示例。 更新实施中的所有标记规则,将对Adobe Analytics扩展的所有引用替换为Web SDK扩展。
-
在标记界面的左侧导航中,选择 规则。
-
选择要编辑的规则。
-
选择操作 Adobe Analytics — 设置变量
-
记下在此规则中设置的所有Analytics变量。 包含下拉菜单中设置的变量和自定义代码中设置的变量。
-
将操作配置更改为以下设置:
- 扩展:Adobe Experience Platform Web SDK
- 操作类型:更新变量
-
确保在右侧的下拉列表中选择数据对象。
-
将Analytics变量设置为其各自的值,这些值与Analytics扩展中配置的值相同。
- 在标记界面中设置的变量可以直接转换为相同的值。
- 在自定义代码中设置的字符串变量需要进行的调整最少。 请改用
data.__adobe.analytics
,而不要使用s
对象。 例如,s.eVar1
将转换为data.__adobe.analytics.eVar1
。 - 自定义代码中的Analytics配置变量和方法调用可能需要修改实施逻辑。 查看每个相应的变量,以确定如何使用Web SDK实现等效变量。
-
使用Web SDK扩展复制所有规则逻辑后,选择 保留更改。
-
对使用Adobe Analytics扩展设置值的每个操作配置重复这些步骤。 此步骤包括使用标记界面设置的变量和使用自定义代码设置的变量。 自定义代码块不能在任何地方引用
s
对象。
上述步骤仅适用于设置值的规则。 以下步骤将替换使用操作配置 发送信标的所有操作。
-
选择发送信标的规则。
-
选择操作 Adobe Analytics — 发送信标。
-
将操作配置更改为以下设置:
- 扩展:Adobe Experience Platform Web SDK
- 操作类型: 发送事件
-
在右侧,将操作设置更改为以下内容:
-
选择 保留更改。
-
对使用Adobe Analytics发送信标的每个操作配置重复这些步骤。
发布更新规则的工作流程与对标记配置进行的任何其他更改相同。
- 在标记界面的左侧导航中,选择 发布流。
- 选择 添加库。
- 为此标记提交一个名称,如“升级到Web SDK”。
- 选择 添加所有更改的资源。
- 选择 保存。
- 发布工作流程会显示一个橙色点,指示它正在构建。 一旦圆点变为绿色,您的更改即可在开发环境中使用。
- 在开发环境中测试您所做的更改,以确保所有规则均正确触发,并且数据对象已使用预期值填充。
- 准备就绪后,提交库以供审批,构建到暂存,最终审批并发布到生产环境。
标记实施完全在Web SDK上后,您可以禁用Adobe Analytics扩展。
- 在标记界面的左侧导航中,选择 扩展。
- 找到并选择Adobe Analytics扩展。 在右侧,选择 禁用。
- 按照上面的同一发布工作流程发布删除的Adobe Analytics扩展。
- 在生产环境中禁用该扩展后,您可以将其完全卸载。 选择扩展,选择右侧的三个圆点菜单,然后选择 卸载。
- 按照上面的同一发布工作流程将这些更改发布到生产环境。
此时,您的Analytics实施已完全放在Web SDK上,并准备好将来迁移到Customer Journey Analytics。