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

Última actualización: 2023-11-07
  • Temas:
  • Viewers
    Ver más sobre este tema
  • Creado para:
  • User
    Admin
    Developer

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

Visores de Dynamic Media para Experience Platform Tags y Dynamic Media Viewers 5.13, permite a los clientes de Adobe Analytics y Experience Platform Tags utilizar eventos y datos específicos para Dynamic Media Viewers en su configuración de etiquetas de Experience Platform.

Esta integración significa que puede rastrear el uso de los visualizadores de Dynamic Media en su sitio web con Adobe Analytics. Al mismo tiempo, puede utilizar los eventos y los datos expuestos por los visualizadores con cualquier otra extensión de etiquetas de Experience Platform que provenga de 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á diseñado para lo siguiente: Administradores de sitio, desarrolladores en el Experience Platform y personas en Operaciones.

Limitaciones de la integración

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

Casos de uso para la integración

El caso de uso principal de la integración con Experience Platform Tags son los clientes que utilizan Adobe Experience Manager Assets y Adobe Experience Manager Sites. En estos casos, puede configurar una integración estándar entre el nodo de creación de Experience Manager y las etiquetas de Experience Platform y, a continuación, asociar la instancia de Sites con la propiedad Etiquetas de Experience Platform. Después, cualquier componente WCM de Dynamic Media agregado a una página de Sites realizará un seguimiento de los datos y eventos de los visualizadores.

Consulte Seguimiento de visualizadores de Dynamic Media en Experience Manager Sites.

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

Consulte Seguimiento de visualizadores de Dynamic Media mediante código incrustado.

Funcionamiento de los datos y el seguimiento de eventos en la integración

La integración aprovecha dos tipos independientes y separados de seguimiento de visualizadores 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 le permite hacer un seguimiento de 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 las acciones de reproducción de vídeo.

En Etiquetas de Experience Platform, los conceptos de Elementos de datos y Reglas trabajen juntos para habilitar el seguimiento de Adobe Analytics.

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

Un elemento de datos en las etiquetas de Experience Platform 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 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 de etiquetas de Experience Platform. La extensión "Core" está preinstalada y disponible de forma predeterminada en cualquier configuración. Esta extensión "Core" permite definir un elemento de datos cuyo valor proviene de una cookie, un código JavaScript, una cadena de consulta y muchas otras fuentes.

Para el seguimiento de Adobe Analytics, se deben instalar varias extensiones más, como se describe en Instalación y configuración de extensiones. La extensión de visualizadores de Dynamic Media agrega la capacidad de definir un elemento de datos cuyo valor es un argumento del evento de visualizador dinámico. Por ejemplo, es posible hacer referencia al tipo de visor o al nombre del recurso notificado por el visor al cargar, al nivel de zoom notificado cuando el usuario final amplía o reduce la imagen y mucho más.

La extensión del visor de Dynamic Media mantiene automáticamente los valores de sus elementos de datos actualizados.

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

Consulte Elementos de datos.

Acerca de las reglas en etiquetas de Experience Platform

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

  • Eventos (if) indique a Experience Platform Tags cuándo almacenar en déclencheur una regla.
  • Condiciones (if) indique a las etiquetas de Experience Platform qué otras restricciones permitir o no permitir al activar una regla.
  • Acciones (entonces) indique al Experience Platform de etiquetas qué debe hacer cuando se activa una regla.

Las opciones disponibles en las secciones Eventos, Condiciones y Acciones dependen de las extensiones instaladas en la propiedad Etiquetas de Experience Platform. El Núcleo La extensión de está preinstalada y disponible de forma predeterminada en cualquier configuración. La extensión de proporciona varias opciones para Eventos, como acciones básicas a nivel de explorador. Estas acciones incluyen el cambio de enfoque, las pulsaciones de teclas y los envíos de formularios. También incluye opciones para Condiciones, como valor de la cookie, tipo de explorador y más. Para las acciones, solo está disponible la opción Código personalizado.

Para el seguimiento de Adobe Analytics, se deben instalar otras extensiones, 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 los visores de Dynamic Media, como la carga del visor, el intercambio de recursos, el acercamiento 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: Establecer variables y Send Beacon.

Para rastrear visualizadores de Dynamic Media, es posible utilizar cualquier tipo de lo siguiente:

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

En la sección Acciones, es necesario que tenga un Establecer variables acción. Esta acción le indica a Adobe Analytics cómo rellenar variables de seguimiento con datos. Al mismo tiempo, la variable Establecer variables La acción no envía nada al servidor de seguimiento.

El Establecer variables la acción debe ir seguida de una Send Beacon acción. El Send Beacon esta acción realmente envía datos al servidor de seguimiento de analytics. Ambas acciones, Establecer variables y Send Beacon, proceden de la extensión de Adobe Analytics.

Consulte Reglas.

Configuración de muestra

La siguiente configuración de ejemplo en Etiquetas de Experience Platform muestra cómo rastrear un nombre de recurso en la carga del visor.

  1. Desde el Elementos de datos pestaña, definir un elemento de datos AssetName que hace referencia a asset parámetro del LOAD de la extensión Visualizadores de Dynamic Media.

    image2019-11

  2. Desde el Reglas pestaña, definir una regla TrackAssetOnLoad.

    En esta regla, la variable Evento El campo utiliza el CARGAR 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:

    Establecer variables, que asignan una variable de análisis de su elección al valor de AssetName Elemento de datos.

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

    image2019-3

  4. La configuración de regla resultante tiene el siguiente aspecto:

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

Consulte Instalación y configuración de extensiones.

Actualmente, la compatibilidad con el seguimiento de vídeo se limita solo al seguimiento de "reproducción principal", tal como se describe en Resumen de seguimiento. En particular, no se admite QoS, anuncios, capítulos o segmentos ni el seguimiento de errores.

Uso de la extensión Visualizadores de Dynamic Media

Como se menciona en Casos de uso para la integraciónSin embargo, es posible rastrear los visualizadores de Dynamic Media con la nueva integración de Experience Platform Tags en Experience Manager Sites y utilizando el código incrustado.

Seguimiento de visualizadores de Dynamic Media en Experience Manager Sites

Para realizar un seguimiento de los visualizadores de Dynamic Media en Experience Manager Sites, siga todos los pasos que se enumeran en la sección Configurar todas las piezas de integración se debe realizar la sección. Específicamente, debe crear la configuración de IMS y la configuración de nube de etiquetas de Experience Platform.

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

Seguimiento de visualizadores de Dynamic Media mediante código incrustado

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

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

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

Consulte Añadir el código de incrustación 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.

Seguimiento de visualizadores 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 primero en Etiquetas de Experience Platform (consulte ) Configuración de etiquetas de Experience Platform).
  3. Seleccionar Propiedad, luego seleccione la Entornos pestaña.
  4. Elija el Nivel de entorno que sea relevante para el entorno de la página web. A continuación, en la Instalar , seleccione el icono del cuadro.
  5. En las instrucciones de instalación web , copie el código incrustado completo de la biblioteca de etiquetas de Experience Platform, junto con el código que lo rodea <script/> etiquetas.

Guía de referencia para la extensión Visualizadores 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 de etiquetas de Experience Platform si se cumplen las siguientes condiciones:

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

  • Función de extensión de visores de Dynamic Media _dmviewers_v001() 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 lo siguiente launch=0 en la configuración del visor. El valor predeterminado de este parámetro es 1.

Configuración de 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.

Al marcar (habilitar) esta opción y al instalar y configurar la extensión de Adobe Medium Analytics para audio y vídeo, las métricas de reproducción de vídeo se envían a la solución Adobe Analytics para audio y vídeo. Al deshabilitar esta opción, se desactiva el seguimiento de vídeo.

Si activa esta opción sin Con la extensión de Adobe Medium Analytics para audio y vídeo instalada, la opción no tiene 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 : un 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 la lista de eventos admitidos por cada tipo de visor; vaya a la sección específica 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 evento.

Ahora considere el ciclo de vida de los visualizadores de Dynamic Media Elemento de datos. El valor de este elemento de datos se rellena después de que el evento de visualizador de Dynamic Media correspondiente se produzca en la página. Por ejemplo, supongamos que el elemento de datos apunta a la variable CARGAR y su argumento "asset". En este caso, el valor de dicho elemento de datos recibe datos válidos después de que el visor ejecute el CARGAR por primera vez. Si el elemento de datos apunta a la variable ZOOM y su argumento "scale", el valor de dicho elemento de datos permanece vacío hasta que el visor envía un 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 se define para el parámetro "scale" del evento ZOOM. Sin embargo, la única regla presente en la configuración de regla se activa mediante la variable CARGAR evento. 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 realiza un seguimiento del valor mismo y del visualizador que lo ha rellenado. Por ejemplo, supongamos que hay varios visualizadores en la misma página y un AssetName Elemento de datos que apunta a CARGAR y su argumento "asset". El AssetName Data Element mantiene una colección de nombres de recursos asociados a cada visor cargado en la página.

El valor exacto devuelto por el elemento de datos depende del contexto. Si el elemento de datos se solicita en una regla activada por un evento de visualizador 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 activada por un evento de otra extensión de etiquetas de Experience Platform. En este punto, el valor del elemento de datos proviene del visor que actualizó por última vez este elemento de datos.

Tenga en cuenta la siguiente configuración de ejemplo:

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

  • ZoomScale El elemento de datos apunta a ZOOM y su argumento "scale".

  • TrackPan Regla con lo siguiente:

    • Utiliza el visor de Dynamic Media PANORÁMICA evento como déclencheur.
    • Envía el valor de ZoomScale Elemento de datos a Adobe Analytics.
  • TrackKey Regla con lo siguiente:

    • Utiliza el evento de pulsación de teclas de la extensión de etiquetas de Experience Platform principal como déclencheur.
    • Envía el valor de ZoomScale Elemento de datos a Adobe Analytics.

Ahora, supongamos que el usuario final carga la página web con los dos visores. Entrada visor1, se acercan a una escala del 50 %; a continuación, en visor2, se acercan a una escala del 25%. Entrada visor1, recorren la imagen y, finalmente, seleccionan 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 TrackPan La regla se activa cuando el usuario entra en pánico visor1. Esa llamada envía el 50 % como valor de ZoomScale Elemento de datos porque el elemento de datos sabe que la regla se activa por visor1 y obtiene el valor de escala correspondiente;
  • La segunda llamada se produce porque TrackKey La regla se activa cuando el usuario presiona una tecla del teclado. Esa llamada envía el 25 % como valor de ZoomScale Elemento de datos 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 biblioteca de etiquetas de Experience Platform incluso después de que el propio visor se haya eliminado de la página web. Esta funcionalidad significa que si hay una regla activada por una extensión que no sea Dynamic Media Viewer y que haga referencia a dicho elemento de datos, el elemento de datos devolverá el último valor conocido. Incluso si el visualizador 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 guardan en la biblioteca de etiquetas de Experience Platform del lado del cliente. Los valores de este elemento de datos desaparecen cuando se vuelve a cargar la página web.

Generalmente, el editor de elementos de datos admite selección de duración de 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 de Ninguno. Es posible configurar 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 abreviada 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 una Tipo de evento llamado Evento de visor.

Cuando se selecciona, el Editor de eventos procesa la lista desplegable Eventos de visor de Dynamic Media, donde se enumeran todos los eventos disponibles compatibles con los visualizadores 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 de Establecer variables de la extensión de Adobe Analytics.

El método más sencillo es completar el siguiente proceso en 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 visualizador de Dynamic Media.
  • Finalmente, en el editor Set Variables de la extensión de Adobe Analytics, seleccione Elemento de datos icono de selección (tres discos apilados) para abrir el cuadro de diálogo 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 la variable valor campo de entrada de la asignación de variables de Analytics. Asegúrese de rodearla con signos de porcentaje (%). Por ejemplo,

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

Hay una diferencia importante entre el uso de elementos de datos y la referencia de argumentos de evento directo. Para el elemento de datos, no importa qué déclencheur de evento provoquen la acción Establecer variables. El evento que déclencheur la regla puede no estar relacionado con el visualizador dinámico. Por ejemplo, si selecciona la página web en la Extensión principal. Sin embargo, al utilizar una referencia de argumento directo es importante asegurarse de que el evento que déclencheur la regla corresponda 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 todas las piezas de integración

ANTES DE COMENZAR

El 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 visualizadores de Dynamic Media con Adobe Analytics y Adobe Analytics para audio y vídeo. Aunque el uso de la extensión de visores de Dynamic Media para otros fines en etiquetas de Experience Platform es posible, estos escenarios no se tratan en esta documentación.

Va a utilizar los siguientes productos de Adobe para configurar su integración:

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

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

  • Adobe Developer Console : la integración se crea para las 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 de, asegúrese de que tiene acceso a una empresa de Adobe Experience Cloud que ya tiene 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 configura lo siguiente para la integración:

  • Se establece un grupo de informes y se selecciona.
  • 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. Comience accediendo a Adobe Analytics desde el Experience Cloud página principal. En la barra de menús, seleccione Soluciones icono (una tabla de tres por tres puntos) cerca de la esquina superior derecha de la página y, a continuación, seleccione Analytics.

    2019-07-22_18-08-47

    Ahora seleccione 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 captura de pantalla siguiente, 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 nombre de 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 para poder 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 Administrador > Grupos de informes.

    2019-07-22_18-09-49

    Ahora configure las variables de Adobe Analytics.

Configuración de variables de Adobe Analytics

  1. Designe una o más variables de Adobe Analytics que desee utilizar para realizar un seguimiento del 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]) depende de las necesidades específicas de su implementación de Analytics.

    Consulte Información general sobre props y eVars.

    A los efectos de esta documentación, solo se utiliza una variable de tráfico personalizado (props) porque está disponible en un informe de Analytics pocos minutos después de que se produzca una acción en una página web.

    Para habilitar una nueva variable Tráfico personalizado, vaya a Adobe Analytics, en la barra de herramientas Administrador > Grupos de informes.

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

  3. Seleccione una variable que no se utilice y asígnele un nombre descriptivo (Recurso del visor (prop 30)) y cambie el cuadro combinado a "Habilitado" en la columna Enabled.

    La siguiente captura de pantalla es un ejemplo de una variable de Tráfico personalizado ( prop30) para rastrear un nombre de recurso utilizado por el visor:

    image2019-6-26_23-6-59

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

Configuración de un informe

  1. Por lo general, la configuración de un informe en Adobe Analytics depende de las necesidades específicas del proyecto. Como tal, la configuración detallada de los informes está fuera del ámbito de esta integración.

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

    Por ejemplo, el informe de Recurso del visor (prop 30) está disponible en el menú Informes en Tráfico personalizado > Tráfico personalizado 21-30 > Recurso del visor (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 configura 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 junto en una biblioteca. La página web utiliza esta biblioteca más adelante.
  • Configuración de elementos de datos y reglas. Esta configuración define qué datos se deben capturar 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. Comience por acceder a las etiquetas de Experience Platform desde el Experience Cloud página principal. En la barra de menús, seleccione Soluciones icono (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 etiquetas de Experience Platform directamente.

    image2019-7-8_15-38-44

Creación de una propiedad en Etiquetas de Experience Platform

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

Consulte también Creación de una propiedad de etiquetas.

  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 Domains , introduzca el dominio del sitio web.

  4. En el Opciones avanzadas lista desplegable, habilitar Configure para el desarrollo de extensiones (no se puede modificar más adelante) en caso de que la extensión desee utilizar, en este caso, Visores de Dynamic Media: aún no se ha liberado.

    image2019-7-8_16-3-47

  5. Seleccione Guardar.

    Seleccione la propiedad recién creada y continúe a 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 Instalar. Si es necesario, realice una configuración de extensión única y seleccione Guardar.

Cuando sea necesario, se deben instalar y configurar las siguientes extensiones:

  • (Obligatorio) Servicio de ID de Experience Cloud extensión.

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

Consulte Extensión de Adobe Experience Cloud Identity Service.

  • (Obligatorio) Adobe Analytics extensión

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

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

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 planea utilizar el seguimiento de vídeo:

En el Instalar extensión página, expandir 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; solo es necesario si es necesario el seguimiento de vídeo) Adobe Medium Analytics para audio y vídeo extensión

Rellene el campo del servidor de seguimiento. El servidor de seguimiento para Adobe Medium Analytics para audio y vídeo La extensión de 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.

El resto de campos son opcionales.

Consulte Extensión de Adobe Medium Analytics para audio y vídeo.

  • (Obligatorio) Visores de Dynamic Media extensión

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

En el momento de escribir este artículo, Visores de Dynamic Media La extensión de solo está disponible si la propiedad Etiquetas de Experience Platform se crea para el desarrollo.

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

Una vez instaladas y configuradas las extensiones, y como mínimo, las cinco extensiones siguientes (cuatro si no realiza el seguimiento de vídeos) se enumeran 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 necesarios para realizar el seguimiento de los visualizadores de Dynamic Media.

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

Consulte Configuración de muestra para obtener una configuración de ejemplo en Etiquetas de Experience Platform que muestra cómo rastrear un nombre de recurso durante la carga del visor.

Consulte Configuración de la extensión Visualizadores de Dynamic Media para obtener información detallada sobre las funcionalidades de la extensión.

Publicar una biblioteca

Para cambiar la configuración de Etiquetas de Experience Platform (incluida la propiedad, las extensiones, las reglas y los elementos de datos configurados), debe publicar dichos 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 en la nube de etiquetas de Experience Platform en Experience Manager señala el nodo Autor de Experience Manager al entorno de ensayo de las etiquetas de Experience Platform. El nodo Publicación de Experience Manager apunta al entorno de 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 de 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 de producción para que se pueda utilizar en la publicación de 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:

  • Añadir y crear una nueva biblioteca incluyendo todos los cambios necesarios (nuevos y actualizaciones) en la biblioteca.
  • Desplazar la biblioteca a través de los diferentes niveles de entorno (desde Desarrollo hasta Ensayo y Producción).

Añadir y crear una nueva biblioteca

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

    En la columna izquierda, seleccione Añadir nueva biblioteca.

    image2019-7-15_14-43-17

  2. En la página Crear nueva biblioteca, en Nombre , introduzca un nombre descriptivo para la nueva biblioteca. Por ejemplo,

    DynamicMediaViewersLib

    En la lista desplegable Entorno, elija el Nivel de entorno. Inicialmente, solo está disponible el nivel de desarrollo para la selección. Cerca de la parte inferior izquierda de la página, seleccione Añadir todos los recursos modificados.

    image2019-7-15_14-49-41

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

    En unos minutos, la biblioteca se crea y está lista para usarse.

    image2019-7-15_15-3-34

    NOTA

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

    En la pantalla de publicación de la biblioteca, seleccione Añadir todos los recursos modificados, luego seleccione Guardar y generar para desarrollo.

Subir una biblioteca por los niveles de entorno

  1. Después de agregar una nueva biblioteca, se encuentra en el entorno de desarrollo. Para moverlo al nivel del 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 haya movido a la columna Submitted, 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.

    Primero, 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 Author y Publish.
  • El nodo de creación del Experience Manager está configurado en Dynamic Media - Modo de ejecución de Scene7 (dynamicmedia_s7)
  • Los componentes de Dynamic Media WCM están habilitados en Experience Manager Sites.

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

  • Configuración del IMS del Experience Manager.
  • Configuración de Experience Platform Tags Cloud.

Configuración de IMS de Experience Manager

  1. En Autor del Experience Manager, seleccione Herramientas (martillo) y, a continuación, 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 el Configuración de cuenta técnica de IMS de Adobe , en la Solución de nube , seleccione la opción Etiquetas de Experience Platform.

  4. Activar Crear nuevo certificado, luego, en el campo de texto, introduzca cualquier valor significativo para el certificado. Por ejemplo, AdobeLaunchIMSCert. Seleccionar Crear certificado.

    Se muestra el siguiente mensaje de información:

    Para recuperar un token de acceso válido, se añade la clave pública del nuevo certificado a la cuenta técnica de la consola de Adobe Developer.

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

    2019-07-25_12-09-24

  5. Para descargar un archivo de clave pública (*.crt) en el sistema local, seleccione Descargar clave pública.

    NOTA

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

    2019-07-25_12-52-24

  6. En una nueva pestaña del explorador, navegue hasta Adobe Developer Console.

  7. Desde el Integraciones de la consola Adobe Developer página, cerca de la esquina superior derecha, seleccione Nueva integración.

  8. En el Creación de una nueva integración , asegúrese de que Acceso a una API el botón de opción está seleccionado y, a continuación, seleccione Continuar.

    2019-07-25_13-04-20

  9. En el segundo Creación de una nueva integración página, activar (activar) la API de etiquetas de Experience Platform botón de opción. En la esquina inferior derecha de la página, seleccione Continuar.

    2019-07-25_13-13-54

  10. En la tercera Creación de una nueva integración , haga lo siguiente:

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

    • En el Descripción , introduzca una descripción para la integración.

    • En el Certificados de clave pública , cargue su archivo de clave pública (*.crt) que descargó anteriormente en estos pasos.

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

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

    2019-07-25_13-49-18

  11. Seleccionar Crear integración.

  12. En el Integración creada página, seleccione Continuar con los detalles de integración.

    2019-07-25_14-16-33

  13. Aparecerá la página de detalles de Integraciones, ​similar a lo siguiente:

    NOTA

    Deje abierta esta página de detalles de integración. Va a necesitar varios fragmentos de información de la Información general y JWT pestañas en un momento.

    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 Cuenta página en la Configuración de cuenta técnica de IMS de Adobe ventana.

    (Si ha cerrado la página anteriormente, regrese a Autor del Experience Manager y, a continuación, vaya a Herramientas > Seguridad > Configuraciones de IMS de Adobe. Seleccione Crear. En el Solución de nube , seleccione la opción 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 IMS de Adobe: página de certificado.

  15. El Cuenta tiene cinco campos que debe rellenar con información de la página Detalles de integración del paso anterior.

    2019-07-25_20-42-45

    Configuración de cuenta técnica de IMS de Adobe: página Cuenta.

  16. En el Cuenta , rellene los campos siguientes:

    • Título : introduzca un título descriptivo para la cuenta.
    • Servidor de autorización - Vuelva a la página de detalles de integración que abrió anteriormente. Seleccione el JWT pestaña. Copie el nombre del servidor (sin la ruta) como se indica a continuación.

    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 es solo un ejemplo)

    2019-07-25_15-01-53

    Página de detalles de la integración: pestaña JWT

  17. Clave de API: Vuelva a la página de detalles de la integración. Seleccione el Información general , a la derecha de la pestaña Clave de API (ID de cliente) , seleccione Copiar.

    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.

  18. Secreto del cliente: Regrese a la página de detalles de la integración. Desde el Información general pestaña, seleccione Recuperar secreto de cliente. A la derecha del Secreto de cliente , seleccione Copiar.

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

  19. Carga útil - Vuelva a la página de detalles de la integración. Desde el JWT pestaña, 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 la integración: pestaña JWT

    La página Cuenta, con todos los campos rellenados, tiene un aspecto similar al siguiente:

    2019-07-25_22-08-30

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

    Con el Experience Manager IMS configurado, ahora tiene una nueva cuenta IMSA 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 Experience Manager Author, cerca de la esquina superior izquierda, seleccione la opción Herramientas (martillo) y, a continuación, vaya a Cloud Service > Configuraciones de etiquetas de Experience Platform.

    2019-07-26_12-10-38

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

    Solo con fines de ejemplo, la variable We.Retail El sitio está seleccionado en la captura de pantalla siguiente.

    2019-07-26_12-20-06

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

  4. En el General página (1/3 páginas) del Configuración de Crear 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 Adobe IMS asociada - Seleccione la configuración de IMS que creó anteriormente en Configuración de IMS de Experience Manager.

    • Compañía - Desde el Compañía , seleccione su empresa de 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, su General La página será similar a la siguiente:

    image2019-7-15_14-34-23

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

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

    En el URI de biblioteca (Identificador de recurso uniforme), 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 de ejemplo, este paso utiliza bibliotecas de etiquetas de Experience Platform implementadas en CDN de Adobe.

    NOTA

    Asegúrese de que el URI de biblioteca (Identificador uniforme de recursos) rellenado automáticamente no tenga un formato incorrecto. Si es necesario, corríjalo de modo que el URI represente un URI relativo al protocolo. Es decir, comienza desde una barra diagonal doble.

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

    Su Ensayo es probable que la página tenga un aspecto similar al siguiente. El Archivar y Cargar biblioteca asincrónicamente Las opciones son no set:

    image2019-7-15_15-21-8

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

  8. En el Producción página (3/3 páginas) del Configuración de Crear etiquetas de Experience Platform , si es necesario, corrija el URI de producción rellenado automáticamente de forma similar a como se hizo en el Ensayo página.

  9. Cerca de la esquina superior derecha, seleccione Crear.

    La nueva configuración de nube de etiquetas de Experience Platform ahora se crea y se enumera junto al sitio web de forma similar al siguiente ejemplo:

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

    image2019-7-15_15-47-6

Actualmente, Experience Manager Author 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 del Experience Manager. Con la configuración predeterminada de la configuración de nube de etiquetas de Experience Platform, el nodo de publicación de 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 de Desarrollo al entorno de producción cada vez durante la prueba.

Es posible solucionar esta limitación. Especifique la URL de desarrollo o ensayo de la biblioteca de etiquetas de Platform en la configuración de nube de etiquetas de Experience Platform para el nodo de publicación 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 Experience Manager con etiquetas de Experience Platform mediante Adobe Developer Console para obtener más información sobre la configuración de la nube de etiquetas de Experience Platform.

En esta página