Show Menu
TEMAS×

Integración de visualizadores de Dynamic Media con Adobe Analytics y Adobe Launch

¿Qué es la integración de visores de Dynamic Media con Adobe Analytics y Adobe Launch?

The new Dynamic Media Viewers extension for Adobe Launch, along with the recent release of Dynamic Media Viewers 5.13, lets customers of Dynamic Media, Adobe Analytics, and Adobe Launch to use events and data specific for the Dynamic Media Viewers in their Adobe Launch configuration.
Esta integración significa que puede realizar un seguimiento del uso de los visores de Dynamic Media en su sitio web con Adobe Analytics. Al mismo tiempo, puede utilizar los eventos y datos expuestos por los visores con cualquier otra extensión de Launch que provenga de Adobe o de un tercero.
Consulte Adobe Extension en la Guía del usuario de Experience Platform Launch para obtener más información sobre las extensiones.
Quién debe leer esta documentación: Administradores de sitio, desarrolladores de la plataforma AEM y los integrantes del equipo de Operaciones.

Limitaciones de la integración

  • La integración de Adobe Launch para visores de Dynamic Media no funciona en el nodo de creación de AEM. No puede ver ningún seguimiento de una página WCM hasta que se publique.
  • La integración de Adobe Launch para visores de Dynamic Media no se admite en el modo de operación "emergente", donde la URL del visor se obtiene mediante el botón "URL" de la página Detalles del recurso.
  • La integración de Adobe Launch no se puede utilizar de forma simultánea con la integración de los visores heredados con Analytics (a través del config2= parámetro).
  • La compatibilidad con el seguimiento de vídeo está limitada al seguimiento de reproducción principal únicamente, tal como se describe en Información general de seguimiento . En concreto, no se admite el seguimiento de QoS, anuncios, capítulos/segmentos o errores.
  • La configuración de la duración de Almacenamiento para elementos de datos no es compatible con elementos de datos mediante la extensión Visores de Dynamic Media. La duración del Almacenamiento debe establecerse en Ninguno .

Casos de uso para la integración

El principal caso de uso de la integración con Adobe Launch son los clientes que utilizan tanto AEM Assets como AEM Sites. En estos casos, puede configurar una integración estándar entre el nodo de creación de AEM y Adobe Launch y, a continuación, asociar la instancia de Sitios con la propiedad Adobe Launch. Después de esto, cualquier componente WCM de Dynamic Media agregado a una página Sitios rastreará datos y eventos de los visores.
Un caso de uso secundario que admite la integración son aquellos clientes que solo usan AEM Assets o Dynamic Media Classic. En estos casos, se obtiene el código incrustado del visor y se agrega a la página web. A continuación, obtenga la URL de producción de la biblioteca Adobe Launch de Adobe Launch y agréguela manualmente al código de la página web.

Funcionamiento del seguimiento de datos y eventos en la integración

La integración aprovecha dos tipos independientes de seguimiento de visores de Dynamic Media: Adobe Analytics y Adobe Analytics para audio y vídeo .

Acerca del seguimiento con Adobe Analytics

Adobe Analytics permite realizar el seguimiento de las acciones que realiza el usuario final cuando interactúa con los visores de Dynamic Media en el sitio web. Adobe Analytics también permite realizar el seguimiento de datos específicos del visor. Por ejemplo, puede rastrear y registrar eventos de carga de vista junto con el nombre del recurso, las acciones de zoom que se hayan producido, las acciones de reproducción de vídeo, etc.
En Adobe Launch, los conceptos de Elementos de datos y Reglas funcionan juntos para habilitar el seguimiento de Adobe Analytics.

Acerca de los elementos de datos en Adobe Launch

Un elemento de datos en Adobe Launch es una propiedad con nombre cuyo valor se define estáticamente o se calcula dinámicamente en función del estado de una página web o de los datos de los visores de Dynamic Media.
Las opciones disponibles para una definición de elemento de datos dependen de la lista de extensiones instaladas en la propiedad Adobe Launch. La extensión "Core" está preinstalada y está disponible de forma predeterminada en cualquier configuración. Esta extensión "Core" permite definir un elemento de datos cuyo valor proviene de una cookie, código JavaScript, cadena de consulta y muchas otras fuentes.
Para realizar el seguimiento de Adobe Analytics es necesario instalar varias extensiones adicionales, tal como se describe en Instalación y configuración de extensiones . La extensión Visores de Dynamic Media permite definir un elemento de datos que es un argumento del evento de visor dinámico. Por ejemplo, es posible hacer referencia al tipo de visor, o al nombre del recurso que el visor ha informado al cargar, al nivel de zoom que se registra cuando el usuario final amplía y mucho más.
La extensión del visor de Dynamic Media mantiene los valores de sus elementos de datos actualizados automáticamente.
Después de definirlo, se puede utilizar un elemento de datos en otros lugares de la interfaz de usuario de Adobe Launch mediante el widget de selector de elementos de datos. En particular, la acción Definir variables de la extensión Analytics de Adobe en Regla hará referencia a los elementos de datos definidos para el seguimiento de visores de Dynamic Media (consulte más adelante).
Consulte Elementos data-elements.html de datos en la Guía del usuario del Experience Platform Launch para obtener más información.

Acerca de las reglas en Adobe Launch

Una regla en Adobe Launch es una configuración agnóstica que define tres áreas que conforman una regla: Eventos , condiciones y acciones :
  • Los Eventos (si es) indican a Adobe Launch cuándo activar una regla.
  • Las condiciones (si es) indican a Adobe Launch qué restricciones adicionales se permiten o no al activar una regla.
  • Las acciones (entonces) indican a Adobe Launch qué hacer cuando se activa una regla.
Las opciones disponibles en la sección Eventos, condiciones y acciones dependen de las extensiones instaladas en la propiedad Adobe Launch. La extensión Core está preinstalada y está disponible de forma predeterminada en cualquier configuración. La extensión proporciona varias opciones para Eventos, como acciones básicas a nivel de explorador que incluyen cambios de enfoque, pulsaciones de teclas, envíos de formularios, etc. También incluye opciones para Condiciones, como el valor de la cookie, el tipo de explorador y mucho más. Para Acciones, solo está disponible la opción Código personalizado.
Para el seguimiento de Adobe Analytics, se deben instalar varias extensiones adicionales, tal como se describe en Instalación y configuración de extensiones . Específicamente:
  • La extensión de visores de Dynamic Media amplía la lista de Eventos admitidos a eventos específicos de visores de Dynamic Media, como la carga del visor, el intercambio de recursos, el zoom y la reproducción de vídeo.
  • La extensión Adobe Analytics amplía la lista de acciones admitidas con dos acciones necesarias para enviar datos a los servidores de seguimiento: Configure las variables y envíe la señalización .
Para rastrear los visores de Dynamic Media es posible utilizar cualquier tipo de lo siguiente:
  • Eventos de la extensión de visores de Dynamic Media, la extensión Core o cualquier otra extensión.
  • Condiciones de la definición de regla. O bien, puede dejar el área de condiciones vacío.
En la sección Acciones, es necesario que tenga una acción Establecer variables . Esta acción indica a Adobe Analytics cómo rellenar las variables de seguimiento con datos. Al mismo tiempo, la acción Establecer variables no envía nada al servidor de seguimiento.
La acción Establecer variables debe ir seguida de una acción Enviar señalización . La acción Enviar señalización realmente envía datos al servidor de seguimiento de Analytics. Ambas acciones, Establecer variables y Enviar señalización , provienen de la extensión Adobe Analytics.
Consulte Reglas en la Guía del usuario del Experience Platform Launch para obtener más información.

Configuración de muestra

La siguiente configuración de ejemplo de Adobe Launch muestra cómo rastrear un nombre de recurso al cargar el visor.
  1. En la ficha Elementos de datos, defina un elemento de datos AssetName que haga referencia al asset parámetro del LOAD evento desde la extensión Visores de Dynamic Media.
  2. En la ficha Reglas , defina una regla TrackAssetOnLoad .
    En esta regla, el campo Evento utiliza el evento CARGAR de la extensión Visores de Dynamic Media.
  3. La configuración de acción tiene dos tipos de acción de la extensión Adobe Analytics:
    Configure las variables , que asignan una variable de análisis de su elección al valor del elemento de AssetName datos.
    Enviar señalización , que envía información de seguimiento a Adobe Analytics.
  4. La configuración de regla resultante tiene el siguiente aspecto:

Acerca de Adobe Analytics para audio y vídeo

Cuando se suscribe una cuenta de Experience Cloud para utilizar Adobe Analytics para audio y vídeo, basta con activar el seguimiento de vídeo en la configuración de la extensión de visores de Dynamic Media. Las métricas de vídeo están disponibles en Adobe Analytics. El seguimiento de vídeo depende de la presencia de Adobe Media Analytics para la extensión de audio y vídeo.
Actualmente, la compatibilidad con el seguimiento de vídeo está limitada al seguimiento de "reproducción básica", tal como se describe en Información general de seguimiento . En concreto, no se admite el seguimiento de QoS, anuncios, capítulos/segmentos o errores.

Uso de la extensión Visores de Dynamic Media

Como se indica en los casos de uso de la integración , es posible realizar un seguimiento de los visores de Dynamic Media con la nueva integración de Adobe Launch en AEM Sites y mediante el uso de código incrustado.

Seguimiento de visores de Dynamic Media en AEM Sites

Para realizar el seguimiento de los visores de Dynamic Media en AEM Sites, deben realizarse todos los pasos enumerados en la sección Configuración de todos los elementos de integración. Específicamente, debe crear la configuración de IMS y la configuración de Adobe Launch Cloud.
Después de realizar la configuración adecuada, cualquier visor de Dynamic Media que agregue a una página Sitios mediante un componente WCM admitido por Dynamic Media rastreará automáticamente los datos en Adobe Analytics, Adobe Analytics para vídeo o ambos.

Seguimiento de visores de Dynamic Media mediante código incrustado

Los clientes que no utilicen AEM Sites o incrusten visores de Dynamic Media en páginas web fuera de los AEM Sites, o en ambas, podrán seguir utilizando la integración de Adobe Launch.
Debe completar los pasos de configuración desde las secciones Configuración de Adobe Analytics y Configuración de Adobe Launch . Sin embargo, no es necesario realizar pasos de configuración relacionados con AEM.
Una vez configurada correctamente, puede añadir la compatibilidad con Adobe Launch a una página web con un visor de Dynamic Media.
Consulte Añadir el código de incrustación de Launch para obtener más información sobre cómo utilizar el código incrustado de la biblioteca Adobe Launch.
Consulte Incrustación del visor de imágenes o vídeos en una página web para obtener más información sobre cómo utilizar la función de código incrustado de AEM Dynamic Media.
Para realizar el seguimiento de los visores de Dynamic Media mediante código incrustado
  1. Tenga una página web lista para incrustar un visor de Dynamic Media.
  2. Obtenga el código incrustado de la biblioteca Adobe Launch iniciando sesión en Adobe Launch (consulte Configuración de Adobe Launch ).
  3. Haga clic en Propiedad y, a continuación, en la ficha Entornos .
  4. Recoge el nivel de Entorno relevante para el entorno de la página web. A continuación, en la columna Instalar , haga clic en el icono del cuadro.
  5. En el cuadro de diálogo Instrucciones de instalación web, copie el código incrustado completo de la biblioteca Adobe Launch, junto con las <script/> etiquetas que lo rodean.

Guía de referencia para la extensión de visores de Dynamic Media

Acerca de la configuración de visores de Dynamic Media

La extensión del visor de Dynamic Media se integra automáticamente con la biblioteca Adobe Launch si se cumplen todas las condiciones siguientes:
  • El objeto global de la biblioteca de Adobe Launch ( _satellite ) está presente en la página.
  • La función de extensión de visores de Dynamic Media _dmviewers_v001() se define en _satellite .
  • config2= no se ha especificado el parámetro de visor, lo que significa que el visor no utiliza la integración heredada de Analytics.
Además, existe una opción para deshabilitar explícitamente la integración de Adobe Launch en el visor especificando launch=0 parámetros en la configuración del visor. El valor predeterminado de este parámetro es 1 .

Configuración de la extensión de visores de Dynamic Media

La única opción de configuración para la extensión de visores de Dynamic Media es Activar Adobe Media Analytics para audio y vídeo .
Al marcar (activar o "activar") esta opción, y si Adobe Media Analytics para la extensión de audio y vídeo está instalado y configurado correctamente, las métricas de reproducción de vídeo se envían a la solución Adobe Analytics para audio y vídeo. Al desactivar esta opción, se desactiva el seguimiento de vídeo.
Tenga en cuenta que si activa esta opción sin tener instalada la extensión Adobe Media Analytics para audio y vídeo, la opción no tendrá ningún efecto.

Acerca de los elementos de datos en la extensión Visores de Dynamic Media

El único tipo de elemento de datos que proporciona la extensión Visualizadores de Dynamic Media es el Evento de visualizador de la lista desplegable Tipo de elemento de datos .
Cuando se selecciona, el editor de elementos de datos procesa un formulario con dos campos:
  • Tipo de datos de evento de visualizadores de DM : Una lista desplegable que identifica todos los eventos de visualizador admitidos por la extensión de visualizadores de Dynamic Media que tienen argumentos, además de un elemento especial COMÚN . Un elemento COMÚN representa una lista de parámetros de evento que son comunes a todos los tipos de eventos enviados por los visualizadores.
  • Parámetro de seguimiento: un argumento del evento del visor de Dynamic Media seleccionado.
Consulte la guía de referencia de visores de Dynamic Media para la lista de eventos admitidos por cada tipo de visor; vaya a una sección específica del visor y, a continuación, haga clic en la subsección Compatibilidad con el seguimiento de Adobe Analytics. Actualmente, la guía de referencia de visores de Dynamic Media no documento argumentos de evento.
Consideremos ahora el ciclo de vida del elemento de datos de visores de Dynamic Media. El valor de dicho elemento de datos se rellena después de que se produzca el evento correspondiente del visor de Dynamic Media en la página. Por ejemplo, si el elemento de datos apunta al evento LOAD y su argumento "asset", el valor de dicho elemento de datos recibirá datos válidos después de que el visor ejecute el evento LOAD por primera vez. Si el elemento de datos apunta al evento ZOOM y su argumento de "escala", el valor de dicho elemento de datos permanecerá vacío hasta que el visor envíe por primera vez un evento ZOOM .
Del mismo modo, los valores de los elementos de datos se actualizan automáticamente cuando el visor envía un evento correspondiente a la página. La actualización de valor se produce incluso si el evento concreto no se especifica en la configuración de regla. Por ejemplo, si ZoomScale de elemento de datos está definido para el parámetro “scale” del evento ZOOM, pero la única regla presente en la configuración de regla se activa mediante el evento LOAD , el valor de ZoomScale se actualiza cada vez que un usuario ejecuta zoom dentro del visualizador.
Cualquier visualizador de Dynamic Media tiene un identificador único en la página web. El elemento de datos realiza un seguimiento del valor mismo y del visualizador que lo ha propagado. Esto significa que si hay varios visualizadores en la misma página y un elemento de datos AssetName que señala al evento LOAD y a su argumento “asset”; el elemento de datos AssetName mantiene una colección de nombres de recursos asociados a cada visualizador cargado en la página.
El valor exacto que devuelve el elemento de datos depende del contexto. Si el elemento de datos se solicita en una regla que se activó con un evento del visor de Dynamic Media, se devuelve el valor del elemento de datos para el visor que inició la regla. Y, si el elemento de datos se solicita en una regla que se activó con un Evento de otra extensión de Adobe Launch, el valor del elemento de datos es el valor del visor que fue el último en actualizar este elemento de datos.
Considere la siguiente configuración de muestra:
  • Una página web con dos visores de zoom Dynamic Media; se referirán a ellos como viewer1 y viewer2 .
  • El elemento de datos ZoomScale apunta al evento ZOOM y su argumento de "escala".
  • Regla TrackPan con lo siguiente:
    • Utiliza el evento PAN del visor de Dynamic Media como activador.
    • Envía el valor del elemento de datos ZoomScale a Adobe Analytics.
    • Regla TrackKey con lo siguiente:
    • Utiliza el evento de prensa clave de la extensión Core Adobe Launch como activador.
    • Envía el valor del elemento de datos ZoomScale a Adobe Analytics.
Ahora, supongamos que el usuario final carga la página web con los dos visores. En viewer1 , se amplía al 50 % de la escala; a continuación, en viewer2 , se amplía al 25 % de la escala. En viewer1 , recorren la imagen y finalmente presionan una tecla en el teclado.
La actividad del usuario final da como resultado que se realicen las dos llamadas de seguimiento siguientes a Adobe Analytics:
  • La primera llamada se produce porque la regla TrackPan se activa cuando el usuario se desplaza en viewer1 . Esa llamada envía el 50 % como valor del elemento de datos ZoomScale porque el elemento de datos sabrá que la regla se activa con viewer1 y obtiene el valor de escala correspondiente;
  • La segunda llamada se produce porque TrackKey Rule se activa cuando el usuario pulsa una tecla en el teclado. Esa llamada envía el 25 % como valor del elemento de datos ZoomScale porque el visor no activó la regla. Como tal, el elemento de datos devuelve el valor más actualizado.
El ejemplo configurado arriba también afecta a la duración del valor del elemento de datos. El valor del elemento de datos administrado por el visor de Dynamic Media se almacena en el código de la biblioteca de Adobe Launch incluso después de que el propio visor se haya eliminado de la página web. Esto significa que si hay una regla que se activa por una extensión que no es de Dynamic Media Viewer y hace referencia a dicho elemento de datos, el elemento de datos devuelve el último valor conocido, incluso si el visor ya no está presente en la página web.
En cualquier caso, los valores de los elementos de datos impulsados por los visores de Dynamic Media no se almacenan en el almacenamiento local ni en el servidor; en su lugar, solo se conservan en la biblioteca de Adobe Launch del lado del cliente. Los valores de dicho elemento de datos desaparecen cuando se vuelve a cargar la página web.
Generalmente, el editor de elementos de datos admite la selección de duración del almacenamiento. Sin embargo, los elementos de datos que utilizan la extensión Visores de Dynamic Media solo admiten la opción de duración del almacenamiento Ninguno . En la interfaz de usuario es posible establecer cualquier otro valor, pero en este caso no se define el comportamiento de los elementos de datos. La extensión administra por sí sola el valor del elemento de datos: el elemento de datos que mantiene el valor del argumento de evento del visor durante todo el ciclo de vida del visor.

Acerca de las reglas en la extensión Visores de Dynamic Media

En el editor de reglas, la extensión agrega nuevas opciones de configuración para el editor de Eventos. También proporciona una opción para hacer referencia manualmente a los parámetros de evento en el editor de acciones como una opción de mano corta en lugar de utilizar elementos de datos preconfigurados.

Acerca del editor de Eventos

En el editor de eventos, la extensión Visualizadores de medios dinámicos agrega un nuevo Tipo de evento denominado Evento de visualizador .
Cuando se selecciona, el editor de Evento procesa la lista desplegable de eventos del visor de Dynamic Media, que enumera todos los eventos disponibles que admiten los visores de Dynamic Media.

Acerca del editor Acciones

La extensión Visores de Dynamic Media le permite utilizar parámetros de evento de visores de Dynamic Media para asignarlos a variables de análisis en el editor Definir variables de la extensión Analytics de Adobe.
El método más sencillo para hacerlo es completar el siguiente proceso de dos pasos:
  • En primer lugar, defina uno o varios elementos de datos, donde cada elemento de datos representa un parámetro de un evento de visor de Dynamic Media.
  • Por último, en el editor Definir variables de la extensión Analytics de Adobe, haga clic en el icono Selector de elementos de datos (tres discos apilados) para abrir el cuadro de diálogo Seleccionar elemento de datos y, a continuación, seleccione un elemento de datos en él.
Sin embargo, es posible utilizar un enfoque alternativo y evitar la creación de elementos de datos. Puede hacer referencia directamente a un argumento de un evento de visualizador de Dynamic Media introduciendo el nombre completo del argumento de evento en el campo de entrada de valor de la asignación de variables de Analytics, rodeado de signos de porcentaje (%). Por ejemplo,
%event.detail.dm.LOAD.asset%
Tenga en cuenta que existe una diferencia importante entre el uso de elementos de datos y la referencia directa de argumentos de evento. Para el elemento de datos, no importa qué evento desencadene la acción Definir variables, el evento que activa la regla puede no estar relacionado con el visor dinámico (como un clic del ratón en la página web desde la extensión Core). Sin embargo, al utilizar una referencia de argumento directa es importante asegurarse de que el evento que activa la regla corresponde al argumento de evento al que hace referencia.
Por ejemplo, la referencia %event.detail.dm.LOAD.asset% devuelve el nombre de recurso correcto si la regla se activa mediante el evento LOAD de la extensión del visualizador de Dynamic Media. Sin embargo, devuelve un valor vacío para cualquier otro evento.
La tabla siguiente lista los eventos del visor de Dynamic Media y sus argumentos admitidos:
Nombre del evento del visor Referencia de argumento
COMMON %event.detail.dm.objID%
%event.detail.dm.compClass%
%event.detail.dm.instName%
%event.detail.dm.timeStamp%
BANNER %event.detail.dm.BANNER.asset%
%event.detail.dm.BANNER.frame%
%event.detail.dm.BANNER.label%
HREF %event.detail.dm.HREF.rollover%
ITEM %event.detail.dm.ITEM.rollover%
LOAD %event.detail.dm.LOAD.applicationname%
%event.detail.dm.LOAD.asset%
%event.detail.dm.LOAD.company%
%event.detail.dm.LOAD.sdkversion%
%event.detail.dm.LOAD.viewertype%
%event.detail.dm.LOAD.viewerversion%
METADATA %event.detail.dm.METADATA.length%
%event.detail.dm.METADATA.type%
MILESTONE %event.detail.dm.MILESTONE.milestone%
PAGE %event.detail.dm.PAGE.frame%
%event.detail.dm.PAGE.label%
PAUSE %event.detail.dm.PAUSE.timestamp%
PLAY %event.detail.dm.PLAY.timestamp%
SPIN %event.detail.dm.SPIN.framenumber%
STOP %event.detail.dm.STOP.timestamp%
SWAP %event.detail.dm.SWAP.asset%
SWATCH %event.detail.dm.SWATCH.frame%
%event.detail.dm.SWATCH.label%
TARG %event.detail.dm.TARG.frame%
%event.detail.dm.TARG.label%
ZOOM %event.detail.dm.ZOOM.scale%

Configuración de todas las piezas de integración

ANTES DE COMENZAR
Si aún no lo ha hecho, Adobe recomienda revisar toda la documentación antes de esta sección para que pueda comprender la integración completa.
En esta sección se explican los pasos de configuración necesarios para integrar los visores de Dynamic Media con Adobe Analytics y Adobe Analytics para audio y vídeo. Aunque es posible utilizar la extensión de visores de Dynamic Media para otros fines en Adobe Launch, estos escenarios no se incluyen en esta documentación.
La integración se configurará en los siguientes productos de Adobe:
  • Adobe Analytics: configurará variables e informes de seguimiento.
  • Adobe Launch: definirá una propiedad, una o varias reglas y uno o varios elementos de datos para habilitar el seguimiento del visor.
Además, si esta solución de integración se utiliza con AEM Sites, también es necesario realizar la siguiente configuración:
  • Adobe I/O Console: la integración se crea para Adobe Launch.
  • Nodo de creación de AEM: configuración de IMS y configuración de nube de Adobe Launch.
Como parte de la configuración, asegúrese de tener acceso a una compañía de Adobe Experience Cloud que ya tenga Adobe Analytics y Adobe Launch activados.

Configuración de Adobe Analytics para la integración

Después de configurar Adobe Analytics, se configurará lo siguiente para la integración:
  • Se ha seleccionado un grupo de informes.
  • Las variables de Analytics están disponibles para recibir datos de seguimiento.
  • Los informes están disponibles para la vista de datos recopilados dentro de Adobe Analytics.
Consulte también Guía de implementación de Analytics .
Para configurar Adobe Analytics para la integración :
  1. Inicio accediendo a Adobe Analytics desde la página de inicio de Experience Cloud. En la barra de menús, haga clic en el icono Soluciones (una tabla de puntos de tres por tres) cerca de la esquina superior derecha de la página y, a continuación, haga clic en Analytics .
    Ahora seleccionará un grupo de informes.

Selección de un grupo de informes

  1. Cerca de la esquina superior derecha de la página Adobe Analytics, a la derecha del campo Buscar informes , seleccione el grupo de informes correcto en la lista desplegable. Si hay varios grupos de informes disponibles y no está seguro de cuál usar, póngase en contacto con el administrador de Adobe Analytics, que le ayudará a seleccionar qué grupo de informes utilizar.
    En la siguiente ilustración, un usuario creó un grupo de informes denominado DynamicMediaViewersExtensionDoc y lo seleccionó en la lista desplegable. El nombre del grupo de informes se muestra únicamente con fines ilustrativos; el nombre del grupo de informes que seleccione en última instancia será distinto.
    Si no hay ningún grupo de informes disponible, usted o el administrador de Adobe Analytics deben crear uno para poder continuar con la configuración.
    Consulte Informes y grupos de informes y Creación de un grupo de informes.
    En Adobe Analytics, los grupos de informes se administran en Administración > Grupos de informes.
    Ahora configurará las variables de Adobe Analytics.

Configuración de variables de Adobe Analytics

  1. Ahora designará una o varias variables de Adobe Analytics que desee utilizar para rastrear el comportamiento de los visores de Dynamic Media en la página web.
    Es posible utilizar cualquier tipo de variable admitida por Adobe Analytics. La decisión sobre el tipo de variable (como # de tráfico personalizado, # de conversión) debe estar motivada por las necesidades específicas de la implementación de Analytics.
    A efectos de esta documentación, solo se utilizará una variable de tráfico personalizado (props) porque estará disponible en un informe de Analytics en los minutos siguientes a la acción que se produzca en una página web.
    Para habilitar una nueva variable de tráfico personalizado, en Adobe Analytics, en la barra de herramientas, haga clic en Administración > Grupos de informes.
  2. En la página Administrador de grupos de informes , seleccione el informe correcto y, en la barra de herramientas, haga clic en Editar configuración > Tráfico > Variables de tráfico .
  3. Allí, tome la variable no utilizada, asígnele un nombre descriptivo (recurso del visor (prop 30) ) y cambie el cuadro combinado a "Habilitado" en la columna Habilitado.
    La siguiente captura de pantalla es un ejemplo de una variable de tráfico personalizado ( prop30 ) para rastrear el nombre de un recurso utilizado por el visor:
  4. En la parte inferior de la lista de variables, haga clic en Guardar .

Configuración de un informe

  1. En general, la configuración de un informe en Adobe Analytics depende de las necesidades específicas del proyecto. Como tal, la configuración detallada del informe está fuera del alcance de esta integración.
    Sin embargo, basta con saber que los informes de tráfico personalizado estarán disponibles automáticamente en Adobe Analytics después de configurar las variables de tráfico personalizado en la configuración de las variables ​de Adobe Analytics.
    Por ejemplo: el informe para la variable de recurso del visualizador (prop 30) está disponible en el menú Informes en Tráfico personalizado > Tráfico personalizado 21-30 > Recurso del visualizador (prop 30) .
    Al visitar este informe justo después de la creación de Recursos del visualizador (prop 30) , no se muestra ningún dato; esto se espera en este punto de la integración.

Configuración de Adobe Launch para la integración

Después de configurar Adobe Launch, se configurará lo siguiente para la integración:
  • La creación de una nueva propiedad para mantener todas las configuraciones juntas.
  • Instalación y configuración de extensiones. El código de cliente de todas las extensiones instaladas en la propiedad se compila en una biblioteca. Esta biblioteca se utiliza más adelante en la página web.
  • Configuración de elementos de datos y reglas. Esta configuración define qué datos se van a capturar desde los visores de Dynamic Media, cuándo se debe activar la lógica de seguimiento y dónde se deben enviar los datos del visor en Adobe Analytics.
  • Publicación de la biblioteca.
Para configurar Adobe Launch para la integración :
  1. Inicio accediendo a Adobe Launch desde la página de inicio Experience Cloud. En la barra de menús, haga clic en el icono Soluciones (tres por tres puntos de tabla) cerca de la esquina superior derecha de la página y, a continuación, haga clic en Iniciar .

Creación de una propiedad en Adobe Launch

Una propiedad de Adobe Launch es una configuración con nombre que mantiene unidas todas las opciones de configuración. Se genera una biblioteca de los ajustes de configuración que se publica en diferentes niveles de entorno (desarrollo, ensayo y producción).
Consulte también Creación de una propiedad .
  1. En Adobe Launch, haga clic en Nueva propiedad .
  2. En el cuadro de diálogo Crear propiedad , dentro del campo Nombre , escriba un nombre descriptivo, como el título del sitio web. Por ejemplo, DynamicMediaViewersProp.
  3. En el campo Dominios , introduzca el dominio del sitio web.
  4. En la lista desplegable Opciones avanzadas , habilite Configurar para el desarrollo de extensiones (no se puede modificar posteriormente) siempre que la extensión que desee utilizar (en este caso, los visualizadores de Dynamic Media ) aún no se haya publicado.
  5. Haga clic en Guardar .
    Haga clic en la propiedad recientemente creada y luego continúe con Instalación y configuración de extensiones .

Instalación y configuración de extensiones

Todas las extensiones disponibles en Adobe Launch se muestran en Extensiones > Catálogo .
Para instalar una extensión, haga clic en Instalar . Si es necesario, realice una configuración de extensión única y, a continuación, haga clic en Guardar .
Cuando sea necesario, deben instalarse y configurarse las siguientes extensiones:
  • (Requerido) Extensión del servicio de ID de Experience Cloud
No se necesita ninguna configuración adicional, aceptar los valores propuestos. Cuando haya terminado, asegúrese de hacer clic en Guardar .
Consulte Extensión del servicio de ID de Experience Cloud.
  • (Requerido) Extensión Adobe Analytics
Para configurar esta extensión, primero necesitará la ID del grupo de informes que se encuentra en Adobe Analytics, en Administración > Grupode informes , en el encabezado de la columna ID del grupo de informes .
(Solo con fines de demostración, el ID del grupo de informes DynamicMediaViewersExtensionDoc se utilizará en las siguientes capturas de pantalla. Este ID se creó y utilizó en Selección de un grupo de informes anteriormente).
En la página Instalar extensión, introduzca la ID del grupo de informes en el campo Grupos de informes de desarrollo , en el campo Grupos de informes de ensayo y en el campo Grupos de informes de producción .
Configure el siguiente elemento solo si planea utilizar el seguimiento de vídeo:
En la página Instalar extensión , expanda General y, a continuación, especifique el servidor de seguimiento. El Servidor de seguimiento sigue la plantilla <trackingNamespace>.sc.omtrdc.net , donde <trackingNamespace> es la información obtenida en el correo electrónico de aprovisionamiento.
Haga clic en Guardar .
  • (Opcional. Solo es necesario si se necesita el seguimiento de vídeo) Adobe Media Analytics para la extensión de audio y vídeo
Complete el campo del servidor de seguimiento. El servidor de seguimiento para la extensión Adobe Media Analytics para audio y vídeo es diferente del servidor de seguimiento utilizado para Adobe Analytics. Sigue la plantilla <trackingNamespace>.hb.omtrdc.net , donde <trackingNamespace> es la información del correo electrónico de aprovisionamiento.
El resto de campos son opcionales.
Consulte Adobe Media Analytics para la extensión de audio y vídeo.
  • (Requerido) Extensión de visores de Dynamic Media
Seleccione habilitar Adobe Analytics para vídeo para activar el seguimiento de Video Heartbeat.
Tenga en cuenta que, en el momento de escribir este artículo, la extensión de visores de Dynamic Media solo está disponible si se ha creado la propiedad Adobe Launch para el desarrollo.
Después de instalar y configurar las extensiones, al menos las siguientes cinco extensiones (cuatro si no realiza el seguimiento de vídeo) se enumerarán en el área Extensiones > Instalado.

Configuración de elementos y reglas de datos

En Adobe Launch, cree elementos de datos y reglas que sean necesarios para rastrear los visores de Dynamic Media.
Consulte Funcionamiento del seguimiento de datos y eventos en la integración para obtener una descripción general del seguimiento con Adobe Launch.
Consulte Configuración de muestra para ver una configuración de muestra en Adobe Launch que muestra cómo rastrear un nombre de recurso al cargar el visor.
Consulte Configuración de la extensión de visores de Dynamic Media para obtener información detallada sobre las funciones de la extensión.

Publicación de una biblioteca

Para realizar cambios en la configuración de Adobe Launch (incluida la configuración de propiedades, extensiones, reglas y elementos de datos), debe publicar dichos cambios. La publicación en Adobe Launch se realiza desde la ficha Publicación, en la configuración Propiedad.
Adobe Launch puede tener varios entornos de desarrollo, un entorno de ensayo y un entorno de producción. De forma predeterminada, la configuración de Adobe Launch Cloud en AEM dirige el nodo de creación de AEM al entorno de fase de Adobe Launch y el nodo de publicación de AEM al entorno de producción de Adobe Launch. Esta disposición significa que con la configuración predeterminada de AEM, es necesario publicar la biblioteca de Adobe Launch en el entorno de ensayo para utilizarla en el autor de AEM y, a continuación, publicarla en el entorno de producción para que se pueda utilizar en la publicación de AEM.
Consulte Entornos para obtener más información sobre los entornos de Adobe Launch.
La publicación de una biblioteca implica los dos pasos siguientes:
  • Añadir y crear una nueva biblioteca incluyendo todos los cambios necesarios (nuevos y actualizaciones) en la biblioteca.
  • Subir la biblioteca por los diferentes niveles de entorno (de desarrollo a ensayo y producción)

Añadir y crear una nueva biblioteca

  1. La primera vez que abra la ficha Publicación en Adobe Launch, la lista de biblioteca estará vacía.
    En la columna izquierda, haga clic en Añadir nueva biblioteca .
  2. En la página Crear nueva biblioteca, en el campo Nombre , introduzca un nombre descriptivo para la nueva biblioteca. Por ejemplo,
    DynamicMediaViewersLib
    En la lista desplegable Entorno, elija el nivel de Entorno. Inicialmente, solo el nivel de desarrollo está disponible para selección. Cerca de la parte inferior izquierda de la página, haga clic en Añadir todos los recursos modificados.
  3. Near the upper-right corner of the page, click Save &amp; Build for Development .
    En pocos minutos, la biblioteca se crea y está lista para usarse.
    La próxima vez que realice cambios en la configuración de Adobe Launch, vaya a la pestaña Publicación en la configuración de la propiedad y, a continuación, haga clic en la biblioteca creada anteriormente.
    En la pantalla de publicación de la biblioteca, haga clic en Añadir todos los recursos modificados y, a continuación, haga clic en Guardar y crear para desarrollo .

Subir una biblioteca por niveles de entorno

  1. Después de agregar una nueva biblioteca, se encuentra inicialmente en el entorno de desarrollo. Para moverlo al nivel de entorno Ensayo (que corresponde a la columna Enviado), en el menú desplegable de la biblioteca, haga clic en Enviar para aprobación .
  2. En el cuadro de diálogo de confirmación, haga clic en Enviar .
    Una vez que la biblioteca se desplace a la columna Enviado, en el menú desplegable de la biblioteca, haga clic en Generar para ensayo .
  3. Siga un proceso similar para mover la biblioteca del entorno Ensayo al entorno Producción (que es la columna Publicado).
    En primer lugar, en el menú desplegable, haga clic en Aprobar para publicación .
  4. En el menú desplegable, haga clic en Generar y publicar en producción .
    Consulte Publicación para obtener más información sobre el proceso de publicación en Adobe Launch.

Configuración del Adobe Experience Manager para la integración

Requisitos previos:
  • AEM ejecuta instancias de creación y publicación.
  • El nodo de creación de AEM está configurado en Dynamic Media.
  • Los componentes de Dynamic Media WCM están activados en AEM Sites.
La configuración de AEM consta de los dos pasos principales siguientes:
  • Configuración de AEM IMS.
  • Configuración de Adobe Launch Cloud.

Configuración de AEM IMS

  1. En AEM Author, haga clic en el icono Herramientas (martillo) y, a continuación, haga clic en Seguridad > Configuraciones de Adobe IMS.
  2. En la página Configuración de Adobe IMC, cerca de la esquina superior izquierda, haga clic en Crear .
  3. En la página Configuración técnica de la cuenta de Adobe IMD , en la lista desplegable Soluciones de nube , haga clic en Adobe Launch .
  4. Active Crear nuevo certificado y, a continuación, en el campo de texto, introduzca cualquier valor significativo para el certificado. Por ejemplo, AdobeLaunchIMSCert . Haga clic en Crear certificado .
    Se muestra el siguiente mensaje de información:
    Para recuperar un token de acceso válido, la clave pública del nuevo certificado debe agregarse a la cuenta técnica de Adobe I/O! .
    Click OK to dismiss the Info dialog box.
  5. Haga clic en Descargar clave pública para descargar un archivo de clave pública ( *.crt ) en el sistema local.
    En este punto, deje abierta la página Configuración de cuenta técnica de Adobe IMS ; no cierre la página y no haga clic en Siguiente. Volverá a esta página más adelante en los pasos.
  6. En una nueva ficha del explorador, desplácese hasta la consola de E/S de Adobe.
  7. En la página Integraciones de la consola de E/S de Adobe, cerca de la esquina superior derecha, haga clic en Nueva integración .
  8. En el cuadro de diálogo Crear una nueva integración , compruebe que está seleccionado la opción Acceder a una API y, a continuación, haga clic en Continuar .
  9. En la segunda página Crear una nueva página de integración , active el botón de radio API Experience Platform Launch . En la esquina inferior derecha de la página, haga clic en Continuar .
  10. En la tercera página Crear una nueva página de integración , haga lo siguiente:
    • En el campo Nombre , introduzca un nombre descriptivo. Por ejemplo, DynamicMediaViewersIO .
    • En el campo Descripción , introduzca una descripción para la integración.
    • En el área Certificados de clave pública, cargue el archivo de clave pública ( *.crt ) que descargó anteriormente en estos pasos.
    • Under the Select a role for Experience Platform Launch API heading, select Admin .
    • En el encabezado Seleccionar uno o varios perfiles de producto para la API de Experience Platform Launch, seleccione el perfil de producto llamado Launch - &lt;your_compañía_name> .
  11. Click Create integration .
  12. En la página Integración creada , haga clic en Continuar a los detalles de integración.
  13. Aparece una página de detalles de Integraciones, similar a la siguiente:
    Deje abierta esta página de detalles de integración . En un momento necesitarás información de las pestañas Información general y JWT .
    Página de detalles de la integración
  14. Vuelva a la página Configuración de cuenta técnica de Adobe IMS que dejó abierta anteriormente. En la esquina superior derecha de la página, haga clic en Siguiente para abrir la página Cuenta en la ventana Configuración de cuenta técnica de IMS de Adobe .
    (Si ha cerrado la página por error anteriormente, regrese a AEM Author y, a continuación, haga clic en Herramientas > Seguridad > Configuraciones de Adobe IMS . Haga clic en Crear . En la lista desplegable Solución de nube , seleccione Adobe Launch . En la lista desplegable Certificado , seleccione el nombre del certificado creado anteriormente.
    Configuración de cuenta técnica de Adobe IMS: página de certificado
  15. La página Cuenta tiene cinco campos que le requerirán que rellene con la información de la página Detalles de la integración del paso anterior.
    Configuración de cuenta técnica de Adobe IMS: página de cuenta
  16. En la página Cuenta , rellene los campos siguientes:
    • Título : introduzca un título de cuenta descriptivo.
    • Servidor de autorización: vuelva a la página de detalles de integración que abrió anteriormente. Click the JWT tab. Copie el nombre del servidor (sin la ruta de acceso) como se resalta a continuación.
(el nombre del servidor de ejemplo es solo para fines ilustrativos) Vuelva a la página Cuenta y, a continuación, pegue el nombre en el campo correspondiente. Por ejemplo, https://ims-na1.adobelogin.com/ (el nombre del servidor de ejemplo es solo para fines ilustrativos)
Página de detalles de integración: ficha JWT
  1. Clave de API : Vuelva a la página de detalles de la integración. Haga clic en la pestaña Información general y, a continuación, a la derecha del campo Clave de API (ID de cliente) , haga clic en Copiar .
    Vuelva a la página Cuenta y pegue la clave en el campo correspondiente.
    Página de detalles de la integración
  2. Secreto del cliente : Regrese a la página de detalles de la integración. En la pestaña Información general , haga clic en Recuperar secreto de cliente . A la derecha del campo Secreto de cliente , haga clic en Copiar .
    Vuelva a la página Cuenta y pegue la clave en el campo correspondiente.
  3. Carga útil : vuelva a la página de detalles de integración. Desde la ficha JWT , en el campo Carga útil JWT, copie todo el código de objeto JSON.
    Vuelva a la página Cuenta y pegue el código en el campo correspondiente.
    Página de detalles de integración: ficha JWT
    La página Cuenta, con todos los campos completados, tendrá un aspecto similar al siguiente:
  4. Near the upper-right corner of the Account page, click Create .
    Con AEM IMS configurado, ahora tiene una nueva cuenta IMSAccount en Configuraciones Adobe IMS .

Configuración de Adobe Launch Cloud para la integración

  1. En AEM Author, cerca de la esquina superior izquierda, haga clic en el icono Herramientas (martillo) y, a continuación, haga clic en Cloud Service > Configuraciones de Adobe Launch.
  2. En la página Configuración de inicio de Adobe, en el panel izquierdo, seleccione un sitio de AEM para el que desee aplicar la configuración de Adobe Launch.
    Sólo con fines ilustrativos, el sitio We.Retail está seleccionado en la captura de pantalla siguiente.
  3. Cerca de la esquina superior izquierda de la página, haga clic en Crear .
  4. En la página General (1/3 páginas) de la ventana Crear configuración de Adobe Launch , rellene los campos siguientes:
    • Título : introduzca un título de configuración descriptivo. Por ejemplo, We.Retail Launch cloud configuration .
    • Configuración de Adobe IMS asociada: seleccione la configuración de IMS que creó anteriormente en Configuración de AEM IMS .
    • Compañía : en la lista desplegable Compañía , seleccione la compañía del Experience Cloud. La lista se rellena automáticamente.
    • Propiedad : en la lista desplegable Propiedad, seleccione la propiedad Adobe Launch que creó anteriormente. La lista se rellena automáticamente.
    Después de completar todos los campos, la página General tendrá un aspecto similar al siguiente:
  5. Cerca de la esquina superior izquierda, haga clic en Siguiente .
  6. En la página Ensayo (2/3 páginas) de la ventana Crear configuración de Adobe Launch , rellene el siguiente campo:
    En el campo URI de biblioteca , compruebe la ubicación de la versión de ensayo de la biblioteca de Adobe Launch. AEM rellena este campo automáticamente.
    Solo para fines ilustrativos, este paso utilizará las bibliotecas de Adobe Launch implementadas en Adobe CDN.
    Compruebe que el URI de la biblioteca rellenado automáticamente (identificador uniforme de recursos) no esté mal formado. Si es necesario, corríjalo para que el URI represente un URI relativo al protocolo. Es decir, inicio de una barra diagonal de doble.
    Por ejemplo: //assets.adobetm.com/launch-xxxx .
    La página Ensayo debe tener un aspecto similar al siguiente. Tenga en cuenta que las opciones Archivar y Cargar biblioteca de forma asincrónica no están definidas:
  7. Cerca de la esquina superior derecha, haga clic en Siguiente .
  8. En la página Producción (3/3 páginas) de la ventana Crear configuración de Adobe Launch , si es necesario, corrija el URI de producción rellenado automáticamente de forma similar a como se hizo en la página anterior Ensayo .
  9. Cerca de la esquina superior derecha, haga clic en Crear .
    La nueva configuración de Adobe Launch Cloud ahora se crea y se muestra junto a su sitio web.
  10. Seleccione la nueva configuración de Adobe Launch Cloud (cuando está seleccionada, aparece una marca de verificación a la izquierda del título de configuración). En la barra de herramientas, haga clic en Publicar .
Actualmente, el autor de AEM no admite la integración de visores de Dynamic Media con Adobe Launch.
Sin embargo, es compatible con el nodo de publicación de AEM. Con la configuración predeterminada de Adobe Launch Cloud Configuration, AEM Publish utiliza el entorno de producción de Adobe Launch. Como tal, es necesario insertar las actualizaciones de la biblioteca Adobe Launch desde Desarrollo hasta el entorno de producción cada vez que se realiza la prueba.
Es posible solucionar esta limitación especificando la URL de desarrollo o ensayo de la biblioteca Adobe Launch en la configuración de Adobe Launch Cloud para la publicación de AEM que se muestra más arriba. Al hacer esto, el nodo de publicación de AEM utiliza la versión de desarrollo o ensayo de la biblioteca de Adobe Launch.
Consulte Integración de AEM con Adobe Launch mediante Adobe I/O para obtener más información sobre la configuración de Adobe Launch Cloud.