Integración con Adobe Dynamic Tag Management

Última actualización: 2023-05-05
  • Creado para:
  • Admin
PRECAUCIÓN

AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Integrar Adobe Dynamic Tag Management con AEM para poder usar las propiedades web de Dynamic Tag Management para realizar el seguimiento de AEM sitios. Dynamic Tag Management permite a los especialistas en marketing administrar etiquetas para recopilar datos y distribuir datos entre sistemas de marketing digital. Por ejemplo, use Dynamic Tag Management para recopilar datos de uso del sitio web de AEM y distribuir los datos para su análisis en Adobe Analytics o Adobe Target.

Antes de la integración, debe crear el Tag Management dinámico propiedad web que rastrea el dominio del sitio AEM. La variable opciones de alojamiento de la propiedad web debe configurarse para que pueda configurar AEM para acceder a las bibliotecas de Dynamic Tag Management.

Después de configurar la integración, los cambios en las herramientas y reglas de implementación de Dynamic Tag Management no requieren que cambie la configuración de Dynamic Tag Management en AEM. Los cambios están disponibles automáticamente para AEM.

NOTA

Si utiliza DTM con una configuración proxy personalizada, debe configurar ambas configuraciones proxy del cliente HTTP, ya que algunas funcionalidades de AEM utilizan las API 3.x y otras las API 4.x:

Opciones de implementación

Las siguientes opciones de implementación afectan a la configuración de la integración con Dynamic Tag Management.

Alojamiento dinámico de Tag Management

AEM admite Dynamic Tag Management alojado en la nube o en AEM.

  • Alojado en la nube: Las bibliotecas javascript de Dynamic Tag Management se almacenan en la nube y las páginas AEM hacen referencia a ellas directamente.
  • AEM alojados: Dynamic Tag Management genera bibliotecas de javascript. AEM utiliza un modelo de flujo de trabajo para obtener e instalar las bibliotecas.

El tipo de alojamiento que utiliza su implementación determina algunas de las tareas de configuración e implementación que realiza. Para obtener información sobre las opciones de alojamiento, consulte Alojamiento: Ficha Insertar en la Ayuda de Dynamic Tag Management.

Biblioteca de ensayo y producción

Decida si la instancia de autor de AEM utiliza el ensayo o el código de producción de Dynamic Tag Management.

Normalmente, la instancia de autor utiliza las bibliotecas de ensayo de Dynamic Tag Management y la instancia de producción las bibliotecas de producción. Este escenario le permite utilizar la instancia de autor para probar configuraciones de Dynamic Tag Management no aprobadas.

Si lo desea, la instancia de autor puede utilizar las bibliotecas de producción. Los complementos del explorador web están disponibles y permiten alternar entre el uso de bibliotecas de ensayo para realizar pruebas cuando las bibliotecas están alojadas en la nube.

Uso del enlace de implementación de Dynamic Tag Management

Cuando AEM aloja las bibliotecas de Dynamic Tag Management, puede utilizar el servicio de enlace de implementación de Dynamic Tag Management para insertar automáticamente las actualizaciones de biblioteca en AEM. Las actualizaciones de biblioteca se insertan cuando se realizan cambios en las bibliotecas, como cuando se editan las propiedades web de Dynamic Tag Management.

Para utilizar el vínculo de implementación, Dynamic Tag Management debe poder conectarse a la instancia de AEM que aloja las bibliotecas. Debe habilitar acceso a AEM para los servidores de Dynamic Tag Management.

En algunas circunstancias, AEM puede ser inaccesible, como cuando AEM se encuentra detrás de un cortafuegos. En estos casos, puede utilizar la opción AEM importador de encuestas para recuperar periódicamente las bibliotecas. Una expresión de trabajo cron dicta la programación de descargas de biblioteca.

Habilitar el acceso para el servicio de enlace de implementación

Habilite el servicio de enlace de implementación de Dynamic Tag Management para acceder a AEM de modo que el servicio pueda actualizar las bibliotecas alojadas en AEM. Especifique la dirección IP de los servidores de Dynamic Tag Management que actualizan las bibliotecas de ensayo y producción según sea necesario:

  • Ensayo: 107.21.99.31
  • Producción: 23.23.225.112 y 204.236.240.48

Realice la configuración utilizando la variable Consola web o sling:OsgiConfig nodo:

  • En la consola web, utilice el elemento Configuración de enlace de implementación de DTM de Adobe en la página Configuración .
  • Para una configuración OSGi, el PID de servicio es com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet.

En la tabla siguiente se describen las propiedades que se van a configurar.

Propiedad de la consola web Propiedad OSGi Descripción
Lista blanca de IP de DTM de ensayo dtm.staging.ip.whitelist La dirección IP del servidor de Dynamic Tag Management que actualiza las bibliotecas de ensayo.
Lista blanca de IP de DTM de producción dtm.production.ip.whitelist La dirección IP del servidor de Dynamic Tag Management que actualiza las bibliotecas de producción.

Creación de la configuración de Dynamic Tag Management

Cree una configuración de nube para que la instancia de AEM pueda autenticarse con Dynamic Tag Management e interactuar con la propiedad web.

NOTA

Evite la inclusión de dos códigos de seguimiento de Adobe Analytics en las páginas cuando la propiedad web de DTM incluya la herramienta Adobe Analytics y también esté utilizando Perspectiva de contenido. En Configuración de nube de Adobe Analytics, seleccione la opción No incluir código de seguimiento .

Configuración general

Propiedad Descripción
Testigo API El valor de la propiedad Token de API de su cuenta de usuario de Dynamic Tag Management. AEM utiliza esta propiedad para autenticarse con Dynamic Tag Management.
Compañía Empresa con la que está asociado su ID de inicio de sesión.
Propiedad Nombre de la propiedad web que creó para administrar las etiquetas de su sitio AEM.
Incluir el código de producción en el campo Autor

Seleccione esta opción para que las instancias de publicación y autor de AEM utilicen la versión de producción de las bibliotecas de Dynamic Tag Management.

Cuando no se selecciona esta opción, la configuración de ensayo se aplica a la instancia de autor y la configuración de producción se aplica a la instancia de publicación.

Propiedades de alojamiento propio: ensayo y producción

Las siguientes propiedades de la configuración de Dynamic Tag Management permiten AEM alojar las bibliotecas de Dynamic Tag Management. Las propiedades permiten a AEM descargar e instalar las bibliotecas. De forma opcional, puede actualizar automáticamente las bibliotecas para asegurarse de que reflejen los cambios realizados en la aplicación de administración dinámica de Tag Management.

Algunas propiedades utilizan valores que se obtienen de la sección Descarga de biblioteca de la ficha Incrustar de la propiedad web de Dynamic Tag Management. Para obtener más información, consulte Descarga de bibliotecas en la Ayuda de Dynamic Tag Management.

NOTA

Cuando aloja el paquete de Dynamic Tag Management en AEM, la descarga de biblioteca debe estar habilitada en Dynamic Tag Management antes de crear la configuración. Además, Akamai debe estar habilitado porque Akamai proporciona las bibliotecas para la descarga.

Al alojar las bibliotecas de Dynamic Tag Management en AEM, AEM configura automáticamente algunas propiedades de la propiedad web según su configuración. Consulte las descripciones de la tabla siguiente.

Propiedad Descripción
Usar el alojamiento propio Seleccione cuándo aloja el archivo de biblioteca de Dynamic Tag Management en AEM. Si selecciona esta opción, aparecerán las demás propiedades de esta tabla.
URL del paquete DTM La URL que se utilizará para descargar la biblioteca de Dynamic Tag Management. Obtenga este valor en la sección Descargar URL de la página Descarga de biblioteca de Dynamic Tag Management. Por motivos de seguridad, este valor debe configurarse manualmente.
Flujo de trabajo de descarga

Modelo de flujo de trabajo que se utiliza para descargar e instalar la biblioteca de Dynamic Tag Management. El modelo predeterminado es Descarga de paquete DTM predeterminada. Utilice este modelo a menos que haya creado un modelo personalizado.

Tenga en cuenta que el flujo de trabajo de descarga predeterminado activa automáticamente las bibliotecas cuando se descargan.

Sugerencia de dominio

(Opcional) Dominio del servidor de AEM que aloja la biblioteca de Dynamic Tag Management. Especifique un valor para anular el dominio predeterminado configurado para la variable Servicio Externalizador de vínculos de CQ de día.

Cuando está conectado a Dynamic Tag Management, AEM utiliza este valor para configurar la ruta HTTP de ensayo o la ruta HTTP de producción de las propiedades de descarga de biblioteca para la propiedad web de Dynamic Tag Management.

Sugerencia de dominio seguro

(Opcional) Dominio del servidor de AEM que aloja la biblioteca de Dynamic Tag Management a través de HTTPS. Especifique un valor para anular el dominio predeterminado configurado para la variable Servicio Externalizador de vínculos de CQ de día.

Cuando está conectado a Dynamic Tag Management, AEM utiliza este valor para configurar la ruta HTTPS de ensayo o la ruta HTTPS de producción de las propiedades de descarga de biblioteca para la propiedad web de Dynamic Tag Management.

Secreto compartido

(Opcional) El secreto compartido que se utilizará para descifrar la descarga. Obtenga este valor del campo Secreto compartido de la página Descarga de biblioteca de Dynamic Tag Management.

Nota: Debe tener la variable OpenSSL bibliotecas instaladas en el equipo en el que AEM está instalado para que AEM descifrar las bibliotecas descargadas.

Habilitar el importador de encuestas

(Opcional) Seleccione para descargar e instalar periódicamente la biblioteca de Dynamic Tag Management para asegurarse de que está utilizando una versión actualizada. Cuando está seleccionado, Dynamic Tag Management no envía solicitudes de POST HTTP a la URL de enlace de implementación.

AEM configura automáticamente la propiedad Deploy Hook URL de las propiedades de descarga de biblioteca para la propiedad web de Dynamic Tag Management. Cuando se selecciona, la propiedad se configura sin valor. Si no se selecciona, la propiedad se configura con la dirección URL de la configuración de Dynamic Tag Management.

Habilite el importador de encuestas cuando el vínculo de implementación de Dynamic Tag Management no se pueda conectar a AEM, por ejemplo cuando AEM está detrás de un cortafuegos.

Expresión de programación (Aparece y es obligatorio cuando se selecciona Habilitar importador de encuestas ). Expresión cron que controla cuándo se descargan las bibliotecas de Dynamic Tag Management.

chlimage_1-352

Propiedades de alojamiento de nube: ensayo y producción

Puede configurar las siguientes propiedades para la configuración de Dynamic Tag Management cuando la Configuración dinámica de etiquetas está alojada en la nube.

Propiedad Descripción
Usar el alojamiento propio Borre esta opción cuando el archivo de biblioteca de Dynamic Tag Management esté alojado en la nube.
Código de encabezado

El código de Encabezado para Ensayo que se obtiene de Dynamic Tag Management para su host. Este valor se rellena automáticamente al conectarse a Dynamic Tag Management.

Para ver el código en Dynamic Tag Management, haga clic en la ficha Insertar y, a continuación, haga clic en el nombre de host. Expanda la sección Código de encabezado y haga clic en el área Copiar código incrustado del código incrustado de ensayo o el área Código incrustado de producción según sea necesario.

Código de pie de página

El código de pie de página para ensayo que se obtiene de Tag Management dinámico para el host. Este valor se rellena automáticamente al conectarse a Dynamic Tag Management.

Para ver el código en Dynamic Tag Management, haga clic en la ficha Insertar y, a continuación, haga clic en el nombre de host. Expanda la sección Código de pie de página y haga clic en el área Copiar código incrustado del código incrustado de ensayo o el área Código incrustado de producción según sea necesario.

chlimage_1-353

El siguiente procedimiento utiliza la IU táctil para configurar la integración con Dynamic Tag Management.

  1. En el carril , haga clic en Herramientas > Operaciones > Nube > Cloud Services.

  2. En el área Tag Management dinámico, aparece uno de los siguientes vínculos para agregar una configuración:

    • Haga clic en Configurar ahora si esta es la primera configuración que está agregando.
    • Haga clic en Mostrar configuraciones y, a continuación, haga clic en el vínculo + situado junto a Configuraciones disponibles si se han creado una o más configuraciones.

    chlimage_1-354

  3. Escriba un título para la configuración y haga clic en Crear.

  4. En el campo Token de API , introduzca el valor de la propiedad Token de API de su cuenta de usuario de Dynamic Tag Management.

    Para obtener el valor de su token de API, póngase en contacto con el servicio de atención al cliente de DTM.

    NOTA

    El token de API no caduca hasta que el usuario de Dynamic Tag Management lo solicite explícitamente.

    chlimage_1-355

  5. Haga clic en Conectar a DTM. AEM se autentica con Dynamic Tag Management y recupera la lista de empresas a las que está asociada su cuenta.

  6. Seleccione la empresa y, a continuación, seleccione la propiedad que está utilizando para realizar el seguimiento del sitio AEM.

  7. Si está utilizando código de ensayo en la instancia de autor, anule la selección de Incluir código de producción en autor.

  8. Proporcione valores para las propiedades en la ficha Configuración de ensayo y en la ficha Configuración de producción si es necesario y, a continuación, haga clic en Aceptar.

Descarga manual de la biblioteca de Dynamic Tag Management

Descargue manualmente las bibliotecas de Dynamic Tag Management para actualizarlas inmediatamente en AEM. Por ejemplo, descargue manualmente cuándo desea probar una biblioteca actualizada antes de que el importador de encuestas programe la descarga automática de la biblioteca.

  1. En el carril , haga clic en Herramientas > Operaciones > Nube > Cloud Services.

  2. En el área Tag Management dinámico, haga clic en Mostrar configuraciones y, a continuación, haga clic en la configuración.

  3. En el área Configuración de ensayo o en el área Configuración de producción , haga clic en el botón Flujo de trabajo de descarga de Déclencheur para descargar e implementar el paquete de biblioteca.

    chlimage_1-356

NOTA

Los archivos descargados se almacenan en /etc/clientlibs/dtm/my config/companyID/propertyID/servertype.

Los siguientes se toman directamente de su Configuración de DTM.

  • myconfig
  • companyID
  • propertyID
  • servertype

Asociación de una configuración dinámica de Tag Management con el sitio

Asocie la configuración de Dynamic Tag Management con las páginas del sitio web para AEM agregue la secuencia de comandos necesaria a las páginas. Asocie la página raíz del sitio con la configuración. Todos los descendientes de esa página heredan la asociación. Si es necesario, puede anular la asociación en una página descendiente.

Utilice el siguiente procedimiento para asociar una página y los descendientes a una configuración de Dynamic Tag Management.

  1. Abra la página raíz de su sitio en la IU clásica.

  2. Utilice la barra de tareas para abrir las propiedades de la página.

  3. En la ficha Cloud Services, haga clic en Añadir servicio, seleccione Dynamic Tag Management y, a continuación, haga clic en Aceptar.

    chlimage_1-357

  4. Utilice el menú desplegable Tag Management dinámico para seleccionar la configuración y, a continuación, haga clic en Aceptar.

Utilice el siguiente procedimiento para anular la asociación de configuración heredada para una página. La anulación afecta a la página y a todos los descendientes de la página.

  1. Abra la página en la IU clásica.

  2. Utilice la barra de tareas para abrir las propiedades de la página.

  3. En la ficha Cloud Services, haga clic en el icono de cerrojo situado junto a la propiedad Heredado de y, a continuación, haga clic en Sí en el cuadro de diálogo de confirmación.

    chlimage_1-358

  4. Elimine o seleccione otra configuración de Dynamic Tag Management y, a continuación, haga clic en Aceptar.

En esta página