Show Menu
TEMAS×

Integración con la administración dinámica de etiquetas de Adobe

Integre la administración dinámica de etiquetas de Adobe con AEM para que pueda utilizar las propiedades web de la administración dinámica de etiquetas para realizar un seguimiento de los sitios de AEM. La administración dinámica de etiquetas permite a los especialistas en marketing administrar etiquetas para recopilar datos y distribuir datos entre sistemas de marketing digital. Por ejemplo, utilice la administración dinámica de etiquetas 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 realizar la integración, debe crear la propiedad #Web_Properties web de la administración dinámica de etiquetas que rastrea el dominio del sitio de AEM. Las opciones de alojamiento de la propiedad web deben configurarse para que pueda configurar AEM y acceder a las bibliotecas de la administración dinámica de etiquetas.
Después de configurar la integración, los cambios en las reglas y las herramientas de implementación de la administración dinámica de etiquetas no requieren que cambie la configuración de la administración dinámica de etiquetas en AEM. Los cambios están disponibles automáticamente para AEM.
Si está utilizando la 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 la configuración de la integración con la administración dinámica de etiquetas.

Alojamiento de la administración dinámica de etiquetas

AEM admite la administración dinámica de etiquetas que se aloja en la nube o en AEM.
  • Alojado en la nube: Las bibliotecas de javascript de la administración dinámica de etiquetas se almacenan en la nube y las páginas de AEM hacen referencia a ellas directamente.
  • AEM alojado: La administración dinámica de etiquetas 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 sobre las opciones de alojamiento, consulte Alojamiento: Ficha Insertar en la Ayuda de la administración dinámica de etiquetas.

Biblioteca de ensayo y producción

Decida si la instancia de creación de AEM utiliza el código de producción o ensayo de la administración dinámica de etiquetas.
Normalmente, la instancia de autor utiliza las bibliotecas de ensayo de la administración dinámica de etiquetas y la instancia de producción utiliza las bibliotecas de producción. Este escenario le permite utilizar la instancia de autor para probar las configuraciones de la administración dinámica de etiquetas no aprobadas.
Si lo desea, la instancia de creación puede utilizar las bibliotecas de producción. Los complementos del explorador Web están disponibles y permiten cambiar entre el uso de bibliotecas de ensayo para fines de prueba cuando las bibliotecas están alojadas en la nube.

Uso del enlace de implementación de la administración dinámica de etiquetas

Cuando AEM aloja las bibliotecas de la administración dinámica de etiquetas, puede utilizar el servicio de enlace de implementación de la administración dinámica de etiquetas 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 la administración dinámica de etiquetas.
Para utilizar el enlace de implementación, la administración dinámica de etiquetas debe poder conectarse a la instancia de AEM que aloja las bibliotecas. Debe habilitar el acceso a AEM para los servidores de administración dinámica de etiquetas.
En algunas circunstancias, AEM puede no estar disponible, como cuando AEM se encuentra detrás de un servidor de seguridad. En estos casos, puede utilizar la opción Importador de encuestas de AEM para recuperar periódicamente las bibliotecas. Una expresión de trabajo cron dicta la programación de descargas de biblioteca.

Habilitación del acceso para el servicio de enlace de implementación

Active el servicio de enlace de implementación de la administración dinámica de etiquetas para acceder a AEM y que el servicio pueda actualizar las bibliotecas alojadas en AEM. Especifique la dirección IP de los servidores de administración dinámica de etiquetas 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
Perform the configuration using either the Web Console or a sling:OsgiConfig node:
  • En la consola web, utilice el elemento de configuración del enlace de implementación de Adobe DTM en la página de 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
OSGi, propiedad
Descripción
Lista de blanco de DTM de ensayo
dtm.staging.ip.whitelist
La dirección IP del servidor de administración dinámica de etiquetas que actualiza las bibliotecas de ensayo.
Lista de blancos de DTM de producción
dtm.production.ip.whitelist
La dirección IP del servidor de administración dinámica de etiquetas que actualiza las bibliotecas de producción.

Creación de la configuración de la administración dinámica de etiquetas

Cree una configuración de nube para que la instancia de AEM pueda autenticarse con la administración dinámica de etiquetas e interactuar con la propiedad web.
Evite la inclusión de dos códigos de seguimiento de Adobe Analytics en las páginas cuando la propiedad web de la DTM incluya la herramienta Adobe Analytics y también utilice Content Insight . En la 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 la cuenta de usuario de la administración dinámica de etiquetas. AEM utiliza esta propiedad para autenticarse con la administración dinámica de etiquetas.
Empresa Empresa con la que está asociada su ID de inicio de sesión.
Propiedad Nombre de la propiedad web que ha creado para administrar las etiquetas de su sitio de AEM.
Incluir el código de producción en el campo Autor
Seleccione esta opción para que las instancias de publicación y creación de AEM utilicen la versión de producción de las bibliotecas de la administración dinámica de etiquetas.
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 autoalojamiento: ensayo y producción

Las siguientes propiedades de la configuración de la administración dinámica de etiquetas permiten a AEM alojar las bibliotecas de la administración dinámica de etiquetas. Las propiedades permiten que AEM descargue e instale las bibliotecas. Opcionalmente, puede actualizar automáticamente las bibliotecas para asegurarse de que reflejan los cambios realizados en la aplicación de administración dinámica de etiquetas.
Algunas propiedades utilizan valores que se obtienen de la sección Descarga de biblioteca de la ficha Incrustar de la propiedad web de la administración dinámica de etiquetas. Para obtener más información, consulte Descarga de biblioteca en la Ayuda de la administración dinámica de etiquetas.
Cuando aloja el paquete de administración dinámica de etiquetas en AEM, la descarga de biblioteca debe habilitarse en la administración dinámica de etiquetas 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 la administración dinámica de etiquetas 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 cuándo aloja el archivo de biblioteca de la administración dinámica de etiquetas 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 administración dinámica de etiquetas. Obtenga este valor en la sección Descargar direcciones URL de la página Descarga de biblioteca de la administración dinámica de etiquetas. Por motivos de seguridad, este valor debe configurarse manualmente.
Flujo de trabajo de descarga
El modelo de flujo de trabajo que se va a utilizar para descargar e instalar la biblioteca de la administración dinámica de etiquetas. El modelo predeterminado es Descargar paquete DTM predeterminado. 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 al descargarlas.
Sugerencia de dominio
(Opcional) Dominio del servidor AEM que aloja la biblioteca de la administración dinámica de etiquetas. Especifique un valor para anular el dominio predeterminado configurado para el servicio Externalizador de vínculos de CQ diarios.
Cuando se conecta a la administración dinámica de etiquetas, 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 la administración dinámica de etiquetas.
Sugerencia de dominio seguro
(Opcional) Dominio del servidor AEM que aloja la biblioteca de la administración dinámica de etiquetas a través de HTTPS. Especifique un valor para anular el dominio predeterminado configurado para el servicio Externalizador de vínculos de CQ diarios.
Cuando se conecta a la administración dinámica de etiquetas, 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 la administración dinámica de etiquetas.
Secreto compartido
(Opcional) El secreto compartido que se usará para descifrar la descarga. Obtenga este valor en el campo Shared Secret de la página Descarga de biblioteca de la administración dinámica de etiquetas.
Nota: Debe tener instaladas las bibliotecas OpenSSL en el equipo en el que AEM está instalado para que AEM pueda descifrar las bibliotecas descargadas.
Habilitar el importador de encuestas
(Opcional) Seleccione esta opción para descargar e instalar periódicamente la biblioteca de administración dinámica de etiquetas para asegurarse de que está utilizando una versión actualizada. Si se selecciona, la administración dinámica de etiquetas no envía solicitudes HTTP POST a la URL de enlace de implementación.
AEM configura automáticamente la propiedad URL de enlace de implementación de las propiedades de descarga de biblioteca para la propiedad web de administración dinámica de etiquetas. 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 la administración dinámica de etiquetas.
Activar el importador de encuestas cuando el enlace de implementación de la administración dinámica de etiquetas no se pueda conectar a AEM, por ejemplo cuando AEM esté detrás de un servidor de seguridad.
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 administración dinámica de etiquetas.

Propiedades del alojamiento en la nube: ensayo y producción

Las siguientes propiedades se configuran para la administración dinámica de etiquetas cuando la configuración dinámica de etiquetas está alojada en la nube.
Propiedad Descripción
Utilizar el alojamiento propio Borre esta opción cuando el archivo de biblioteca de la administración dinámica de etiquetas esté alojado en la nube.
Código de encabezado
Código de encabezado para ensayo que se obtiene de la administración dinámica de etiquetas para el host. Este valor se rellena automáticamente al conectarse a la administración dinámica de etiquetas.
Para ver el código en la administración dinámica de etiquetas, haga clic en la ficha Insertar y, a continuación, haga clic en el nombre del 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
Código de pie de página para ensayo que se obtiene de la administración dinámica de etiquetas para el host. Este valor se rellena automáticamente al conectarse a la administración dinámica de etiquetas.
Para ver el código en la administración dinámica de etiquetas, haga clic en la ficha Insertar y, a continuación, haga clic en el nombre del 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.
El siguiente procedimiento utiliza la IU táctil para configurar la integración con la administración dinámica de etiquetas.
  1. En el carril, haga clic en Herramientas > Operaciones > Nube > Servicios de nube.
  2. En el área Administración dinámica de etiquetas, aparece uno de los vínculos siguientes 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 + junto a Configuraciones disponibles si se han creado una o más configuraciones.
  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 la cuenta de usuario de la administración dinámica de etiquetas.
    Para obtener el valor del testigo de API, póngase en contacto con DTM Client Care.
    El token de API no caduca hasta que el usuario de la administración dinámica de etiquetas lo solicite explícitamente.
  5. Haga clic en Conectar a DTM. AEM se autentica con la administración dinámica de etiquetas y recupera la lista de empresas con 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 está utilizando código de ensayo en la instancia de autor, anule la selección de Incluir código de producción al autor.
  8. Proporcione valores para las propiedades en la ficha Ajustes de ensayo y en la ficha Ajustes de producción, si es necesario, y haga clic en Aceptar.

Descarga manual de la biblioteca de administración dinámica de etiquetas

Descargue manualmente las bibliotecas de la administración dinámica de etiquetas para actualizarlas inmediatamente en AEM. Por ejemplo, descargue manualmente cuando desee probar una biblioteca actualizada antes de que el importador de encuestas tenga programado descargar automáticamente la biblioteca.
  1. En el carril, haga clic en Herramientas > Operaciones > Nube > Servicios de nube.
  2. En el área Administración dinámica de etiquetas, haga clic en Mostrar configuraciones y, a continuación, haga clic en su configuración.
  3. En el área Ajustes de ensayo o en el área Ajustes de producción, haga clic en el botón Activar flujo de trabajo de descarga para descargar e implementar el paquete de biblioteca.
Los archivos descargados se almacenan en /etc/clientlibs/dtm/my config/companyID/propertyID/servertype .
Los siguientes datos se toman directamente de la configuración de la DTM.
  • myconfig
  • companyID
  • propertyID
  • servertype

Asociación de una configuración de administración dinámica de etiquetas con el sitio

Asocie la configuración de la administración dinámica de etiquetas con las páginas del sitio web para que AEM añada 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 de descendientes.
Utilice el procedimiento siguiente para asociar una página y los descendientes con una configuración de la administración dinámica de etiquetas.
  1. Abra la página raíz del sitio en la IU clásica.
  2. Utilice la barra de tareas para abrir las propiedades de la página.
  3. En la ficha Servicios de nube, haga clic en Agregar servicio, seleccione Administración dinámica de etiquetas y, a continuación, haga clic en Aceptar.
  4. Utilice el menú desplegable Administración dinámica de etiquetas 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 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 Servicios de nube, 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.
  4. Elimine o seleccione una configuración de Administración dinámica de etiquetas diferente y, a continuación, haga clic en Aceptar.