Actualización a DIL versión 8.0 de Adobe Audience Manager (o superior) updating-to-adobe-audience-manager-s-dil-version-or-greater

Este artículo contiene instrucciones para actualizar el código de Adobe Audience Manager (AAM) Data Integration Library (DIL) a la versión 8.0 o posterior. Esto hace referencia a la implementación de DIL "del lado del cliente", no al reenvío de datos de Adobe Analytics del lado del servidor, y cubre DTM, Launch by Adobe e implementaciones sin la solución de administrador de etiquetas de Adobe.

Información general overview

El código Data Integration Library (DIL) de Audience Manager le permite implementar AAM en su sitio web*. Al implementar versiones anteriores de DIL, no era necesario tener implementado también el servicio Experience Cloud ID de Adobe (ECID) (aunque era una muy buena idea). A partir de la versión 8.0 de DIL, existe una dependencia estricta 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 que debe seguir, así como algunas recomendaciones. A continuación, se muestran estos pasos y recomendaciones desglosados por plataforma o método de implementación. Encontrará más información sobre 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, utilizadas por los clientes de 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.

Elementos y métodos duplicados y obsoletos duplicate-and-deprecated-elements-and-methods

En versiones anteriores de DIL y ECID, había métodos duplicados (métodos que realizan la misma función tanto en DIL como en ECID), lo que causaba confusión sobre cuál usar. Normalmente, necesitaba utilizar ambos y hacerlos coincidir, y ese mensaje no se comunicaba 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, algunos elementos han quedado obsoletos y debe utilizar los elementos ECID en su lugar. Estos elementos se llaman en la DIL.create documentación.
  • El método de nivel de instancia idSync también ha quedado obsoleto, como se llama en la documentación del método.

Sincronización de ID con un ID de cliente id-syncing-with-a-customer-id

En AAM, puede sincronizar su UUID (ID único de usuario 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 las dos maneras siguientes:

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

Si ha estado utilizando cualquiera de estos métodos antiguos para sincronizarse con un ID de cliente, se recomienda encarecidamente que actualice 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: Al usar cualquiera de los métodos anteriores, hizo referencia a la AAM Data Source con el ID Data Source (también conocido como "DPID"). Al actualizar a setCustomerIDs, tendrá que usar el "Data Source" de AAM Integration Code en su lugar. Sigue apuntando al mismo(a) Data Source, pero es solo un identificador diferente. Esto se muestra en el siguiente vídeo.

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

Actualización a DIL 8.0 en Adobe Experience Platform tags updating-to-dil-in-experience-platform-launch

Pasos básicos para actualizar a DIL 8.0

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

  2. Actualice la extensión de AAM a la versión 8.0 o superior.

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

  4. Habilite los métodos y elementos ECID en la extensión ECID para cualquier método o elemento obsoleto (como disableIDSyncs) que estuviera en la extensión AAM anterior a la 8.0 o en el código personalizado para DIL.

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

Actualización a DIL 8.0 en Adobe DTM updating-to-dil-in-adobe-dtm

  1. Actualice la herramienta AAM a la versión 8.0 o superior. 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 estuviera en el código personalizado de la herramienta AAM anterior a la versión 8.0 para DIL, anótelo (para que pueda agregarlo a la herramienta ECID) y luego elimínelo de la herramienta personalizada DIL code en la herramienta AAM.
  3. Actualice la extensión del servicio de Experience Cloud ID a la versión 3.3.0 o superior
  4. Agregue las opciones avanzadas a la herramienta ECID que eliminó del código personalizado de la herramienta AAM.
  5. Publicación de los cambios

Actualización a DIL 8.0 sin la solución Adobe Tag Management additional-resources

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

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

  1. Actualice la biblioteca de DIL a la última versión (8.0 o posterior): deberá obtener el código DIL más reciente de Adobe Consulting 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, simplemente reemplace el código de biblioteca antiguo de DIL por el nuevo código de biblioteca DIL y continúe con el siguiente paso (no se detenga ahora o tendrá problemas, ha).

  2. Instale ECID Service o actualice su versión existente a la 3.3.0 o superior. Puede descargar la versión más reciente del servicio de Experience Cloud ID 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 todos los métodos o elementos obsoletos del código personalizado de DIL se muevan 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) declaredId -> (ECID) setCustomerIDs

      Documentación

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