Integración de visores de Dynamic Media con Adobe Analytics y etiquetas de Experience Platform

¿Qué es la integración de los visualizadores de Dynamic Media con Adobe Analytics y las etiquetas de Experience Platform?

La extensión Visualizadores de Dynamic Media para etiquetas de Experience Platform y visores de Dynamic Media 5.13 permite a los clientes de Adobe Analytics y Etiquetas de Experience Platform utilizar eventos y datos específicos para los visualizadores de Dynamic Media en la configuración de Etiquetas de Experience Platform.

Esta integración significa que puede realizar un seguimiento del uso de los visualizadores de Dynamic Media en su sitio web con Adobe Analytics. Al mismo tiempo, puede utilizar los eventos y datos expuestos por los visualizadores con cualquier otra extensión Etiquetas de Experience Platform que provenga de un Adobe o de un tercero.

Para obtener más información sobre las extensiones de Adobe o las extensiones de terceros, consulte Extensiones de Adobe en la Guía del usuario de etiquetas de Experience Platform.

Este tema está dirigido a los siguientes: Administradores de sitio, desarrolladores del programa Adobe Experience Manager y personas en operaciones.

Limitaciones de la integración

  • La integración de etiquetas de Experience Platform para visores de Dynamic Media no funciona en el nodo de creación de Experience Manager. No puede ver ningún seguimiento de una página WCM hasta que se publique.
  • La integración de etiquetas de Experience Platform para los visores de Dynamic Media no es compatible con el modo de operación "emergente", en el que la URL del visor se obtiene mediante el botón "URL" de la página Detalles del recurso.
  • La integración de etiquetas de Experience Platform no se puede usar simultáneamente con la integración de Analytics de visores heredados (mediante el parámetro config2=).
  • La compatibilidad con el seguimiento de vídeo está limitada únicamente al seguimiento de reproducción principal, tal como se describe en Información general del seguimiento. En concreto, no se admite el seguimiento de QoS, anuncios, capítulos/segmentos o errores.
  • La configuración de la duración del almacenamiento para elementos de datos no es compatible con los elementos de datos que utilizan la extensión Visualizadores de Dynamic Media. La duración del almacenamiento debe establecerse en None.

Ejemplos de uso de la integración

El caso de uso principal para la integración con etiquetas de Experience Platform es el de los clientes que usan tanto Recursos de Experience Manager como Sitios de Experience Manager. En estos casos, puede configurar una integración estándar entre el nodo de creación del Experience Manager y las etiquetas del Experience Platform y, a continuación, asociar la instancia de Sites con la propiedad Etiquetas del Experience Platform. Después, cualquier componente WCM de Dynamic Media añadido a una página Sitios rastreará datos y eventos de los visualizadores.

Consulte Seguimiento de los visores de Dynamic Media en sitios de Experience Manager.

Un caso de uso secundario que admite la integración es el de los clientes que solo utilizan recursos de Experience Manager o Dynamic Media Classic. En estos casos, obtiene el código incrustado para el visor y lo añade a la página del sitio web. A continuación, obtenga la URL de producción de la biblioteca de etiquetas de Experience Platform de Etiquetas de Experience Platform y agréguela manualmente al código de la página web.

Consulte Seguimiento de visores de Dynamic Media mediante el código incrustado.

Cómo funciona el 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 rastrear las acciones que realiza el usuario final cuando interactúa con los visualizadores de Dynamic Media en el sitio web. Adobe Analytics también permite rastrear datos específicos del visor. Por ejemplo, puede rastrear y registrar eventos de carga de vista junto con el nombre del recurso, cualquier acción de zoom que se haya producido y acciones de reproducción de vídeo.

En las etiquetas de Experience Platform, los conceptos de Elementos de datos y Reglas colaboran para habilitar el seguimiento de Adobe Analytics.

Acerca de los elementos de datos en las etiquetas de Experience Platform

Un elemento de datos en etiquetas de Experience Platform es una propiedad con nombre cuyo valor se define de forma estática o se calcula dinámicamente en función del estado de una página web o de los datos de los visualizadores de Dynamic Media.

Las opciones disponibles para una definición de elemento de datos dependen de la lista de extensiones instaladas en la propiedad Etiquetas de Experience Platform. 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 que tenga como resultado una cookie, un código JavaScript, una cadena de consulta y muchas otras fuentes.

Para el seguimiento de Adobe Analytics, se deben instalar otras extensiones, tal como se describe en Instalación y configuración de extensiones. La extensión Visualizadores de Dynamic Media permite definir un elemento de datos que sea un argumento del evento de visualizador dinámico. Por ejemplo, es posible hacer referencia al tipo de visualizador o al nombre del recurso que el visualizador haya informado al cargar, al nivel de zoom que se recoge 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.

Una vez definido, un elemento de datos se puede utilizar en otros lugares de la interfaz de usuario de etiquetas de Experience Platform mediante el widget de selector de elementos de datos. En concreto, la acción Set Variables de la extensión de Adobe Analytics en la regla hace referencia a los elementos de datos definidos para los fines del seguimiento de visualizadores de Dynamic Media (consulte a continuación).

Consulte Elementos de datos en la Guía del usuario de etiquetas de Experience Platform.

Acerca de las reglas en las etiquetas de Experience Platform

Una regla en etiquetas de Experience Platform es una configuración agnóstica que define tres áreas que constituyen una regla: Eventos, Condiciones y Acciones:

  • Los eventos (si) indican a las etiquetas del Experience Platform cuándo realizar el déclencheur de una regla.
  • Las condiciones (si) indican a las etiquetas del Experience Platform qué otras restricciones se permiten o no al activar una regla.
  • Acciones (entonces) indica a las etiquetas del Experience Platform 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 Etiquetas de Experience Platform. La extensión Core está preinstalada y disponible de forma predeterminada en cualquier configuración. La extensión proporciona varias opciones para Eventos, como acciones básicas de explorador que incluyen cambio de enfoque, pulsaciones clave y envíos de formularios. 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 otras extensiones, tal como se describe en Instalación y configuración de extensiones. Específicamente:

  • La extensión Visualizadores de Dynamic Media amplía la lista de eventos admitidos a eventos específicos de los visualizadores de Dynamic Media, como la carga del visualizador, el intercambio de recursos, el zoom y la reproducción de vídeo.
  • La extensión de Adobe Analytics amplía la lista de acciones admitidas con dos acciones necesarias para enviar datos a los servidores de seguimiento: Set Variables y Send Beacon.

Para realizar el seguimiento de los visores de Dynamic Media, es posible utilizar cualquiera de los siguientes tipos:

  • Eventos de la extensión de visores de Dynamic Media, la extensión principal o cualquier otra extensión.
  • Condiciones de la definición de regla. O bien, puede dejar vacío el área de condiciones.

En la sección Actions , es necesario que tenga una acción Set Variables. Esta acción indica a Adobe Analytics cómo rellenar variables de seguimiento con datos. Al mismo tiempo, la acción Set Variables no envía nada al servidor de seguimiento.

La acción Set Variables debe ir seguida de una acción Send Beacon. La acción Send Beacon realmente envía datos al servidor de seguimiento de Analytics. Ambas acciones, Set Variables y Send Beacon, provienen de la extensión de Adobe Analytics.

Consulte Reglas en la Guía del usuario de etiquetas del Experience Platform.

Configuración de ejemplo

La siguiente configuración de ejemplo en Etiquetas de Experience Platform muestra cómo rastrear un nombre de recurso al cargar el visor.

  1. En la pestaña Data Elements, defina un elemento de datos AssetName que haga referencia al parámetro asset del evento LOAD desde la extensión Visualizadores de Dynamic Media.

    image2019-11

  2. En la pestaña Rules, defina una regla TrackAssetOnLoad.

    En esta regla, el campo Event utiliza el evento LOAD de la extensión Visualizadores de Dynamic Media.

    image2019-22

  3. La configuración de acción tiene dos tipos de acción de la extensión de Adobe Analytics:

    Establezca Variables, que asignan una variable de análisis de su elección al valor del elemento de AssetName datos.

    Send Beacon, que envía información de seguimiento a Adobe Analytics.

    image2019-3

  4. La configuración de regla resultante se muestra de la siguiente manera:

    image2019-4

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 habilitar el seguimiento de vídeo en la configuración de extensión Dynamic Media Viewers. Las métricas de vídeo están disponibles en Adobe Analytics. El seguimiento de vídeo depende de la presencia de la extensión de audio y vídeo de Adobe Medium Analytics.

Consulte Instalación y configuración de extensiones.

Actualmente, la compatibilidad con el seguimiento de vídeo está limitada únicamente al seguimiento de "reproducción principal", 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.

Utilice la extensión Visualizadores de Dynamic Media

Como se menciona en Ejemplos de uso de la integración, es posible rastrear los visores de Dynamic Media con la nueva integración de etiquetas de Experience Platform en sitios de Experience Manager y utilizando el código incrustado.

Seguimiento de visualizadores de Dynamic Media en sitios de Experience Manager

Para realizar un seguimiento de los visores de Dynamic Media en sitios de Experience Manager, se deben realizar todos los pasos enumerados en la sección Configure all the integration items . Específicamente, debe crear la configuración de IMS y la configuración de nube de etiquetas de Experience Platform.

Siguiendo la configuración adecuada, cualquier visor de Dynamic Media que agregue a una página Sitios mediante un componente WCM compatible con Dynamic Media, rastreará automáticamente los datos en Adobe Analytics, Adobe Analytics para vídeo o ambos.

Consulte Agregar recursos de Dynamic Media a páginas mediante sitios de Adobe.

Seguimiento de visualizadores de Dynamic Media mediante el código incrustado

Los clientes que no utilicen Sitios Experience Manager o que incrusten visores de Dynamic Media en páginas web fuera de Sitios Experience Manager, o ambas, pueden seguir utilizando la integración Etiquetas de Experience Platform .

Complete los pasos de configuración de las secciones Configurar Adobe Analytics y Configurar etiquetas de Experience Platform. Sin embargo, no es necesario realizar pasos de configuración relacionados con el Experience Manager.

Siguiendo la configuración adecuada, puede agregar compatibilidad con etiquetas de Experience Platform a una página web con un visor de Dynamic Media.

Consulte Agregar el código incrustado de etiquetas de Experience Platform para obtener más información sobre cómo utilizar el código incrustado de la biblioteca de etiquetas de Experience Platform.

Para obtener más información sobre cómo utilizar la función de código incrustado de Experience Manager Dynamic Media, consulte Incrustación del visualizador de imágenes o vídeos en una página web.

Rastree los visores de Dynamic Media mediante el 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 de etiquetas de Experience Platform iniciando sesión en Etiquetas de Experience Platform (consulte Configuración de etiquetas de Experience Platform).
  3. Seleccione Property y luego seleccione la pestaña Environments.
  4. Elija el nivel Entorno que sea relevante para el entorno de la página web. A continuación, en la columna Install, seleccione el icono de cuadro.
  5. En el cuadro de diálogo Instrucciones de instalación web , copie el código incrustado completo de la biblioteca de etiquetas de Experience Platform, junto con las <script/> etiquetas que lo rodean.

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

Acerca de la configuración de los visores de Dynamic Media

La extensión del visor de Dynamic Media se integra automáticamente con la biblioteca de etiquetas de Experience Platform si las siguientes condiciones son verdaderas:

  • El objeto global de la biblioteca de etiquetas de Experience Platform ( _satellite) está presente en la página.

  • La función _dmviewers_v001() de extensión de visores de Dynamic Media se define en _satellite.

  • config2= no se ha especificado el parámetro del visor, lo que significa que el visor no utiliza la integración heredada de Analytics.

Además, existe la opción de deshabilitar explícitamente la integración de etiquetas de Experience Platform en el visor especificando el parámetro launch=0 en la configuración del visor. El valor predeterminado de este parámetro es 1.

Configurar la extensión Visualizadores de Dynamic Media

La única opción de configuración para la extensión Visualizadores de Dynamic Media es Habilitar Adobe Medium Analytics para audio y vídeo.

Cuando marca (activa) esta opción y la extensión de audio y vídeo de Adobe Medium Analytics está instalada y configurada, 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.

Si activa esta opción sin tener instalada la extensión de Adobe Medium Analytics para audio y vídeo, la opción no causa ningún efecto.

image2019-7-22_12-4-23

Acerca de los elementos de datos en la extensión Visualizadores 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 : argumento del evento de visor de Dynamic Media seleccionado.

image2019-7-22_12-5-46

Consulte la Guía de referencia de visores de Dynamic Media para obtener una lista de los eventos admitidos por cada tipo de visor; vaya a la sección específico del visor y, a continuación, seleccione la subsección Compatibilidad con el seguimiento de Adobe Analytics . Actualmente, la guía de referencia de visores de Dynamic Media no documenta argumentos de eventos.

Consideremos ahora el ciclo de vida de los visualizadores de Dynamic Media Data Element. El valor de dicho elemento de datos se rellena después de que el evento del visor de Dynamic Media correspondiente se produzca en la página. Por ejemplo, supongamos que el elemento de datos apunta al evento LOAD y a su argumento "asset". El valor de este elemento de datos recibe datos válidos después de que el visor ejecute el evento LOAD por primera vez. Si el elemento de datos señala al evento ZOOM y a su argumento "scale", el valor de dicho elemento de datos permanece vacío hasta que el usuario envía un evento ZOOM por primera vez.

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, supongamos que el elemento de datos ZoomScale está definido para el parámetro "scale" del evento ZOOM. Sin embargo, 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 visor.

Cualquier visualizador de Dynamic Media tiene un identificador único en la página web. El elemento de datos rastrea el propio valor y el visualizador que lo ha rellenado. Por ejemplo, supongamos que 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 devuelto por el elemento de datos depende del contexto. Si se solicita el elemento de datos en una regla que se activó mediante un evento del visor de Dynamic Media, se devuelve el valor del elemento de datos para el visualizador que inició la regla. Además, el elemento de datos se solicita en una regla que se activó mediante un evento desde otra extensión de etiquetas de Experience Platform. En este punto, el valor del elemento de datos proviene del último visor que actualizó este elemento de datos.

Considere la siguiente configuración de ejemplo:

  • Una página web con dos visores de zoom Dynamic Media: visor1 y visor2.

  • ​El elemento ZoomScaleData apunta al ​evento ZOOM y su argumento "scale".

  • ​TrackPanRule con lo siguiente:

    • Utiliza el evento PAN del Visor de Dynamic Media como déclencheur.
    • Envía el valor del elemento de datos ZoomScale a Adobe Analytics.
  • ​TrackKeyRule con lo siguiente:

    • Utiliza el evento de prensa clave de la extensión de etiquetas del Experience Platform principal como déclencheur.
    • 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, aumentan la escala al 50%; a continuación, en viewer2, aumentan la escala al 25%. En viewer1, recorren la imagen y finalmente presionan una tecla en el teclado.

La actividad del usuario final provoca 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 aterriza en viewer1. Esa llamada envía el 50 % como valor de ZoomScale Data Element porque el elemento de datos sabe que la regla se activa mediante viewer1 y recupera el valor de escala correspondiente;
  • La segunda llamada se produce porque la regla TrackKey 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 anteriormente 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 etiquetas de Experience Platform incluso después de que el propio visor se haya eliminado en la página web. Esta funcionalidad significa que si hay una regla activada 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 visualizadores de Dynamic Media no se almacenan en el almacenamiento local ni en el servidor; en su lugar, solo se mantienen en la biblioteca de etiquetas del Experience Platform del lado del cliente. Los valores de dicho elemento de datos desaparecen cuando la página web se vuelve a cargar.

Por lo general, 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 Visualizadores de Dynamic Media solo admiten la opción de duración del almacenamiento None. Es posible establecer cualquier otro valor en la interfaz de usuario, pero el comportamiento del elemento de datos no está definido en este caso. La extensión administra el valor del elemento de datos por su cuenta: 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 Visualizadores de Dynamic Media

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

Acerca del editor de eventos

En el editor de eventos, la extensión Visualizadores de Dynamic Media agrega un Tipo de evento denominado Evento de visualizador.

Cuando se selecciona, el editor de eventos procesa la lista desplegable Dynamic Media Viewer events, que enumera todos los eventos disponibles compatibles con los visores de Dynamic Media.

image2019-8-2_15-13-1

Acerca del editor de acciones

La extensión Visualizadores de Dynamic Media permite utilizar parámetros de evento de visualizadores de Dynamic Media para asignarlos a variables de análisis en el editor Set Variables de la extensión de Adobe Analytics.

El método más sencillo para ello 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 del visualizador de Dynamic Media.
  • Por último, en el editor Set Variables de la extensión de Adobe Analytics, seleccione el icono del selector de elementos de datos (tres discos apilados) para abrir el cuadro de diálogo Select Data Element (Seleccionar elemento de datos) y, a continuación, seleccione un elemento de datos de él.

image2019-7-10_20-41-52

Sin embargo, es posible utilizar un enfoque alternativo y evitar la creación de elementos de datos. Puede hacer referencia directamente a un argumento desde un evento de visualizador de Dynamic Media. Introduzca el nombre completo del argumento de evento en el campo de entrada value de la asignación de variables de Analytics. Asegúrese de rodear los signos de porcentaje (%). Por ejemplo,

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

Existe una diferencia importante entre el uso de elementos de datos y la referencia de argumentos de eventos directos. Para el elemento de datos, no importa qué evento déclencheur la acción Set Variables. El evento que déclencheur la regla puede no estar relacionado con el visualizador dinámico (como seleccionar la página web de la extensión principal). Sin embargo, cuando se utiliza una referencia de argumento directo, es importante asegurarse de que el evento que déclencheur 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.

En la tabla siguiente se enumeran los eventos de visualizador 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%

Configurar todos los elementos de integración

ANTES DE COMENZAR

Adobe recomienda revisar toda la documentación antes de esta sección para 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 Visualizadores de Dynamic Media para otros fines en Etiquetas de Experience Platform, estos escenarios no se tratan en esta documentación.

Para configurar la integración, debe utilizar los siguientes productos de Adobe:

  • Adobe Analytics: se utiliza para configurar variables de seguimiento e informes.
  • Etiquetas de Experience Platform: se utilizan para definir una propiedad, una o varias reglas y uno o varios elementos de datos para habilitar el seguimiento del visualizador.

Además, si esta solución de integración se utiliza con Experience Manager Sites, se debe realizar la siguiente configuración:

  • Consola de Adobe I/O : la integración se crea para etiquetas de Experience Platform.
  • Nodo de creación de Experience Manager : configuración de IMS y configuración de nube de etiquetas de Experience Platform.

Como parte de la configuración, asegúrese de tener acceso a una empresa de Adobe Experience Cloud que ya tenga habilitadas las etiquetas de Adobe Analytics y Experience Platform.

Configuración de Adobe Analytics para la integración

Después de configurar Adobe Analytics, se configurará lo siguiente para la integración:

  • Hay un grupo de informes listo y seleccionado.
  • Las variables de Analytics están disponibles para recibir datos de seguimiento.
  • Los informes están disponibles para ver los 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. Para empezar, acceda a Adobe Analytics desde la página principal del Experience Cloud. En la barra de menús, seleccione 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, seleccione Analytics.

    22-07-2019-18-08-47

    Ahora, seleccione un grupo de informes.

Seleccionar 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 el siguiente ejemplo, un usuario creó un grupo de informes denominado DynamicMediaViewersExtensionDoc y lo seleccionó en la lista desplegable. El nombre del grupo de informes es solo un ejemplo. El nombre del grupo de informes que seleccione en última instancia depende de usted.

    Si no hay ningún grupo de informes disponible, usted o el administrador de Adobe Analytics deben crear uno antes de continuar con la configuración.

    Consulte Informes y grupos de informes y Crear un grupo de informes.

    En Adobe Analytics, los grupos de informes se administran en Administración > Grupos de informes.

    22-07-2019-18-09-49

    Ahora, configure variables de Adobe Analytics.

Configuración de variables de Adobe Analytics

  1. Designe una o más variables de Adobe Analytics que desee usar para rastrear el comportamiento de los visualizadores 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 Tráfico personalizado [props], Conversión [eVar]) se debe a las necesidades específicas de la implementación de Analytics.

    Consulte Información general sobre props y eVars.

    A los 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 pocos minutos siguientes a que se produzca una acción en una página web.

    Para habilitar una nueva variable de tráfico personalizado, en Adobe Analytics, en la barra de herramientas, vaya a Administración > Grupos de informes.

  2. En la página Administrador del grupo de informes , seleccione el informe correcto y, en la barra de herramientas, vaya a Editar configuración > Tráfico > Variables de tráfico.

  3. Elija una variable no utilizada, asígnele un nombre descriptivo ( Recurso del visualizador (prop 30)) y, a continuación, cambie el cuadro combinado a "Habilitado" en la columna Activado.

    La siguiente captura de pantalla es un ejemplo de una variable de tráfico personalizado ( prop30) para rastrear el nombre de un recurso que usa el visor:

    image2019-6-26_23-6-59

  4. En la parte inferior de la lista de variables, seleccione Guardar.

Configuración de informes

  1. Por lo general, la configuración de un informe en Adobe Analytics depende de necesidades específicas del proyecto. De este modo, la configuración detallada del informe excede el ámbito de esta integración.

    Sin embargo, basta con saber que los informes Tráfico personalizado estarán disponibles automáticamente en Adobe Analytics después de configurar las variables Tráfico personalizado en Configuración de variables de Adobe Analytics.

    Por ejemplo, el informe de la variable 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.

    image2019-6-26_23-12-49

Configuración de etiquetas de Experience Platform para la integración

Después de configurar las etiquetas de Experience Platform, 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 del lado del cliente de todas las extensiones instaladas en la propiedad se compila en una biblioteca. Esta biblioteca la utiliza la página web más adelante.
  • Configuración de elementos de datos y reglas. Esta configuración define qué datos adquirir de los visualizadores de Dynamic Media, cuándo almacenar en déclencheur la lógica de seguimiento y dónde enviar los datos del visualizador en Adobe Analytics.
  • Publicación de la biblioteca.

Para configurar las etiquetas de Experience Platform para la integración:

  1. Para empezar, acceda a Etiquetas de Experience Platform desde la página principal del Experience Cloud. En la barra de menús, seleccione el icono Soluciones (tres por tres tablas de puntos) cerca de la esquina superior derecha de la página y, a continuación, seleccione Etiquetas.

    También puede abrir las etiquetas del Experience Platform directamente.

    image2019-7-8_15-38-44

Crear una propiedad en etiquetas de Experience Platform

Una propiedad en Etiquetas de Experience Platform es una configuración con nombre que mantiene juntos todos los ajustes. Se genera y publica una biblioteca de los ajustes de configuración en diferentes niveles de entorno (desarrollo, ensayo y producción).

Consulte también Crear una propiedad de etiquetas.

Para crear una propiedad en etiquetas de Experience Platform:

  1. En Etiquetas de Experience Platform, seleccione 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 Domains, 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.

    image2019-7-8_16-3-47

  5. Seleccione Guardar.

    Seleccione la propiedad recién creada y continúe con Instalación y configuración de extensiones.

Instalación y configuración de extensiones

Todas las extensiones disponibles en Etiquetas de Experience Platform se enumeran en Extensiones > Catálogo.

Para instalar una extensión, seleccione Install. Si es necesario, realice una configuración de extensión única y, a continuación, seleccione Guardar.

Cuando sea necesario, deben instalarse y configurarse las siguientes extensiones:

  • Extensión servicio de ID de Experience Cloud (obligatorio)

No se necesita ninguna configuración adicional, acepte los valores propuestos. Cuando haya terminado, asegúrese de seleccionar Guardar.

Consulte Extensión del servicio de identidad de Experience Cloud.

  • Extensión Adobe Analytics (obligatoria)

Para configurar esta extensión, necesita la ID del grupo de informes que se encuentra en Adobe Analytics, en Administración > Grupo de informes, en el encabezado de columna ID del grupo de informes.

(Solo con fines de demostración, el ID del grupo de informes DynamicMediaViewersExtensionDoc se utiliza en las siguientes capturas de pantalla. Este ID se creó y utilizó en Selección de un grupo de informes anteriormente).

image2019-7-8_16-45-34

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.

image2019-7-8_16-47-40

Configure el siguiente elemento solo si quiere 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.

Seleccione Guardar.

Consulte Extensión de Adobe Analytics.

  • (Opcional. Extensión Adobe Medium Analytics for Audio and Video requerida solo si se necesita seguimiento de vídeo)

Rellene el campo servidor de seguimiento . El servidor de seguimiento para la extensión Adobe Medium Analytics para audio y vídeo es diferente del servidor de seguimiento utilizado para Adobe Analytics. Sigue a la plantilla <trackingNamespace>.hb.omtrdc.net, donde <trackingNamespace> es la información del correo electrónico de aprovisionamiento.

Todos los demás campos son opcionales.

Consulte Extensión de Adobe Medium Analytics for Audio and Video.

  • Extensión Dynamic Media Viewers (obligatoria)

Seleccione habilitar Adobe Analytics para vídeo para activar el seguimiento de Video Heartbeat.

Al momento de escribir este artículo, la extensión Dynamic Media Viewers solo está disponible si la propiedad de etiquetas de Experience Platform se ha creado para el desarrollo.

Consulte Creación de una propiedad en Etiquetas de Experience Platform.

Una vez instaladas y configuradas las extensiones, como mínimo, las siguientes cinco extensiones (cuatro si no realiza el seguimiento de vídeo) se enumerarán en el área Extensiones > Instaladas .

image2019-7-22_12-7-36

Configuración de elementos de datos y reglas

En Etiquetas de Experience Platform, cree los elementos de datos y las reglas necesarias para rastrear los visores de Dynamic Media.

Consulte Funcionamiento del seguimiento de datos y eventos en la integración para obtener información general sobre el seguimiento con etiquetas de Experience Platform.

Consulte Configuración de muestra para ver un ejemplo de configuración en Etiquetas de Experience Platform que muestra cómo rastrear un nombre de recurso al cargar el visor.

Consulte Configurar la extensión de visores de Dynamic Media para obtener información detallada sobre las capacidades de la extensión.

Publicar una biblioteca

Para cambiar la configuración de Etiquetas de Experience Platform (incluidas la propiedad, las extensiones, las reglas y los elementos de datos configurados), debe publicar estos cambios. La publicación en etiquetas de Experience Platform se realiza desde la pestaña Publicación en la configuración de la propiedad.

Las etiquetas de Experience Platform pueden tener varios entornos de desarrollo, un entorno de ensayo y un entorno de producción. De forma predeterminada, la Configuración de nube de etiquetas de Experience Platform en el Experience Manager señala el nodo de creación de Experience Manager al entorno de ensayo de las etiquetas de plataforma. El nodo Publicación de Experience Manager apunta al entorno Producción de etiquetas de Experience Platform. Esta disposición significa que con la configuración predeterminada del Experience Manager, es necesario publicar la biblioteca de etiquetas del Experience Platform en el entorno de ensayo. Al hacerlo, puede utilizarlo en el autor del Experience Manager. A continuación, puede publicarlo en el entorno Producción para que se pueda utilizar en la publicación en Experience Manager.

Consulte Entornos para obtener más información sobre los entornos de Etiquetas de Experience Platform.

La publicación de una biblioteca implica los dos pasos siguientes:

  • Agregar y crear una nueva biblioteca incluyendo todos los cambios necesarios (nuevos y actualizaciones) en la biblioteca.
  • Mover hacia arriba la biblioteca a través de los diferentes niveles de entorno (de Desarrollo a Ensayo y Producción).

Agregar y crear una nueva biblioteca

  1. La primera vez que abra la ficha Publicación en Etiquetas de Experience Platform, la lista de la biblioteca estará vacía.

    En la columna izquierda, seleccione Agregar nueva biblioteca.

    image2019-7-15_14-43-17

  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 Entorno . Inicialmente, solo el nivel de desarrollo está disponible para la selección. Cerca del lado inferior izquierdo de la página, seleccione Agregar todos los recursos modificados.

    image2019-7-15_14-49-41

  3. Cerca de la esquina superior derecha de la página, seleccione Guardar y crear para desarrollo.

    En unos minutos, la biblioteca se creará y estará lista para utilizarse.

    image2019-7-15_15-3-34

    NOTA

    La próxima vez que cambie la configuración de Etiquetas de Experience Platform, vaya a la pestaña Publicación en la configuración Propiedad y seleccione la biblioteca creada anteriormente.

    En la pantalla de publicación de la biblioteca, seleccione Agregar todos los recursos modificados y, a continuación, seleccione Guardar y crear para desarrollo.

Mover hacia arriba una biblioteca a través de los niveles de entorno

  1. Una vez agregada una nueva biblioteca, se encuentra en el entorno de desarrollo. Para moverlo al nivel de entorno de ensayo (que corresponde a la columna Enviado ), en el menú desplegable de la biblioteca, seleccione Enviar para aprobación.

    image2019-7-15_15-52-37

  2. En el cuadro de diálogo de confirmación, seleccione Enviar.

    Una vez que la biblioteca se mueva a la columna Enviado , en el menú desplegable de la biblioteca, seleccione Generar para ensayo.

    image2019-7-15_15-54-37

  3. Para mover la biblioteca del entorno de ensayo al entorno de producción (que es la columna Publicado ), siga un proceso similar.

    En primer lugar, en el menú desplegable, seleccione Aprobar para publicación.

    image2019-7-15_16-7-39

  4. En el menú desplegable, seleccione Generar y publicar en producción.

    image2019-7-15_16-8-9

    Consulte Publicación para obtener más información sobre el proceso de publicación en Etiquetas de Experience Platform.

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

Requisitos previos:

  • Experience Manager ejecuta las instancias Autor y Publicar .
  • El nodo de creación de Experience Manager está configurado en Dynamic Media.
  • Los componentes WCM de Dynamic Media están activados en Sitios de Experience Manager.

La configuración del Experience Manager consta de los dos pasos principales siguientes:

  • Configuración de IMS Experience Manager.
  • Configuración de la nube de etiquetas de Experience Platform.

Configuración de IMS de Experience Manager

  1. En el autor del Experience Manager, seleccione el icono Herramientas (martillo) y vaya a Seguridad > Configuraciones de IMS de Adobe.

    2019-07-25_11-52-58

  2. En la página Configuración de IMC de Adobe, cerca de la esquina superior izquierda, seleccione Crear.

  3. En la página Adobe IMS Technical Account Configuration, en la lista desplegable Cloud Solution, seleccione Experience Platform Data Collection.

  4. Active Crear nuevo certificado y, a continuación, en el campo de texto, introduzca cualquier valor significativo para el certificado. Por ejemplo, AdobeLaunchIMSCert. Seleccione Crear certificado.

    Se muestra el siguiente mensaje de información:

    Para recuperar un token de acceso válido, la nueva clave pública del certificado debe agregarse a la cuenta técnica en el Adobe I/O.

    Para cerrar el cuadro de diálogo Información, seleccione Aceptar.

    24-07-25_12-2019

  5. Seleccione Descargar clave pública para descargar un archivo de clave pública (*.crt) en el sistema local.

    NOTA

    En este punto, deje abierta la página Configuración de cuenta técnica de IMS de Adobe; no cierre la página y no seleccione Siguiente. Volverá a esta página más adelante en los pasos.

    24-07-25_12-52-2019

  6. En una nueva pestaña del explorador, vaya a la Consola de Adobe I/O.

  7. En la página Integraciones de la consola de Adobe I/O, cerca de la esquina superior derecha, seleccione Nueva integración.

  8. En el cuadro de diálogo Crear una nueva integración, asegúrese de que el botón de opción Acceder a una API esté seleccionado y, a continuación, seleccione Continuar.

    2019-07-25_13-04-20

  9. En la segunda página Create a new integration, active el botón de opción Experience Platform Tags API. En la esquina inferior derecha de la página, seleccione Continue.

    2019-07-25_13-13-54

  10. En la tercera Crear una nueva página de integración, haga lo siguiente:

    • En el campo Name, introduzca un nombre descriptivo. Por ejemplo, DynamicMediaViewersIO.

    • En el campo Description, introduzca la descripción de la integración.

    • En el área Public key certificates , cargue el archivo de clave pública (*.crt) que descargó anteriormente en estos pasos.

    • En el encabezado Seleccione una función para la API de etiquetas de Experience Platform, seleccione Administración.

    • En el encabezado Seleccione uno o varios perfiles de producto para la API de etiquetas de Experience Platform, seleccione el perfil de producto denominado Etiquetas - <your_company_name>.

    2019-07-25_13-49-18

  11. Seleccione Crear integración.

  12. En la página Integration created, seleccione Continue to integration details.

    2019-07-25_14-16-33

  13. Aparece una página de detalles Integraciones , similar a la siguiente:

    NOTA

    Deje abierta esta página de detalles de integración. En un momento necesitará información de las pestañas Overview y JWT.

    2019-07-25_14-35-30
    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, seleccione Siguiente para abrir la página Cuenta en la ventana Configuración de cuenta técnica de Adobe IMS.

    (Si ha cerrado la página anteriormente, vuelva al autor del Experience Manager y vaya a Tools > Security > Adobe IMS Configurations. Seleccione Crear. En la lista desplegable Cloud Solution, seleccione Etiquetas de Experience Platform. En la lista desplegable Certificado, seleccione el nombre del certificado creado anteriormente.

    2019-07-25_20-57-50
    Configuración de cuenta técnica de Adobe IMS: página Certificado

  15. La página Cuenta tiene cinco campos que requieren que rellene con información de la página de detalles de la integración del paso anterior.

    2019-07-25_20-42-45
    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. Seleccione la pestaña JWT. Copie el nombre del servidor (sin la ruta de acceso) como se indica a continuación.

(el nombre de servidor de ejemplo es solo para fines explicativos) 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 de servidor de ejemplo es solo para fines explicativos)

2019-07-25_15-01-53
Página de detalles de integración: pestaña JWT

  1. Clave de API: Vuelva a la página de detalles de la integración. Seleccione la pestaña Overview y, a continuación, a la derecha del campo API Key (Client ID), seleccione Copy.

    Vuelva a la página Cuenta y pegue la clave en el campo correspondiente.

    2019-07-25_14-35-333
    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 Overview, seleccione Retrieve Client Secret. A la derecha del campo Client secret, seleccione Copy.

    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 la integración. Desde la pestaña 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.

    2019-07-25_21-59-12
    Página de detalles de integración: pestaña JWT

    La página Cuenta, con todos los campos rellenados, aparece de manera similar a:

    2019-07-25_22-08-30

  4. Cerca de la esquina superior derecha de la página Cuenta, seleccione Crear.

    Con el Experience Manager IMS configurado, ahora tiene un nuevo IMSAccount enumerado en Configuraciones de IMS de Adobe.

    image2019-7-15_14-17-54

Configuración de Experience Platform Tags Cloud para la integración

  1. En el autor del Experience Manager, cerca de la esquina superior izquierda, seleccione el icono Herramientas (martillo) y vaya a Cloud Services > Configuraciones de etiquetas de Experience Platform.

    26-12-10-38

  2. En la página Configuraciones de etiquetas de Experience Platform, en el panel izquierdo, seleccione un sitio de Experience Manager para el que desee aplicar la configuración de etiquetas de Experience Platform.

    Solo con fines de ejemplo, el We.Retail Sitio se selecciona en la captura de pantalla siguiente.

    26-12-2019-07-20-06

  3. Cerca de la esquina superior izquierda de la página, seleccione Crear.

  4. En la página General (1/3 páginas) de la ventana Crear configuración de etiquetas de Experience Platform, rellene los campos siguientes:

    • Título : introduzca un título de configuración descriptivo. Por ejemplo, We.Retail Tags cloud configuration.

    • Configuración de IMS de Adobe asociado : seleccione la configuración de IMS que creó anteriormente en Configurar IMS de Experience Manager.

    • Empresa : en la lista ​desplegable Empresa, seleccione la empresa Experience Cloud. La lista se rellena automáticamente.

    • Propiedad : en la lista desplegable Propiedad, seleccione la propiedad Etiquetas de Experience Platform 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:

    image2019-7-15_14-34-23

  5. Cerca de la esquina superior izquierda, seleccione Siguiente.

  6. En la página Ensayo (2/3 páginas) de la ventana Crear configuración de etiquetas de Experience Platform, rellene el siguiente campo:

    En el campo URI de biblioteca (Identificador uniforme de recurso), compruebe la ubicación de la versión de ensayo de la biblioteca de etiquetas de Experience Platform. El Experience Manager rellena este campo automáticamente.

    Solo para fines explicativos, este paso utiliza bibliotecas de etiquetas de Experience Platform implementadas en CDN de Adobe.

    NOTA

    Compruebe que el URI de biblioteca rellenado automáticamente (identificador uniforme de recursos) no tenga un formato incorrecto. Si es necesario, corríjalo para que el URI represente un URI relativo al protocolo. Es decir, comienza con una barra doble hacia adelante.

    Por ejemplo: //assets.adobetm.com/launch-xxxx.

    Es probable que la página Ensayo aparezca similar a la siguiente. Las opciones Archivar y Cargar biblioteca asincrónicamente están no configuradas:

    image2019-7-15_15-21-8

  7. Cerca de la esquina superior derecha, seleccione Siguiente.

  8. En la página Producción (3/3 páginas) de la ventana Crear configuración de etiquetas de Experience Platform, 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, seleccione Crear.

    La nueva configuración de nube de etiquetas de Experience Platform ahora se crea y aparece junto al sitio web.

  10. Seleccione la nueva configuración de nube de etiquetas de Experience Platform (cuando esté seleccionada, aparece una marca de verificación a la izquierda del título de configuración). En la barra de herramientas, seleccione Publicar.

    image2019-7-15_15-47-6

Actualmente, el autor del Experience Manager no admite la integración de visores de Dynamic Media con etiquetas de Experience Platform.

Sin embargo, se admite en el nodo de publicación de Experience Manager. Con la configuración predeterminada de la nube de etiquetas de Experience Platform, la publicación en Experience Manager utiliza el entorno de producción de etiquetas de Experience Platform. Como tal, es necesario insertar las actualizaciones de la biblioteca de etiquetas de Experience Platform desde Desarrollo hasta el entorno de producción cada vez que se realiza la prueba.

Es posible solucionar esta limitación. Especifique la URL de desarrollo o de ensayo de la biblioteca de etiquetas de Experience Platform en la configuración de Experience Platform Tags Cloud para la publicación de Experience Manager anterior. Al hacerlo, el nodo de publicación del Experience Manager utiliza la versión de desarrollo o ensayo de la biblioteca de etiquetas del Experience Platform.

Consulte Integrar etiquetas de Experience Platform y Experience Manager para obtener más información sobre la configuración de la nube de etiquetas de Experience Platform.

En esta página