Integración con Adobe Dynamic Tag Management integrating-with-adobe-dynamic-tag-management

Integre Adobe Dynamic Tag Management con AEM para que pueda usar sus propiedades web de Dynamic Tag Management para rastrear sitios de AEM. Dynamic Tag Management permite a los especialistas en marketing administrar etiquetas para recopilar datos y distribuir datos entre sistemas de marketing digital. Por ejemplo, utilice Dynamic Tag Management para recopilar datos de uso para su sitio web de AEM y distribuir los datos para su análisis en Adobe Analytics o Adobe Target.

Antes de realizar la integración, cree la propiedad web de Dynamic Tag Management que realiza el seguimiento del dominio del sitio de AEM. Las opciones de alojamiento de la propiedad web deben estar configuradas 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.

NOTE
Si utiliza DTM con una configuración proxy personalizada, configure 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 deployment-options

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

Alojamiento de Dynamic Tag Management dynamic-tag-management-hosting

AEM es compatible con Dynamic Tag Management alojado en la nube o en AEM.

  • Alojado en la nube: las bibliotecas de Dynamic Tag Management JavaScript se almacenan en la nube y las páginas de AEM hacen referencia a ellas directamente.
  • Alojado en AEM: 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 la implementación determina algunas de las tareas de configuración e implementación que realiza. Para obtener información acerca de las opciones de alojamiento, consulte Alojamiento: ficha Insertar en la Ayuda de Dynamic Tag Management.

Biblioteca de ensayo y producción staging-and-production-library

Decida si la instancia de autor de AEM utiliza el código de ensayo o 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 utiliza 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. Hay disponibles complementos de explorador web que permiten cambiar entre el uso de bibliotecas de ensayo para realizar pruebas cuando las bibliotecas están alojadas en la nube.

Uso del vínculo de implementación de Dynamic Tag Management using-the-dynamic-tag-management-deployment-hook

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 la biblioteca en AEM. Las actualizaciones de la 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. Habilite el 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 del importador de encuestas de AEM para recuperar periódicamente las bibliotecas. Una expresión de trabajo cron dicta la programación de las descargas de biblioteca.

Habilitar el acceso al servicio de enlace de implementación enabling-access-for-the-deployment-hook-service

Habilite el servicio de enlace de implementación de Dynamic Tag Management para acceder a AEM y 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 mediante la consola web o un nodo sling:OsgiConfig:

  • En la consola web, utilice el elemento Configuración del vínculo de implementación de Adobe DTM 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 deben 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 creating-the-dynamic-tag-management-configuration

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

NOTE
Evite la inclusión de dos códigos de seguimiento de Adobe Analytics en sus páginas cuando su propiedad web de DTM incluya la herramienta Adobe Analytics y también esté usando Content Insight. En su configuración de Adobe Analytics Cloud, seleccione la opción No incluir código de seguimiento.

Configuración general general-settings

Propiedad
Descripción
Token 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
La empresa con la que está asociado su ID de inicio de sesión.
Propiedad
Nombre de la propiedad web que ha creado para administrar las etiquetas del sitio de AEM.
Incluir el código de producción en el campo Autor

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

Cuando esta opción no está seleccionada, 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 self-hosting-properties-staging-and-production

Las siguientes propiedades de la configuración de Dynamic Tag Management permiten a 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 Dynamic Tag Management.

Algunas propiedades utilizan valores que se obtienen de la sección Descarga de biblioteca de la pestaña Insertar para la propiedad web de Dynamic Tag Management. Para obtener más información, consulte Descarga de biblioteca en la Ayuda de Dynamic Tag Management.

NOTE
Cuando aloja el paquete Dynamic Tag Management en AEM, la descarga de la biblioteca debe estar habilitada en Dynamic Tag Management antes de crear la configuración. Además, Akamai debe estar habilitado, ya que 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 la configuración. Consulte las descripciones de la tabla siguiente.

Propiedad
Descripción
Utilizar el alojamiento propio
Seleccione cuando aloje 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
Dirección URL que se utilizará para descargar la biblioteca de Dynamic Tag Management. Obtenga este valor de la sección Descargar direcciones 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 del paquete DTM predeterminado. Utilice este modelo a menos que haya creado uno personalizado.

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 que pueda anular el dominio predeterminado configurado para el servicio Day CQ Link Externalizer.

Cuando se conecta 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 de 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 que pueda anular el dominio predeterminado configurado para el servicio Day CQ Link Externalizer.

Cuando se conecta 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 de la propiedad web de Dynamic Tag Management.

Secreto compartido

(Opcional) 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 instaladas las bibliotecas OpenSSL en el equipo donde está instalado AEM para que AEM pueda descifrar las bibliotecas descargadas.

Habilitar el importador de encuestas

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

AEM configura automáticamente la propiedad Implementar URL de vínculo de las propiedades de Descarga de biblioteca para la propiedad web de Dynamic Tag Management. Cuando se selecciona, la propiedad se configura sin valor. Cuando 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 pueda conectarse a AEM, por ejemplo, cuando AEM esté detrás de un cortafuegos.

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

chlimage_1-352

Propiedades de alojamiento en la nube: ensayo y producción cloud-hosting-properties-staging-and-production

Configure las siguientes propiedades para la configuración de Dynamic Tag Management cuando Dynamic Tag Configuration está alojada en la nube.

Propiedad
Descripción
Utilizar el alojamiento propio
Desactive 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 el 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 pestaña 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 del 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 el 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 pestaña 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 del código incrustado de producción según sea necesario.

chlimage_1-353

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

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

  2. En el área de Dynamic Tag Management, 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 agrega.
    • 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 varias 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.

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

    chlimage_1-355

  5. Haga clic en Conectarse 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 de AEM.

  7. Si utiliza código de ensayo en la instancia de autor, anule la selección de Incluir código de producción en Author.

  8. Proporcione valores para las propiedades de las pestañas Configuración de ensayo y 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 manually-downloading-the-dynamic-tag-management-library

Descargue manualmente las bibliotecas de Dynamic Tag Management para actualizarlas inmediatamente en AEM. Por ejemplo, realice la descarga manual si 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 > Cloud > Cloud Services.

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

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

    chlimage_1-356

NOTE
Los archivos descargados se almacenan en /etc/clientlibs/dtm/my config/companyID/propertyID/servertype.
Las siguientes se toman directamente de la configuración de DTM.
  • myconfig
  • companyID
  • propertyID
  • servertype

Asociación de una configuración de Dynamic Tag Management al sitio associating-a-dynamic-tag-management-configuration-with-your-site

Asocie la configuración de Dynamic Tag Management con las páginas del sitio web para que AEM añada el script necesario 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 sus descendientes a una configuración de Dynamic Tag Management.

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

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

  3. En la pestaña 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 Dynamic Tag Management 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 de una página. La anulación afecta a la página y a todos sus descendientes.

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

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

  3. En la pestaña Cloud Services, haga clic en el icono de candado 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 una configuración de Dynamic Tag Management diferente y, a continuación, haga clic en Aceptar.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2