迁移到Adobe Analytics 2.0 API analytics-2-migration

Adobe Analytics 1.4 API的生命周期即将结束。 将Campaign实例链接到Adobe Analytics的Web Analytics连接器依赖于这些API,因此您需要升级到使用新Analytics 2.0 API的版本以保持集成运行。

CAUTION
升级时会重新导入两个为连接器webAnalyticsSendMetrics和webAnalyticsGetWebEvents提供支持的内置技术工作流(请参阅Web Analytics工作流参考,了解每个工作流的用途)。 重新导入会覆盖您在这些工作流之上所做的任何自定义设置。 避免直接修改这些内置工作流 — 请改为在单独的自定义工作流中构建自定义项,以免将来升级时覆盖自定义项。 此升级还会更新内置Analytics JavaScript文件:如果您的任何自定义工作流引用这些文件,则这些文件将中断,需要适应新代码。

您是否受影响? are-you-impacted

如果您的实例将Web Analytics外部帐户用于以下任意项目,则您会受到影响:

  • 将电子邮件营销活动指标和属性作为指标发送到Adobe Analytics。
  • 正在将分类数据发送到Adobe Analytics。
  • 再营销流程(标识营销活动后转化的联系人)。
  • 您计划首次配置的Web Analytics外部帐户。

不确定其中哪一个适用于您? 检查实例上活动的上述技术工作流,并在Administration > Platform > External accounts中查看Web Analytics外部帐户配置(请参阅网站分析外部帐户)。

如何迁移 how-to-migrate

如果您在​ Adobe托管 ​实例上,Adobe会在升级过程中为您处理SFTP配置、IP允许列表和密钥配置 — 只需在新内部版本上线后验证用例即可。

如果您在​ 内部部署或混合 ​部署,请完成以下步骤。

  1. 将您的Campaign环境升级到包含Adobe Analytics 2.0更改的版本。 您可以确认从Help > About…运行哪个内部版本(请参阅如何检查您的Campaign版本)。

  2. 查看上面哪些用例适用于您的实例,因为下一步取决于它。

  3. 如果您使用再营销流程,则webAnalyticsFindConverted工作流需要一个专用的SFTP渠道来与Adobe Analytics 2.0交换数据。 如下所示进行设置;否则,请跳至下一步。

    1. 使用基于密钥的身份验证为实例设置SFTP服务器,遵循您应应用于任何其他外部SFTP集成的相同SFTP服务器最佳实践。 Adobe提供了一个示例SFTP安装脚本来帮助您入门。

    2. 通过运行随新内部版本一起提供的脚本在Adobe Analytics中注册该服务器的连接详细信息:

      code language-none
      nlserver javascript -instance:<instance_name> -arg:host=<sftp_host_url>#user=<sftp_user> -file <path_to_the_file>/aaremarketingLocation.js
      

      示例:

      code language-none
      nlserver javascript -instance:test_mkt_stage2 -arg:host=test-mkt-stage1.campaign.adobe.com#user=test -file ./nl6/datakit/nms/eng/js/aaremarketingLocation.js
      
    3. 在SFTP服务器上将Adobe Analytics添加到允许列表,因为再营销导出仅从一组固定的Adobe IP范围启动:

  4. 通过在Campaign Explorer树中的​ Administration> Platform >Options ​下创建或将选项的longvalue设置为xtkOption中的1,在实例上启用FEATUREFLAG_USE_ANALYTICS_20_API功能标记。 无论上述哪种用例适用于您,都需要执行此步骤。

  5. 在停用任何旧连接之前,通过实施适用于您的实例的每个用例来验证迁移(发送测试活动,检查指标是否进入Analytics,并确认再营销数据(如果适用))。

设置新的网站分析外部帐户 setting-up-a-new-web-analytics-external-account

无论您的实例是Adobe托管实例还是内部部署/混合实例,以下内容均适用。

如果您是首次配置Web Analytics外部帐户,而不是迁移现有帐户,请按照外部帐户设置步骤连接器入门指南操作。

由于Analytics 2.0引入了新的分类处理方式,因此您还需要在Adobe Analytics中创建分类集,然后外部帐户才能提取报表包的分类数据。 这是一个新步骤:在配置转化变量和成功事件之后,在Campaign中配置外部帐户之前创建它。

要创建分类集,请执行以下操作:

  1. 从Adobe Analytics顶部菜单栏中选择​Components > Classification sets,然后单击​New

  2. 在​ Add New Classification Set ​对话框中:

    • 输入分类集的​Name
    • 将​ Type ​设置为​Primary
    • 在​ Job notifications ​中,选择分类集作业成功或失败时应通知的人员,并提供相应的电子邮件地址。
    • 在​ Subscriptions ​中,选择您的报表包以及您在上一步中为内部营销活动名称创建的转化变量。
  3. 单击 Save

在下一步配置外部帐户时,Campaign将自动搜索此分类集。 有关分类集的详细信息,请参阅Adobe Analytics文档

是否需要帮助? need-help

如果您在迁移期间遇到问题,请联系Adobe客户关怀

recommendation-more-help
campaign-classic-help