Configuración de Analytics para funciones de Communities analytics-configuration-for-communities-features

Información general overview

Adobe Analytics y Adobe Experience Manager AEM () son soluciones de Adobe Experience Cloud.

Adobe Analytics se puede configurar para AEM Communities de modo que, como miembro interactúe con las funciones de las Comunidades admitidas, se envíen eventos a Adobe Analytics desde el cual se generan los informes.

Por ejemplo, desde el sitio de la comunidad, los administradores pueden ver varios informes relacionados con la reproducción del vídeo.

Además, el análisis es necesario para lo siguiente:

Entre las funciones compatibles de Communities se incluyen:

En esta sección de la documentación se describe cómo conectar un grupo de informes de Analytics con funciones de Communities. Los pasos básicos son:

Requisitos previos prerequisites

Para configurar las características de Analytics para Communities, es necesario que trabaje con su representante de cuentas para configurar una cuenta de Adobe Analytics y grupo de informes. Una vez establecida, debe estar disponible la siguiente información:

Grupo de informes de Adobe Analytics para informes de vídeo adobe-analytics-report-suite-for-video-reporting

Con el Administrador de grupos de informes de Adobe Experience Cloud, los grupos de informes de Analytics se pueden configurar para que un sitio de comunidad pueda proporcionar informes para las funciones de las comunidades.

Al iniciar sesión en Adobe Experience Cloud con Nombre de empresa y Nombre de usuario, es posible configurar un grupo de informes nuevo o existente para que tenga:

Si usa un nuevo grupo de informes, es posible que un nuevo grupo de informes solo tenga 4 evars y 6 variables de eventos, mientras que se requieren 11 evars y 7 variables de eventos para las comunidades.

Si usa un grupo de informes existente, puede que sea necesario modificar la asignación de variables antes de activar el marco de Analytics para un sitio de la comunidad.

Póngase en contacto con su representante de cuentas para cualquier preocupación relativa a las variables dedicadas a las Comunidades.

Video Heartbeat Analytics video-heartbeat-analytics

Cuando Video Heartbeat Analytics tiene licencia, se asigna un Marketing Cloud Org Id.

Para habilitar los informes de Video Heartbeat después de configurar el grupo de informes de Analytics para los informes de vídeo:

Marketing Cloud Org Id se puede introducir en el momento de la creación del sitio de la comunidad o más tarde mediante la modificación de las propiedades del sitio de la comunidad.

Cuando Video Heartbeat Analytics está habilitado, el código JavaScript (JS) del reproductor de vídeo crea una instancia del código de biblioteca de Video Heartbeat (también en JS). El código gestiona toda la lógica para enviar actualizaciones de estado de vídeo a los servidores de seguimiento de vídeo de Analytics cada 10 segundos (no configurable). Finalmente, envía un informe acumulado de la sesión de vídeo a los servidores principales de Analytics.

Si no está habilitado, el código de latido de vídeo nunca se crea una instancia y solo el progreso del vídeo y el seguimiento de posición de reanudación se mantienen en SRP para la creación de informes.

AEM Configuración del servicio de Analytics Cloud aem-analytics-cloud-service-configuration

Para crear una integración de Analytics, que integre Adobe Analytics AEM con el sitio de la comunidad de, mediante la interfaz de usuario estándar en la instancia de autor:

Cuadro de diálogo Crear configuración create-configuration-dialog

En el cuadro de diálogo Crear configuración, los valores que se van a introducir identifican la configuración.

Cuadro de diálogo Configuración de Analytics analytics-settings-dialog

La creación inicial de una nueva configuración de Analytics da como resultado la visualización de la configuración y un nuevo cuadro de diálogo para la entrada de la Configuración de Analytics. Este cuadro de diálogo requiere la información de cuenta de requisitos previos obtenida del representante de cuentas.

Para guardar la configuración:

Crear módulo create-framework

Después de configurar correctamente la conexión básica a Adobe Analytics, es necesario crear o editar un marco de trabajo para el sitio de la comunidad. AEM El propósito del marco de trabajo es asignar variables de características de las comunidades () a variables de Analytics (grupo de informes).

Al crear el marco de Analytics, se abre el marco de trabajo para la configuración.

AEM Configuración del marco de análisis de aem-analytics-framework-configuration

AEM El propósito del marco de trabajo es asignar variables de a variables de Analytics (eVars y eventos). Las variables de Analytics disponibles para la asignación están definidas en el grupo de informes.

Seleccionar grupo de informes select-report-suite

Seleccione el grupo de informes que se ha configurado para los informes de vídeo.

Si aún no se ha creado o configurado correctamente un grupo de informes, consulte la sección anterior:
Grupo de informes de Adobe Analytics para informes de vídeo

El Sidekick no es necesario y puede minimizarse para que no obstruya el acceso a la configuración del grupo de informes.

Cuadro de diálogo Grupos de informes antes y después de seleccionar "Agregar elemento" report-suites-dialog-before-and-after-selecting-add-item

El servicio en la nube y el marco de Analytics ya están completos. Las asignaciones se definen después de crear un sitio de comunidad con este servicio de Analytics habilitado.

Habilitar Analytics para un sitio de la comunidad enable-analytics-for-a-community-site

Habilitar para el nuevo sitio de la comunidad enable-for-new-community-site

Para agregar el servicio Analytics Cloud al crear un sitio de la comunidad:

Habilitar para sitio de comunidad existente enable-for-existing-community-site

Para agregar el servicio Analytics Cloud a un sitio de comunidad existente:

Habilitar para sitios personalizados enable-for-customized-sites

Para que el seguimiento y la importación de Analytics funcionen correctamente en un sitio de la comunidad, debe haber un elemento de página con los atributos class y href de scf-js-site-title. Solo debe existir un elemento de este tipo en la página, como en un script sitepage.hbs sin modificar para un sitio de la comunidad. El valor de siteUrl se extrae y se envía a Adobe Analytics como ruta de acceso al sitio.

# present in default sitepage.hbs
# only one scf-js-site-title class should be included
# this example sets it to be hidden as it serves no visual purpose
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

Para un sitio personalizado de la comunidad que superponga el script sitepage.hbs, asegúrese de que el elemento esté presente. La variable siteUrl se establece cuando se representa en el servidor antes de entregarse al cliente.

AEM Para un sitio de trabajo genérico que incluye componentes de comunidades, pero que no se ha creado con el asistente para la creación de sitios, es necesario agregar el elemento. El valor del href debe ser la ruta al sitio. Por ejemplo, si la ruta del sitio es /content/my/company/en, utilice:

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Funciones de Analytics para comunidades analytics-for-communities-features

Analytics se utiliza automáticamente para varias funciones de Communities.

La configuración OSGi del entorno de creación, AEM Communities Analytics Component Configuration, proporciona una lista de los componentes que se han instrumentado para Analytics. La asignación automática de variables viene determinada por los componentes enumerados.

Si se crean nuevos componentes personalizados que están instrumentados para Analytics, deben añadirse a esta lista de componentes configurados.

Configuración de componentes component-configuration

AEM Analytics asignado a variables de mapped-analytics-to-aem-variables

AEM Una vez guardado el sitio de la comunidad, con Analytics habilitado y el marco de trabajo de configuración de la nube seleccionado, las variables de la se asignan automáticamente a las eVars y los eventos de Analytics. Comienza con evar1 y event1, respectivamente, y se incrementa en 1.

AEM Si usa un grupo de informes existente que haya asignado cualquiera de las variables dentro de evar1 a evar11 y de event1 a event7, será necesario reasignar las variables de la y restaurar la asignación original.

A continuación se muestra un ejemplo de asignaciones predeterminadas:

Mapa de eVars enviadas con cada evento map-of-evars-sent-with-each-event

Ejemplos de valores de eVar :

Modificación de la asignación de variables de Analytics modifying-analytics-variable-mapping

AEM La asignación de eVars y eventos de Analytics a variables de se puede ver desde la configuración del marco de trabajo una vez que Analytics esté habilitado para un sitio de la comunidad.

Después de habilitar Analytics y antes de publicar el sitio de la comunidad, la asignación puede modificarse en el marco de trabajo. Basta con arrastrar la eVar o el evento de Analytics deseado desde el carril izquierdo y soltarlo en la fila correspondiente de la tabla de asignación.

Para evitar asignaciones duplicadas, asegúrese de quitar la eVar o el evento de Analytics reemplazado de la fila pasando el puntero sobre él y seleccionando la "X" que aparece a la derecha del elemento de variable de Analytics.

AEM Si las eVars y los eventos de las comunidades sobrescriben las asignaciones preexistentes en el grupo de informes, para evitar la pérdida de datos, asigne las variables de las comunidades para las características de las comunidades a otras eVars o eventos de Analytics y restaure las asignaciones originales.

Ejemplo Paso 1: Arrastrar Analytics evar14 a la tabla de asignación example-step-dragging-analytics-evar-into-mapping-table

Ejemplo de paso 2: Seleccionar "x" para eliminar el evar11 reemplazado example-step-selecting-x-to-remove-replaced-evar

AEM Ejemplo Paso 3: reasignación de var eventdata.siteId a Analytics evar14 example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

Publicación del sitio de la comunidad publishing-the-community-site

AEM Verificar la asignación de Analytics a variables de verify-analytics-to-aem-variable-mapping

Es aconsejable comprobar la asignación de variables antes de publicar el sitio de la comunidad, que también publica el servicio y el marco de trabajo de Analytics Cloud.

Consulte las secciones:

Editor principal primary-publisher

AEM Si la implementación elegida es una granja de servidores de publicación, se debe identificar una instancia de publicación como el editor principal para sondear Adobe Analytics y así obtener los datos del informe que se van a escribir en SRP.

De forma predeterminada, la configuración OSGi AEM Communities Publisher Configuration identifica su instancia de publicación como el editor principal, de modo que todas las instancias de publicación de un conjunto de servidores de publicación se identificarían automáticamente como las principales.

Por lo tanto, es necesario editar la configuración en todas las instancias de publicación secundarias para anular la selección de la casilla de verificación Editor principal.

Para obtener instrucciones específicas, consulte la sección del editor principal de Implementación de comunidades.

Replicar la clave criptográfica replicate-the-crypto-key

Las credenciales de Adobe Analytics están cifradas. AEM Para facilitar la replicación o transmisión de credenciales de análisis cifradas entre el autor y los editores, todas las instancias de la deben compartir la misma clave de cifrado principal.

Para ello, siga las instrucciones en Replicar la clave de cifrado.

Sitio de la comunidad Publish y servicio Analytics Cloud publish-community-site-and-analytics-cloud-service

Una vez que el servicio Analytics Cloud AEM esté habilitado para un sitio de la comunidad y, si es necesario, se ajuste la asignación de Analytics a las variables de la comunidad, duplique la configuración en el entorno de publicación volviendo a publicar el sitio de la comunidad.

Obtener informes de Analytics obtaining-reports-from-analytics

Administración de informes report-management

La configuración OSGi, AEM Communities Analytics Report Management del autor y el editor principal se usa para consultar Analytics.

En el autor, las consultas son para informes en tiempo real.

En el editor principal, las consultas se utilizan para proporcionar información como preparación para la importación de datos de Analytics del importador de informes.

El valor predeterminado del intervalo de consulta es de 10 segundos.

Importador de informes report-importer

Una vez que se ha publicado un sitio de comunidad habilitado para Analytics, la configuración OSGi del editor principal, AEM Communities Analytics Report Importer, se puede configurar para establecer el intervalo de sondeo predeterminado para aquellas configuraciones que no se configuren individualmente en CRXDE.

El intervalo de sondeo controla la frecuencia de las solicitudes a Adobe Analytics para que se extraigan datos y se guarden en SRP.

Cuando los datos se pueden categorizar como "big data", un sondeo más frecuente puede cargar mucho el sitio de la comunidad.

El sondeo predeterminado Intervalo de importación está establecido en 12 horas.

Personalización de informe de componentes component-report-customization

Actualmente, para personalizar las métricas que se van a rastrear, se crean nodos en el repositorio que definen períodos de tiempo para los que generar un informe sobre esa métrica.

El tema del foro es actualmente el único ejemplo de esta personalización:

Administración de datos de usuario en Analytics manage-user-data-in-analytics

Adobe Analytics proporciona API que le permiten acceder, exportar y eliminar datos de usuario. Para obtener más información, consulte Enviar solicitudes de acceso y eliminación.

Recursos resources