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