Funciones de configuración de Analytics para comunidades

Información general

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

Adobe Analytics puede configurarse para AEM Communities de modo que, al interactuar un miembro con las funciones admitidas de Communities, se envíen eventos a Adobe Analytics desde donde se generan los informes.

Por ejemplo, cuando un miembro de un sitio de comunidad de habilitación vista un recurso de vídeo asignado a ellos, el reproductor de recursos enviará eventos a Analytics, incluidos datos de Video Heartbeat. Desde el sitio de la comunidad, los administradores pueden ver varios informes sobre la reproducción del video.

Además, es necesario realizar análisis para:

  • En el entorno de publicación:

    • Sistema de informes sobre las tendencias de la comunidad
    • Permitir que los visitantes del sitio se ordenen por "más visitados", "más activos", "más "gustados"
    • Recuentos de Vistas en listas UGC
  • En el entorno del autor:

    • Visualización de datos de participación en la consola de administración de miembros (vistas, publicaciones, siguientes, "Me gusta")
    • Resumen de tendencias, Video Heartbeat y dispositivo de vídeo para habilitar informes de recursos

Las funciones de comunidades admitidas incluyen:

Esta sección de la documentación describe cómo conectar un grupo de informes de Analytics con las funciones de Comunidades. Los pasos básicos son:

  1. Replicar la clave criptográfica para garantizar que el cifrado/descifrado se produce correctamente en todas las instancias AEM
  2. Preparación de un grupo de informes de Adobe Analytics
  3. Creación de un servicio y un marco de trabajo en la nube AEM de Analytics
  4. Habilitar Analytics para un sitio de comunidad
  5. Verificar la asignación de Analytics a AEM variable
  6. Identifique al publicador principal
  7. Publicar el sitio de la comunidad
  8. Configurar la importación de datos de informes de Adobe Analytics al sitio de la comunidad

Requisitos previos

Para configurar las funciones de Analytics para Comunidades, es necesario trabajar con el representante de cuentas para configurar una cuenta de Adobe Analytics y un grupo de informes. Una vez establecida, debe disponerse de la siguiente información:

  • Nombre de Compañía

    La compañía asociada a la cuenta de Adobe Analytics

  • Nombre de usuario

    El nombre de usuario de inicio de sesión del usuario autorizado para administrar la cuenta de Analytics

    (Debe incluir privilegios de acceso a servicios Web)

  • Contraseña

    La contraseña de inicio de sesión del usuario autorizado

  • Centro de datos de Analytics

    Dirección URL del centro de datos de Analytics para la cuenta

  • Grupo de informes

    Nombre del grupo de informes de Analytics que se va a usar

Grupo de informes de Adobe Analytics para Sistema de informes de vídeo

Con el Administrador de grupos deinformes de Adobe Marketing Cloud, los grupos de informes de Analytics se pueden configurar de modo que un sitio de comunidad se pueda habilitar para proporcionar informes para las funciones de Comunidades.

Al iniciar sesión en Adobe Marketing Cloud con Nombre de Compañía y Nombre de usuario, es posible configurar un grupo de informes nuevo o existente para que tenga:

  • 11 Variables de conversión (evars)

    • evar1 mediante evar11 activación
    • Puede reutilizar (cambiar el nombre de evars existentes) o crear nuevas para utilizarlas en las funciones de Comunidades
  • 7 Eventos de éxito (eventos)

    • event1 mediante event7 activación

    • Tipo Counter

      • not Counter (no subrelations)
    • Puede reutilizar (cambiar el nombre de los eventos existentes o crear otros nuevos para utilizarlos en las funciones de Communities

  • Administración de vídeo

    • Consola de Sistema de informes de vídeo

      • Habilitar Video Core
      • Seleccione Guardar
    • Consola de medición de Video Core

      • Seleccione Use Solution Variables
      • Seleccione Guardar

Si utiliza un nuevo grupo de informes, tenga en cuenta que un nuevo grupo de informes solo puede tener 4 eVars y 6 variables de evento, mientras que para las comunidades se requieren 11 eVars y 7 variables de evento.

Si se utiliza 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 comunidad. Póngase en contacto con el representante de cuentas para conocer cualquier inquietud relacionada con las variables dedicadas a las comunidades.

PRECAUCIÓN

Si utiliza un grupo de informes existente que ya utiliza variables dentro de

  • evar1 hasta evar11
  • event1 hasta event7

Después, antes de publicar el sitio de la comunidad, es importante restaurar la asignación preexistente moviendo las variables de AEM que se asignaron automáticamente a variables de Analytics cuando Analytics estaba habilitado para un sitio de la comunidad.

Para restaurar la asignación preexistente y mover variables de AEM a otras variables de Analytics, consulte la sección sobre modificación de la asignaciónde variables de Analytics.

Si no lo hace, puede producirse una pérdida de datos irrecuperable.

Análisis de Video Heartbeat

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

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

El Marketing Cloud Org Id se puede ingresar en el momento de la creación del sitio de la comunidad o posteriormente modificando las propiedades del sitio de la comunidad.

chlimage_1-264

Cuando Video Heartbeat Analytics está habilitado, el código Javascript (JS) del reproductor de vídeo crea una instancia del código de Video Heartbeat Library (también en JS), que controla 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 configurables) y, finalmente, envía un informe acumulativo de la sesión de vídeo a los servidores principales de Analytics.

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

Configuración AEM del servicio Analytics Cloud

Para crear una nueva integración de Analytics que integre Adobe Analytics con el sitio de la comunidad AEM, utilice la IU estándar en la instancia de creación:

  • Desde la navegación global: Herramientas > Implementación > Cloud Services
  • Desplácese hacia abajo hasta Adobe Analytics
  • Seleccione Configurar ahora o Mostrar configuraciones

chlimage_1-265

Cuadro de diálogo Crear configuración

  • Seleccione [+] el icono junto a Configuraciones ​disponibles para crear una nueva configuración

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

chlimage_1-266

  • Título

    (Requerido) Un título de visualización para la configuración.

    Por ejemplo, introduzca Habilitación de análisis de comunidad

  • Nombre

    (Opcional) Si no se especifica, el nombre pasará de forma predeterminada a un nombre de nodo válido derivado del título.

    For example, enter communities

  • Plantilla

    Seleccione Adobe Analytics Configuration

  • Seleccione Crear

    • Inicia la página de configuración y abre Analytics Settings el cuadro de diálogo

Cuadro de diálogo Configuración de análisis

La creación inicial de una nueva configuración de Analytics hace que se muestre la configuración y un nuevo cuadro de diálogo para la entrada en la Configuración de Analytics. Este cuadro de diálogo requiere la información previa de la cuenta obtenida del representante de la cuenta.

chlimage_1-267

  • Empresa

    La compañía asociada a la cuenta de Adobe Analytics

  • Nombre de usuario

    El nombre de usuario de inicio de sesión del usuario autorizado para administrar la cuenta de Analytics

  • Contraseña

    La contraseña de inicio de sesión del usuario autorizado

  • Centro de datos

    Seleccione el centro de datos de Analytics que aloja el grupo de informes

  • No añadir etiqueta de seguimiento a la página

    Dejar como predeterminado (sin marcar)

  • Utilizar AppMeasurement

    Dejar como predeterminado (sin marcar)

  • No importar las impresiones de la página cada noche (Author)

    Dejar como predeterminado (sin marcar)

  • No importar las impresiones de la página cada noche (Publish)

    Dejar como predeterminado (marcado)

Para guardar la configuración:

  • Seleccione Conectar con Analytics

    • Si no es exitoso,

      • Verificar que las entradas no contengan espacios de interlineado
      • Pruebe con otro centro de datos
      • Póngase en contacto con el representante de cuentas
  • Seleccione Aceptar

chlimage_1-268

Crear módulo

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

  • Seleccione [+] el icono junto a Marcos disponibles para crear un nuevo marco

chlimage_1-269

  • Título

    (Requerido) Un título para mostrar del marco

    Por ejemplo, introduzca Enablement Community Framework

  • Nombre

    (Opcional) Si no se especifica, el nombre pasará de forma predeterminada a un nombre de nodo válido derivado del título.

    For example, enter communities

  • Plantilla

    Seleccione Adobe Analytics Framework

  • Seleccione Crear

La creación de Analytics Framework abre el marco para la configuración.

Configuración de AEM Analytics Framework

El propósito de la estructura es asignar variables de AEM a variables de Analytics (evars y eventos). Las variables de Analytics disponibles para la asignación se definen en el grupode informes.

chlimage_1-270

Seleccionar grupo de informes

Seleccione el grupo de informes configurado para el sistema de informes de vídeo.

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

La barra de tareas no es necesaria y puede minimizarse para que no obstruya el acceso a la configuración de los grupos de informes.

Cuadro de diálogo Grupos de informes antes y después de seleccionar 'Añadir elemento'

chlimage_1-271

  1. Se muestran Añadir elemento + dos cuadros desplegables
  2. Elija un grupo Report suite de informes asociado con la cuenta de Compañía que esté disponible para selección
  3. Seleccione en el cuadro de diálogo que se abre: Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
  4. Elija un Run Mode
    Elegir publicación

chlimage_1-272

El servicio y el marco de trabajo de Analytics cloud ya están completos. Las asignaciones se definirán una vez que se haya creado un sitio de comunidad con este servicio de Analytics habilitado.

Habilitar Analytics para un sitio de comunidad

Habilitar para nuevo sitio de comunidad

Para agregar el servicio en la nube de Analytics al crear un nuevo sitiode comunidad:

  • En el paso 3

  • En la ficha ANALYTICS:

    • Marque la casilla de verificación Activar Analytics .
    • Elija el marco en el cuadro desplegable
  • De forma opcional, vuelva a la configuración del marco de Analytics para ajustar las asignaciones de variables.

Habilitar para sitio de comunidad existente

Para agregar el servicio en la nube de Analytics a un sitio de comunidadexistente:

  • Vaya a la consola Comunidades > Sitios .

  • Seleccione el icono Editar sitio del sitio de la comunidad

  • Seleccione la CONFIGURACIÓN

  • En la sección Análisis:

    • Marque la casilla de verificación Activar Analytics .
    • Elija el marco en el cuadro desplegable
  • De forma opcional, vuelva a la configuración del marco de Analytics para ajustar las asignaciones de variables.

Habilitar para sitios personalizados

Para que el seguimiento y la importación de Analytics funcionen correctamente en un sitio de comunidad, debe haber un elemento de página con los atributos class y href scf-js-site-title . Solo debe existir un elemento de este tipo en la página, como lo hace en una secuencia de comandos sitepage.hbs sin modificar para un sitio de comunidad. El valor de siteUrl se extrae y se envía a Adobe Analytics como ruta del 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 de comunidad personalizado que superponga la sitepage.hbs secuencia de comandos, asegúrese de que el elemento está presente. La siteUrlvariable se configurará cuando se procese en el servidor antes de servir en el cliente.

Para un sitio de AEM genérico que incluya componentes de Comunidades pero no se cree con el asistente de creación desitios, es necesario agregar el elemento. El valor de 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 se utiliza automáticamente para varias funciones de Communities.

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

Si se crean nuevos componentes personalizados instrumentados para Analytics, deben agregarse a esta lista de componentes configurados.

Configuración de componentes

chlimage_1-273

Nota: los journal componentes se utilizan para implementar la función de blog.

Se asignó Analytics a variables de AEM

Una vez guardado el sitio de la comunidad con Analytics habilitado y seleccionado el marco de configuración de la nube, las variables AEM se asignarán automáticamente a las evars y eventos de Analytics que comiencen por evar1 y evento1, respectivamente, y que aumenten en 1.

Si utiliza un grupo de informes existente que asignó cualquiera de las variables dentro de evar1 a evar11 y evento1 a evento7, será necesario reasignar las variables AEM y restaurar la asignación original.

A continuación se muestra un ejemplo de asignaciones predeterminadas después de seguir el tutorial deintroducción:

chlimage_1-274

Mapa de eVars enviadas con cada evento

Habilitación del tipo de recurso Título del sitio Tipo de función Título del grupo Ruta de grupo Tipo UGC Título UGC Usuario (miembro) Ruta de UGC Ruta del sitio
eVar1 eVar2 eVar3 eVar4 eVar5 eVar6 eVar7 eVar8 eVar9 eVar10
evento1Reproducción de recursos (una) - - - - - - - i) -
event2SCFView (una) b) c) (d) (e) (f) (g) (h) i) j)
evento3SCFCreate (Post) - b) c) (d) (e) (f) (g) (h) i) j)
event4SCFFollow - b) c) (d) (e) (f) (g) (h) i) j)
event5SCFVoteUp - b) c) (d) (e) (f) (g) (h) i) j)
event6SCFVoteDown - b) c) (d) (e) (f) (g) (h) i) j)
event7SCFRate - b) c) (d) (e) (f) (g) (h) i) j)

Ejemplos de valores de eVar:

  • TipoMIME: vídeo/mp4
  • Títulodel sitio de la comunidad: Comunidades Geometrixx
  • Nombrede función de comunidad: Foro
  • Nombredel grupo de la comunidad: Senderismo
  • Ruta al contenido del grupo de comunidad: /content/sites/communities/es/groups/walk
  • RecursoTipodel componente UGC: social/forum/components/hbs/topic
  • Título del componente UGC: Senderismo por temas
  • Inicio de sesión (identificador autorizado): aaron.mcdonald@mailinator.com
  • Ruta de SRP a UGC: /content/usergenerate/asi/…/forum/jmtz-topic3 o ruta del componente a seguir: /content/sites/communities/es/jcr:content/content/Primary/forum
  • Ruta al contenido del sitio de la comunidad: /content/sites/community/es

Modificación de la asignación de variables de Analytics

La asignación de evars y eventos de Analytics a variables de AEM es visible desde la configuración del marco después de habilitar Analytics para un sitio de comunidad.

Después de habilitar Analytics y antes de publicar el sitio de la comunidad, la asignación se puede modificar en el marco arrastrando la eVar o el evento de Analytics deseados desde el carril izquierdo y colocándola en la fila pertinente de la tabla de asignación.

Para evitar las asignaciones de duplicado, asegúrese de eliminar la evar o el evento de Analytics reemplazados de la fila pasando el ratón sobre ella y seleccionando la "X" que aparece a la derecha del elemento de variable de Analytics.

Si las evars y eventos de Communities sobrescriben las asignaciones que existían previamente en el grupo de informes, asigne las variables de AEM para las funciones de Communities a otras evars y/o eventos de Analytics y restaure las asignaciones originales.

PRECAUCIÓN

Es importante volver a asignar antes de que el sitio de la comunidad se publique con Analytics habilitado; de lo contrario, se corre el riesgo de perder datos.

Ejemplo de paso 1: Arrastrar evar14 de Analytics a la tabla de asignación

chlimage_1-275

Ejemplo de paso 2: Seleccionar 'x' para eliminar evar11 reemplazada

chlimage_1-276

Ejemplo del paso 3: AEM var eventdata.siteId reasignado a evar14 de Analytics

chlimage_1-277

Publicación del sitio de la comunidad

Verificar la asignación de Analytics a AEM variable

Es aconsejable verificar la asignación de variables antes de publicar el sitio de la comunidad, que también publica el servicio en la nube y el marco de Analytics.

Consulte las secciones:

PRECAUCIÓN

Si utiliza un grupo de informes existente que ya utiliza variables dentro de

  • evar1 hasta evar11
  • event1 hasta event7

A continuación, antes de publicar el sitio de comunidad, es importante restaurar la asignación preexistente y mover las variables de AEM de comunidades que se asignaron automáticamente (cuando Analytics se habilitó para el sitio de la comunidad) a otras variables de Analytics. Esta reasignación debe ser coherente en todos los componentes de Comunidades.

Si no lo hace, puede producirse una pérdida de datos irrecuperable.

Editor principal

Cuando la implementación elegida es un conjunto de servidores depublicación, se debe identificar una instancia de publicación AEM como el editor principal para sondear Adobe Analytics para que los datos del informe se escriban en SRP.

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

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

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

PRECAUCIÓN

Es importante que el editor principal esté configurado para evitar que las encuestas se realicen desde varias instancias de publicación.

Replicar la clave de cifrado

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

Para ello, siga las instrucciones de Replicar la clavede cifrado.

Publicar sitio de comunidad y servicio de Analytics Cloud

Una vez que el servicio en la nube de Analytics se ha habilitado para un sitio de la comunidad y, si es necesario, se ha ajustado laasignación de Analytics a AEM variables, es necesario replicar la configuración en el entorno de publicación (re)publicando el sitiode la comunidad.

Obtención de informes de Analytics

Administración de informes

La configuración OSGi del autor y del editor principal, AEM Communities Analytics Report Management, se utiliza para consulta de Analytics.

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

En el publicador principal, las consultas se utilizan para proporcionar información como preparación para la importación de datos analíticos del importador de informes.

El intervalo de consulta predeterminado es de 10 segundos.

Importador de informes

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, puede configurarse para establecer el intervalo de sondeo predeterminado para aquellas configuraciones que no estén configuradas individualmente en CRXDE.

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

Cuando los datos pueden clasificarse como "grandes datos", las encuestas más frecuentes pueden causar una gran carga en el sitio de la comunidad.

El intervalo predeterminado de importación de encuestas está establecido en 12 horas.

chlimage_1-278

Personalización del informe de componentes

Actualmente, para personalizar las métricas de seguimiento, los nodos se crean en el repositorio que define los períodos de tiempo para los cuales se genera un informe sobre esa métrica.

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

  • En el editor principal

  • Iniciar sesión con privilegios administrativos

  • Navegar al CRXDE Lite

  • En el jcr:content nodo de la raíz del idioma

    • Por ejemplo, /content/sites/engage/en/jcr:content
  • Vaya al componente configurado para el sistema de informes de Analytics

    • Por ejemplo, analytics/reportConfigs/social_forum_components_hbs_topic
  • Observe los períodos de tiempo creados

    • last30Days
    • last90Days
    • thisYear
  • Observe el totalnodo

    • Si se modifica la interval propiedad, se sobrescribirá el intervalo del importador de informes
    • El valor se expresa en segundos y se establece en 4 horas (14.400 segundos)

chlimage_1-279

Administrar datos de usuario en Analytics

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

Medios

En esta página