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

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Información general overview

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

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

Por ejemplo, cuando un miembro de un sitio de la comunidad de habilitación ve un recurso de vídeo asignado a él, el reproductor de recursos envía 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 vídeo.

Además, se necesita análisis para:

  • En el entorno de publicación:

    • Informes sobre la comunidad tendencias
    • Permita que los visitantes del sitio clasifiquen por "más visitados", "más activos", "más "me gusta".
    • Ver recuentos en listas UGC
  • En el entorno de creación:

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

Las funciones de comunidades compatibles son:

En esta sección de la documentación se describe cómo conectar un grupo de informes de Analytics a las funciones de Communities. 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 una Adobe Analytics grupo de informes
  3. Crear un AEM de Analytics servicio en la nube y marco
  4. Habilitar Analytics para un sitio de comunidad
  5. Verificar Asignación de Analytics a AEM variable
  6. Identificar publicador principal
  7. Publicación el sitio de la comunidad
  8. Configurar importación de datos del informe de Adobe Analytics al sitio de la comunidad

Requisitos previos prerequisites

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

  • Nombre de la compañía

    Empresa 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 al servicio web)

  • Una 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 informes de vídeo adobe-analytics-report-suite-for-video-reporting

Uso de las Administrador del grupo de informes, los grupos de informes de Analytics se pueden configurar para que un sitio de la comunidad esté habilitado para proporcionar informes sobre las funciones de Communities.

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

  • 11 Variables de conversión (evars)

    • evar1 hasta evar11 enabled
    • Puede cambiar el propósito de las evars existentes (cambiar su nombre) o crear otras nuevas para utilizarlas en las funciones de Communities
  • 7 Eventos de éxito (eventos)

    • event1 hasta event7 enabled

    • Tipo Counter

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

  • Administración de vídeo

    • Consola de informes de vídeo

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

      • Seleccionar 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 utiliza un grupo de informes existente, puede ser 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 las variables dedicadas a Communities.

CAUTION
Si utiliza un grupo de informes existente que ya utilice variables dentro de
  • evar1 hasta evar11
  • event1 hasta event7
Después, antes de que se publique el sitio de la comunidad, es importante restaurar la asignación preexistente moviendo las variables AEM que se asignaron automáticamente a variables de Analytics cuando Analytics estaba habilitado para un sitio de comunidad.
Para restaurar la asignación preexistente y mover AEM variables a otras variables de Analytics, consulte la sección de Modificación de la asignación de variables de Analytics.
Si no lo hace, puede producirse una pérdida de datos irrecuperable.

Video Heartbeat Analytics video-heartbeat-analytics

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

Para habilitar los informes de Video Heartbeat después de configuración del grupo de informes de Analytics para la creación de informes de vídeo:

La variable Marketing Cloud Org Id podrá introducirse en el momento de creación de sitios de comunidad o más tarde modificar 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 la biblioteca de Video Heartbeat (también en JS), que 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) 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 y de posición de reanudación del vídeo se mantiene en SRP para los informes.

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

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 autor:

  • 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 create-configuration-dialog

  • Select [+] 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

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

    Por ejemplo, introduzca Habilitación de Community Analytics

  • Nombre

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

    Por ejemplo, introduzca comunidades

  • Plantilla

    Seleccionar Adobe Analytics Configuration

  • Seleccione Crear

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

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

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 introducir la configuración de Analytics. Este cuadro de diálogo requiere la variable información de cuenta de requisitos previos obtenido del representante de la cuenta.

chlimage_1-267

  • Compañía

    Empresa 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:

  • Select Conectarse a Analytics

    • Si no se realiza correctamente,

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

chlimage_1-268

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 para el sitio de la comunidad. El propósito del marco es asignar variables de características (AEM) de Communities a variables de Analytics (grupo de informes).

  • Select [+] junto a Marcos disponibles para crear un nuevo marco

chlimage_1-269

  • Título

    (Obligatorio) Un título que se muestra para el marco

    Por ejemplo, introduzca Marco comunitario de habilitación

  • Nombre

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

    Por ejemplo, introduzca comunidades

  • Plantilla

    Seleccionar Adobe Analytics Framework

  • Seleccione Crear

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

Configuración de AEM Analytics Framework aem-analytics-framework-configuration

El propósito del marco es asignar variables de AEM a variables de Analytics (evars y eventos). Las variables de Analytics disponibles para asignación son definida en el grupo de informes.

chlimage_1-270

Seleccionar grupo de informes select-report-suite

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

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

La barra de tareas no es necesaria y se puede minimizar para que no obstaculice el acceso a la configuración de los grupos 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

chlimage_1-271

  1. Select Agregar elemento + aparecen dos cuadros desplegables
  2. Elija un Report suite los grupos de informes asociados con la cuenta de empresa deben estar disponibles para su selección
  3. Select 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
    Choose publicar

chlimage_1-272

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

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

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

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

  • En el paso 3

  • En el Pestaña ANALYTICS:

    • Marque la Habilitar Analytics casilla de verificación
    • 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 enable-for-existing-community-site

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

  • Vaya a la Comunidades > Sitios consola

  • Seleccione el icono Editar sitio del sitio de la comunidad

  • Seleccione la CONFIGURACIÓN

  • En la sección Analytics :

    • Marque la Habilitar Analytics casilla de verificación
    • 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 enable-for-customized-sites

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

# present in default sitepage.hbs

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/es/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=es).
# only one scf-js-site-title class should be included

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/es/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=es).
# this example sets it to be hidden as it serves no visual purpose

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/es/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=es).
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

Para un sitio personalizado de la comunidad que superpone el sitepage.hbs , compruebe que el elemento esté presente. La variable siteUrlse establecerá cuando se procese en el servidor antes de servir al cliente.

Para un sitio de AEM genérico que incluye componentes de Communities, pero no se crea con la variable asistente de creación de sitios, es necesario añadir el elemento . El valor de href debe ser la ruta al sitio. Por ejemplo, si la ruta del sitio es /content/my/company/eny, a continuación, utilice:

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

Funciones de Analytics for Communities analytics-for-communities-features

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

El entorno de creación Configuración de OSGi, 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, estos se deben agregar a esta lista de componentes configurados.

Configuración de componentes component-configuration

chlimage_1-273

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

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

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

Si se usa un grupo de informes existente que asignó cualquiera de las variables de evar1 a evar11 y de event1 a event7, 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 la tutorial de introducción:

chlimage_1-274

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

Tipo de recurso de habilitación
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
event1Resource Play
(a)
-
-
-
-
-
-
-
i)
-
event2SCFView
(a)
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event3SCFCreate (Post)
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event4SCFFollow
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event5SCFVoteUp
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event6SCFVoteDown
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event7SCFRate
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)

Ejemplos de valores de eVar:

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

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

Una vez que Analytics se haya habilitado y antes de que se publique el sitio de la comunidad, la asignación se puede modificar en el marco arrastrando la evar o evento de Analytics deseado desde el carril izquierdo y soltándolo en la fila correspondiente de la tabla de asignación.

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

Si las evars y los 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 eventos de Analytics y restaure las asignaciones originales.

CAUTION
Es importante volver a asignar antes de que el sitio de la comunidad sea publicado con Analytics habilitado, de lo contrario, existe el riesgo de perder datos.

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

chlimage_1-275

Ejemplo de paso 2: Seleccionar 'x' para quitar evar11 reemplazado example-step-selecting-x-to-remove-replaced-evar

chlimage_1-276

Ejemplo de paso 3: AEM var eventdata.siteId reasignado a la evar14 de Analytics example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

chlimage_1-277

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

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

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

Consulte las secciones:

CAUTION
Si utiliza un grupo de informes existente que ya utilice variables dentro de
  • evar1 hasta evar11
  • event1 hasta event7
Después, antes de que se publique el sitio de la comunidad, es importante restaurar la asignación preexistente y mover las variables de Communities AEM que se asignaron automáticamente (cuando Analytics estaba habilitado para el sitio de la comunidad) a otras variables de Analytics. Esta reasignación debe ser coherente en todos los componentes de Communities.
Si no lo hace, puede producirse una pérdida de datos irrecuperable.

Editor principal primary-publisher

Cuando la implementación elegida es una publicar granja, entonces una instancia de publicación AEM debe identificarse como el editor principal para sondear Adobe Analytics con el fin de que los datos del informe escriban en SRP.

De forma predeterminada, la variable AEM Communities Publisher Configuration La configuración de 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 autoidentificarían como el principal.

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

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

CAUTION
Es importante que el publicador principal esté configurado para evitar que se sondeen varias instancias de publicación.

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

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

Para ello, siga las instrucciones indicadas en Replicar la clave criptográfica.

Publicar sitio de la comunidad y servicio de Analytics Cloud publish-community-site-and-analytics-cloud-service

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

Obtención de informes de Analytics obtaining-reports-from-analytics

Administración de informes report-management

El autor y el editor principal Configuración de OSGi, AEM Communities Analytics Report Management, se utiliza 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 a fin de prepararse 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 publicado un sitio de comunidad habilitado para Analytics, el editor principal Configuración de OSGi, AEM Communities Analytics Report Importer, puede configurarse para establecer el intervalo de sondeo predeterminado para las configuraciones que no están configuradas individualmente en CRXDE.

El intervalo de sondeo controla la frecuencia de las solicitudes a Adobe Analytics para extraer y guardar datos en SRP.

Cuando los datos pueden clasificarse como "big data", las encuestas más frecuentes pueden suponer una carga considerable en el sitio de la comunidad.

La encuesta predeterminada Intervalo de importación se establece en 12 horas.

chlimage_1-278

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

Actualmente, para personalizar las métricas de las que se realizará un seguimiento, se crean nodos en el repositorio que definen los períodos de tiempo durante los cuales se generará 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

  • Vaya a 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 la creación de informes de Analytics

    • Por ejemplo, analytics/reportConfigs/social_forum_components_hbs_topic.
  • Observe los periodos de tiempo creados

    • last30Days
    • last90Days
    • thisYear
  • Observe que totalnode

    • Modificación de la variable interval anulará el intervalo del importador de informes
    • El valor se expresa en segundos y se establece en 4 horas (14.400 segundos).

chlimage_1-279

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 Envío de solicitudes de acceso y eliminación.

Recursos resources

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6