正在更新到Adobe Audience Manager的DIL版本8.0(或更高版本) updating-to-adobe-audience-manager-s-dil-version-or-greater

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

概述 overview

Audience Manager的Data Integration Library (DIL)代码允许您在网站上实施AAM*。 在实施以前版本的DIL时,不需要同时实施Adobe的Experience CloudID服务(ECID)(不过这是一个非常好的主意)。 从DIL版本8.0开始,硬依赖于ECID版本3.3或更高版本。 如果您在不使用ECID 3.3的情况下实施DIL8.0或更高版本,或者实施了早期版本,则会收到错误,并且无法正常使用。 由于有多种方法可以实施AAM,因此我们创建了此页面,为您提供了一些要完成的步骤以及一些建议。 在下面,您会找到按平台/实施方法划分的这些步骤和建议。 有关DIL的详细信息,请参阅文档

  • 如本页描述中所述,这将仅涵盖“客户端”DIL实施,这些实施由没有Adobe Analytics的AAM客户使用。 如果您拥有Adobe Analytics,则应该使用实施AAM的服务器端转发方法。 文档中介绍了此方法。

重复和已弃用的元素和方法 duplicate-and-deprecated-elements-and-methods

在DIL和ECID的先前版本中,存在重复方法(在DIL和ECID中具有相同功能的方法),这会导致不知道要使用哪种方法。 通常情况下,您需要同时使用这两种工具并将其匹配,并且该消息没有很好地传达给我们的客户。 从DIL8.0开始,DIL已弃用这些重复的方法和元素,建议您使用ECID版本。

例如:

  • 在使用DIL.create时,某些元素已被弃用,您应该改用ECID元素。 这些元素在DIL.create 文档中调用。
  • idSync实例级方法也已弃用,方法的文档中已经调用了该方法。

ID与客户ID同步 id-syncing-with-a-customer-id

在AAM中,您可以将计算机上的UUID(匿名唯一用户ID)与客户ID同步,以便您可以上传有关该客户的离线数据,并将其与其在线行为相关联,从而更好地了解您的客户。 在过去,这是以两种方式之一完成的:

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

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

快速提示: ​以前使用上述任一方法时,您引用了具有Data Source ID (又称“DPID”)的AAM Data Source。 更新到setCustomerIDs时,您需要改用AAM Data Source的“Integration Code”。 它仍指向相同的Data Source,但只是不同的标识符。 这如下面的视频中所示。

以下部分列出了根据您的实施方法更新到DIL8.0的步骤和建议:

更新至Adobe Experience Platform标记中的DIL8.0 updating-to-dil-in-experience-platform-launch

更新到DIL8.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) setCustomerIDs
  5. Publish更改。

在AdobeDTM中更新到DIL8.0 updating-to-dil-in-adobe-dtm

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

正在更新到没有AdobeTag Management解决方案的DIL8.0 additional-resources

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

非Adobe标签管理程序也是如此。 无论该标签管理解决方案中位于何处,只要有旧版本,请按照以下步骤所述将其替换为新的代码。

  1. 将您的DIL库更新到最新版本(8.0或更高版本) — 您将需要从Adobe Consulting或Adobe客户关怀部门获取最新的DIL代码,因为它当前在公共位置不可用。 然后,您只需将旧的DIL库代码替换为新的DIL库代码并转到下一步(不要现在停止,否则您将遇到问题,ha)。

  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) setCustomerIDs

      文档

recommendation-more-help
468cbaa0-07ce-4354-9a38-4f23b645a466