正在更新到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

      文档

在此页面上