Inclusión en Adobe Analytics y Adobe Target

Última actualización: 2023-12-04

AEM tiene un procedimiento de inclusión que le ayuda a integrar con Adobe Analytics y Adobe Target. Esta opción está disponible de forma predeterminada, como una tarea precargada asignada al grupo de usuarios del administrador.

Cuando inicia sesión como administrador, esta tarea (Configuración de Analytics y Targeting) está disponible en el Bandeja de entrada. En función de las credenciales que proporcione, le ayuda a configurar e integrar estos servicios.

Tiene las siguientes opciones para configurar la integración:

Configuración de la integración

Inclusión en la integración con:

  • Analytics para habilitar el uso de las funcionalidades de análisis y seguimiento de páginas.
  • Target para habilitar el uso de sus capacidades de personalización.

Para cualquiera de las opciones, debe proporcionar la información de la cuenta de usuario y especificar las páginas de las que se realiza un seguimiento.

NOTA

Si lo desea, puede proporcionar información de cuentas de Analytics y Target mediante un archivo de propiedades que se lee al iniciar el servidor. Consulte Proporcionar información de la cuenta mediante un archivo de propiedades.

AEM Al adherirse a la integración, realiza las siguientes tareas de la forma más rápida de realizar la integración:

  • Crea las configuraciones en la nube que habilitan la conexión con Analytics y Target.
  • Crea los marcos que determinan los datos de los que se realiza un seguimiento.
  • Configura las páginas web para utilizar estos servicios.
NOTA

AT.js es la biblioteca de cliente predeterminada. Esto se configura en su configuración de target cloud services.

El Adobe recomienda usar AT.js como biblioteca de cliente.

Para desactivar la tarea predeterminada precargada de, haga lo siguiente:

  1. De su Bandeja de entrada, seleccione y Abrir la Configuración de Analytics y Target tarea.

    optin-01

  2. Para Analytics:

    1. Introduzca la información de la cuenta de usuario de Analytics y, a continuación, haga clic en la correspondiente Añadir botón.
    2. Se autentican las credenciales adecuadas.
    3. Cuando la cuenta de Analytics esté autenticada, seleccione el grupo de informes de Analytics que desee utilizar. AEM recupera los grupos de informes de Analytics. El estado se actualiza a Añadido.
  3. Para Target:

    1. Introduzca la información de la cuenta de usuario de Target y haga clic en la correspondiente Añadir botón.
    2. Se autentican las credenciales adecuadas. El estado se actualiza a Añadido.
  4. Seleccione Siguiente.

  5. Seleccione los sitios para los que se deben usar Analytics o Target.

  6. Seleccionar Listo para completar.

    PRECAUCIÓN

    Después de adherirse a la configuración, debe publicar el sitio o las páginas afectadas para replicar estos cambios en la instancia de publicación.

Exclusión de la integración

Desactivar la integración con Analytics y Target cuando:

Para desactivar, debe completar la tarea precargada:

Proporcionar información de la cuenta mediante un archivo de propiedades

AEM Instale un archivo de propiedades que se lea en el inicio del servidor para configurar las propiedades de la cuenta para la integración con Analytics y Target. Al utilizar el archivo de propiedades, el asistente de inclusión utiliza automáticamente las propiedades del archivo y la configuración de nube se crea en consecuencia.

AEM El archivo de propiedades es un archivo de texto denominado marketingcloud.properties que se guarda en el directorio de trabajo que está utilizando el proceso de trabajo (normalmente, el mismo directorio que el archivo JAR). El archivo incluye las siguientes propiedades:

  • analytics.server: la dirección URL del centro de datos de Analytics que utiliza.
  • analytics.company: la empresa asociada a su cuenta de usuario de Analytics.
  • analytics.username: su nombre de usuario de Analytics.
  • analytics.secret: El secreto asociado al nombre de usuario de Analytics.
  • analytics.reportsuite: nombre del grupo de informes de Analytics que se va a utilizar.
  • target.clientcode: el código de cliente asociado a la cuenta de Target.
  • target.email: la dirección de correo electrónico que utiliza para autenticar la cuenta de Target.
  • target.password: la contraseña asociada a su dirección de correo electrónico.

Las propiedades y los valores se separan con signos iguales (=). A las propiedades de Analytics se les agregará el prefijo analyticsy las propiedades de Target llevan el prefijo target. Para configurar un servicio, proporcione valores para todas las propiedades de ese servicio. Si no desea configurar un servicio, no proporcione valores para ese servicio.

El siguiente ejemplo .properties Este archivo incluye los valores de propiedad para crear una configuración de nube para Analytics:

analytics.server=https://test.omniture.com/login/
analytics.company=MyCompany
analytics.username=sbroders
analytics.secret=12345678
analytics.reportsuite=myreportsuite
target.clientcode=
target.email=
target.password=

El siguiente procedimiento describe cómo optar por la integración mediante el archivo de propiedades.

  1. Cree el marketingcloud.properties AEM en el directorio de trabajo que está utilizando el proceso de creación (instancia de autor).

    NOTA

    El directorio de trabajo suele ser el directorio que contiene el JAR o license.properties archivo.

    Sin embargo, la propiedad del sistema también puede definirla como una ruta absoluta:

    mac.provisioning.file.container

  2. Agregue los valores de propiedad según sus cuentas de Analytics o Target.

  3. Inicie o reinicie el servidor y, a continuación, inicie sesión con una cuenta de administrador.

  4. Abra la tarea Configurar Analytics y Target como se describe en Configuración de la integración. En lugar de solicitar la información de su cuenta, el asistente utiliza los valores de .properties archivo.

    Seleccionar Añadir para obtener el servicio adecuado, continúe con el asistente.

    optin-02

Acerca de las configuraciones en la nube

AEM Al configurar la integración con Analytics y Target, crea automáticamente las configuraciones y marcos de trabajo en la nube necesarios. Por ejemplo, la configuración de nube de Analytics se llama Cuenta de Analytics aprovisionada.

No es necesario modificar las configuraciones en la nube. Sin embargo, puede configurar los marcos según sea necesario. (Consulte Asignación de datos de componente con propiedades de Adobe Analytics y Agregar un marco de trabajo de Target.)

NOTA

De forma predeterminada, al entrar en el asistente de configuración de Adobe Target, el direccionamiento preciso está habilitado.

El direccionamiento preciso significa que la configuración del servicio en la nube espera a que el contexto se cargue antes de cargar el contenido. Como resultado, en términos de rendimiento, un direccionamiento preciso puede provocar un retraso de unos milisegundos antes de cargar el contenido.

El direccionamiento preciso siempre está habilitado en la instancia de autor. Sin embargo, en la instancia de publicación puede optar por desactivar el direccionamiento preciso globalmente, desactivando la marca de verificación junto al direccionamiento preciso en la configuración del servicio en la nube (http://localhost:4502/etc/cloudservices.html). También puede activar y desactivar el direccionamiento preciso para componentes individuales independientemente de la configuración del servicio en la nube.

Si ya ha creado componentes de destino y cambia esta configuración, los cambios no afectan a esos componentes. Realice cualquier cambio en esos componentes directamente.

PRECAUCIÓN

Al adherirse a la configuración de Analytics y a una configuración específica de reportsuite está seleccionado, el marco de trabajo está restringido al modo de ejecución de publicación. Esto significa que el seguimiento solo funciona en la instancia de publicación.

Si es necesario realizar el seguimiento en una instancia de creación, el valor debe cambiarse a all.

Configuración de la instalación y el aprovisionamiento mediante script

Como administrador, es posible que desee almacenar en déclencheur la configuración y el aprovisionamiento con una secuencia de comandos en lugar de pasar manualmente por el asistente. Para ello, haga lo siguiente:

  • Envío de una solicitud de POST a /libs/cq/cloudservicesprovisioning/content/autoprovisioning.json con los parámetros requeridos.

Los parámetros que envíe dependerán de lo siguiente:

  • Si desea utilizar la variable marketingcloud.properties que se rellena con todas las credenciales necesarias, debe enviar los siguientes parámetros:

    • automaticProvisioning= true
    • servicename= analytics|target
    • pathAEM =ruta de acceso a una página de para adjuntar las configuraciones creadas de los servicios en la nube

    Por ejemplo, una solicitud de pliegue que cree configuraciones de Analytics y Target y las adjunte a la página de we.retail sería:

    curl -v -u admin:admin -X POST -d"automaticProvisioning=true&servicename=target&servicename=analytics&path=/content/we-retail" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
    
  • Si no desea utilizar la variable marketingcloud.properties a continuación, debe enviar las credenciales y los parámetros. Por ejemplo:

    • automaticProvisioning= true
    • servicename= analytics|target
    • AEM ruta=ruta a una página de para adjuntar las configuraciones creadas de cloud services; se pueden definir varias rutas
    • analytics.server= https://servername
    • analytics.company= Name of company
    • analytics.username= me
    • analytics.secret= secret
    • analytics.reportsuite= we-retail
    • target.clientcode= mycompany
    • target.email= me@adobe.com
    • target.password= password

    En este caso, la solicitud de pliegue que crea las configuraciones de Analytics y Target y las adjunta a la página web de venta minorista sería la siguiente:

    curl -v -u admin:admin -X POST -d"automaticProvisioning=false&servicename=target&servicename=analytics&path=/content/we-retail&analytics.server=https://servername/&analytics.company=Name of company&analytics.username=me&analytics.secret=secret&analytics.reportsuite=weretail&target.clientcode=mycompany&target.email=me@adobe.com&target.password=password" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
    

En esta página