正在更新到Adobe Audience Manager的DIL版本8.0(或更高版本)

本文将提供有关将Adobe Audience Manager(AAM) Data Integration Library (DIL)代码更新为版本8.0或更高版本的步骤和建议。 这指的是“客户端”DIL实施,而非Adobe Analytics数据的服务器端转发,它将涵盖没有Adobe标签管理器解决方案的DTM、Launch by Adobe和实施。

概述

Audience Manager的Data Integration Library (DIL)代码允许您在网站*上实施AAM。 在实施旧版DIL时,也不需要实施Adobe的Experience CloudID服务(ECID)(尽管这是一个很好的主意)。 从DIL版本8.0开始,对ECID版本3.3或更高版本存在硬依赖关系。 如果您在未使用ECID 3.3的情况下或使用早期版本实施DIL 8.0或更高版本,您将收到错误,并且它将无法正常工作。 由于您可以通过多种方式实施AAM,因此我们创建了此页面,以为您提供一些要执行的步骤以及一些建议。 在下面,您将发现这些步骤和建议按平台/实施方法分类。 文档中提供了有关DIL的更多信息。

  • 如本页说明中所述,这将仅涵盖“客户端”DIL实施(由没有Adobe Analytics的AAM客户使用)。 如果您有Adobe Analytics,应使用实现AAM的服务器端转发方法。 此方法在documentation中有介绍。

重复和已弃用的元素和方法

在DIL和ECID的先前版本中,存在重复方法(在DIL和ECID中都具有相同功能的方法),这导致对使用哪一种方法产生混淆。 通常,您需要同时使用它们并将其匹配起来,而且该信息没有与我们的客户很好地沟通。 从DIL 8.0开始,这些重复方法和元素在DIL中已弃用,建议您使用ECID版本。

例如:

  • 使用DIL.create时,已弃用一些元素,应改用ECID元素。 这些元素在DIL.create documentation中调用。
  • idSync实例级方法也已弃用,如方法的documentation中所调用。

ID与客户ID同步

在AAM中,您可以将计算机上的UUID(匿名唯一用户ID)与客户ID同步,以便上传有关该客户的脱机数据并将其与他们的联机行为关联,以便更好地了解您的客户。 过去,这是通过以下两种方式之一实现的:

  • idSync实例级方法
  • DIL.create中的declaredId元素

如果您使用其中任一较旧的方法与客户ID同步,强烈建议您更新为使用setCustomerIDs方法,该方法是ECID服务的一部分。 有关setCustomerIDs的详细信息,请参阅方法的文档

快速提 示:之前使用上述任一方法时,您使用 Data Source ID Data Source 引用了AAM(AKA为“DPID”)。更新到setCustomerIDs时,您需要改用AAM Data Source的“Integration Code”。 它仍指向相同的Data Source,但只是一个不同的标识符。 以下视频显示了此内容。

以下各节列表了根据您的实现方法更新到DIL 8.0的步骤和建议:

更新到Adobe Experience Platform Launch中的DIL 8.0

更新到DIL 8.0的基本步骤

  1. 如果您使用的是8.0之前版本的DIL,请在升级之前,进入AAM扩展中的DIL配置,并记下您使用的任何高级选项(将在后续步骤中使用)

  2. 将您的AAM扩展更新到8.0或更高版本

  3. 验证您的Experience CloudID服务扩展是否为3.3.0版或更高版本

  4. 对于您8.0之前的AAM扩展或用于DIL的自定义代码中的任何已弃用的方法/元素(如“disableIDSyncs”),请在ECID扩展中启用ECID方法。

    1. (DIL)disableDestinationPublishingIframe ->(ECID)disableIdSyncs
    2. (DIL)disableIDSyncs ->(ECID)disableIdSyncs
    3. (DIL)iframeAkamaiHTTPS ->(ECID)dSyncSSLUseAkamai
    4. (DIL)declaredId ->(ECID)setCustomerID
  5. 发布更改

在Adobe DTM中更新到DIL 8.0

  1. 将您的AAM工具更新至8.0或更高版本。 此版本设置位于AAM工具的“常规”部分下。
  2. 对于8.0之前AAM工具的自定义代码中用于DIL的任何已弃用的方法/元素(如“disableIDSyncs”),请注意这些方法/元素(以便将它们添加到ECID工具),然后从AAM工具的自定义DIL code中删除它们。
  3. 将您的Experience CloudID服务扩展更新为3.3.0版或更高版本
  4. 将高级选项添加到您从AAM工具的自定义代码中删除的ECID工具。
  5. 发布更改

更新到DIL 8.0时没有Adobe标签管理解决方案

如果要直接在页面上更新代码,则您只需将旧项目替换为较新的项目,但需要将方法/元素从DIL移动到ECID时除外,如上所述。 在这种情况下,您只需将DIL位置中的旧方法/元素替换为ECID位置中的ECID方法/元素。

对于非Adobe标签管理器,情况也是如此。 无论您在该标签管理解决方案中具有旧版本,请按照以下步骤所述将其替换为新代码。

  1. 将您的DIL库更新至最新版本(8.0或更高版本) — 您需要从Adobe咨询或Adobe客户关怀获得最新的DIL代码,因为它当前不在公共位置提供。 然后,只需将旧DIL库代码替换为新DIL库代码,然后继续执行下一步(不要立即停止,否则您会遇到问题,哈)。

  2. 安装ECID Service或将现有版本更新为3.3.0或更高版本。 您可以从我们的GitHub页面🔗下载最新的Experience CloudID服务版本。 如果您需要帮助,请参阅文档或与Adobe顾问交谈。

  3. 验证DIL自定义代码中的任何已弃用的方法或元素是否已移到ECID方法:

    1. (DIL)disableDestinationPublishingIframe ->(ECID)disableIdSyncs

      文档

    2. (DIL)disableIDSyncs ->(ECID)disableIdSyncs

      文档

    3. (DIL)iframeAkamaiHTTPS ->(ECID)idSyncSSLUseAkamai

      文档

    4. (DIL)declaredId ->(ECID)setCustomerID

      文档

在此页面上