Actualización a la versión 8.0 (o buena) del DIL de Adobe Audience Manager

Este artículo le proporcionará pasos y recomendaciones para actualizar el código Adobe Audience Manager (AAM) Data Integration Library (DIL) a la versión 8.0 o posterior. Esto se refiere a la implementación de DIL del "lado del cliente", no al reenvío de datos de Adobe Analytics del lado del servidor, y abarca DTM, Launch by Adobe e implementaciones sin solución de administración de etiquetas de Adobe.

Información general

El código Data Integration Library (DIL) del Audience Manager le permite implementar AAM en el sitio web*. Al implementar versiones anteriores de DIL, no era necesario tener implementado también el Servicio de ID de Experience Cloud (ECID) de Adobe (aunque era una buena idea). A partir de la versión 8.0 de DIL, existe una fuerte dependencia de la versión 3.3 o posterior de ECID. Si implementa DIL 8.0 o posterior sin ECID 3.3, o con una versión anterior, obtendrá un error y no funcionará. Dado que hay varias formas de implementar AAM, hemos creado esta página para darle algunos pasos a seguir, así como algunas recomendaciones. A continuación, encontrará estos pasos y recomendaciones desglosados por plataforma/método de implementación. Encontrará más información sobre el DIL en la documentación.

  • Como se indica en la descripción de esta página, esto solo cubre las implementaciones de DIL del lado del cliente, que utilizan los clientes AAM que no tienen Adobe Analytics. Si tiene Adobe Analytics, debe utilizar el método de reenvío del lado del servidor para implementar AAM. Este método se describe en la documentación.

Duplicar y desaprobar elementos y métodos

En versiones anteriores de DIL y ECID, había métodos duplicados (métodos que hacen la misma función tanto en el DIL como en el ECID), lo que causaba confusión sobre cuál utilizar. Normalmente, necesitaba usar ambos y hacerlos coincidir, y ese mensaje no se comunicó bien a nuestros clientes. A partir de DIL 8.0, estos métodos y elementos duplicados han quedado obsoletos en DIL y se recomienda utilizar la versión de ECID.

Por ejemplo:

  • Al utilizar DIL.create, se han desaprobado algunos elementos y en su lugar debe utilizar los elementos ECID. Estos elementos se describen en la DIL.create documentación.
  • El método de nivel de instancia idSync también se ha desaprobado, como se indica en la documentación del método.

Sincronización de ID con un ID de cliente

En AAM, puede sincronizar su UUID (ID de usuario único anónimo) en el equipo con un ID de cliente, de modo que pueda cargar datos sin conexión sobre ese cliente y vincularlos con su comportamiento en línea, para comprender mejor a sus clientes. En el pasado, esto se ha hecho de una de dos maneras:

  • El método de nivel de instancia idSync
  • El elemento declaredId en DIL.create

Si ha utilizado cualquiera de estos métodos antiguos para sincronizar con un ID de cliente, es muy recomendable actualizar a mediante el método setCustomerIDs, que forma parte del servicio ECID. Encontrará más información sobre setCustomerIDs en la documentación del método.

Sugerencia rápida: Cuando anteriormente se utilizaban cualquiera de los métodos anteriores, se hacía referencia a la AAM Data Source con el Data Source ID (también conocido como "DPID"). Al actualizar a setCustomerIDs, tendrá que utilizar en su lugar "Integration Code" de la AAM Data Source. Sigue apuntando al mismo Data Source pero es solo un identificador diferente. Esto se muestra en el siguiente vídeo.

En las secciones siguientes se enumeran los pasos y recomendaciones para actualizar a DIL 8.0 según el método de implementación:

Actualización al DIL 8.0 en Adobe Experience Platform Launch

Pasos básicos para la actualización a DIL 8.0

  1. Si utiliza el DIL anterior a la versión 8.0, antes de actualizar, vaya a la configuración del DIL en la extensión de AAM y tome nota de las opciones avanzadas que esté utilizando (para utilizarlas en un paso posterior).

  2. Actualizar la extensión de AAM a la versión 8.0 o buenas

  3. Compruebe que la extensión del servicio de ID de Experience Cloud sea de la versión 3.3.0 o buena

  4. Para cualquier método o elemento obsoleto (como "disableIDSyncs") que se encuentre en la extensión de AAM anterior a la versión 8.0 o en el código personalizado para el DIL, habilite los métodos ECID en la extensión ECID.

    1. (DIL) disableDestinationPublishingIframe -> (ECID) disableIdSyncs
    2. (DIL) disableIDSyncs -> (ECID) disableIdSyncs
    3. (DIL) iframeAkamaiHTTPS -> (ECID) dSyncSSLUseAkamai
    4. (DIL) declarationId -> (ECID) setCustomerIDs
  5. Publicar los cambios

Actualización al DIL 8.0 en la DTM de Adobe

  1. Actualice la herramienta AAM a la versión 8.0 o buenas. Esta configuración de versión se encuentra en la sección "General" de la herramienta AAM.
  2. Para cualquier método o elemento obsoleto (como "disableIDSyncs") que se encuentre en el código personalizado de su herramienta de AAM anterior a la versión 8.0 para el DIL, tenga en cuenta estos métodos (de modo que pueda agregarlos a la herramienta ECID) y, a continuación, elimínelos del DIL code personalizado en la herramienta de AAM.
  3. Actualizar la extensión del servicio de ID de Experience Cloud a la versión 3.3.0 o buena
  4. Agregue las opciones avanzadas a la herramienta ECID que ha eliminado del código personalizado de la herramienta AAM.
  5. Publicar los cambios

Actualización al DIL 8.0 sin solución de administración de etiquetas de Adobe

Si está actualizando el código directamente en la página, puede reemplazar los elementos antiguos por elementos más nuevos, excepto cuando necesite mover métodos/elementos de DIL a ECID, como se ha explicado anteriormente. En ese caso, simplemente reemplazará el método/elemento antiguo en la ubicación del DIL por el método/elemento ECID en la ubicación ECID.

Lo mismo sucede con los administradores de etiquetas que no son de Adobe. Siempre que tenga las versiones anteriores en esa solución de administración de etiquetas, sustitúyalas por el nuevo código tal como se describe en los pasos siguientes.

  1. Actualice la biblioteca de DIL a la versión más reciente (8.0 o buena). Deberá obtener el código de DIL más reciente de la asesoría de Adobe o del Servicio de atención al cliente de Adobe, ya que actualmente no está disponible en una ubicación pública. A continuación, reemplace el antiguo código de biblioteca del DIL por el nuevo código de biblioteca del DIL y continúe con el siguiente paso (no se detenga ahora o tendrá problemas, ja).

  2. Instale ECID Service o actualice la versión existente a 3.3.0 o buena. Puede descargar la versión más reciente del servicio de ID de Experience Cloud desde nuestra página de GitHub. Si necesita ayuda con esto, consulte la documentación o hable con un consultor de Adobe.

  3. Compruebe que cualquier método o elemento obsoleto que se encuentre en el código personalizado para el DIL se mueva a los métodos ECID:

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

      Documentación

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

      Documentación

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

      Documentación

    4. (DIL) declarationId -> (ECID) setCustomerIDs

      Documentación

En esta página