Opción de Adobe Analytics y Adobe Target

AEM tiene un procedimiento de selección para ayudarle a integrarse con Adobe Analytics y Adobe Target. Está disponible de forma predeterminada, como una tarea precargada asignada al grupo de usuarios administrador.

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

Tiene las siguientes opciones para configurar la integración:

  • Configure la integración mediante la tarea.

    Esto se puede hacer inmediatamente o más tarde, la tarea permanecerá en la Bandeja de entrada hasta que se realice alguna acción. En cualquier caso, la configuración se puede realizar directamente en la interfaz de usuario o con el uso de un archivo .properties predefinido.

  • Exclusión la integración.

    Considere esta opción si prefiere configurar manualmente la integración. Consulte también Integración de AEM con Adobe Target y Adobe Analytics mediante DTM.

  • Configure la configuración y el aprovisionamiento mediante una secuencia de comandos.

Configuración de la integración

Opte por la integración con:

  • Analytics para habilitar el uso de sus funciones de seguimiento de páginas y análisis.
  • Destinatario para permitir 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 que se rastrean.

Nota

De forma opcional, puede proporcionar información de cuenta de Analytics y Destinatario mediante un archivo de propiedades que se lee al iniciar el servidor. Consulte Proporcionar información de la cuenta mediante un archivode propiedades.

Al optar por la integración, AEM realiza las siguientes tareas:

  • Crea las configuraciones de nube que habilitan la conexión a Analytics y Destinatario.
  • Crea los marcos que determinan los datos que se rastrean.
  • Configura las páginas Web para utilizar estos servicios.
Nota

AT.js es la biblioteca de cliente predeterminada. Esto se configura en la configuración de servicios de nube dedestinatario.

Adobe recomienda utilizar AT.js como biblioteca de cliente.

Para optar por la tarea precargada y lista para usar:

  1. En la Bandeja de entrada, seleccione y abra la tarea Configurar análisis y objetivos .

    optin-01

  2. Para Analytics:

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

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

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

  6. Seleccione Listo para completar.

    PRECAUCIÓN

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

Exclusión la integración

Exclusión la integración con Analytics y Destinatario cuando:

Para exclusión, debe completar la tarea precargada:

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

Instale un archivo de propiedades que AEM lea al iniciar el servidor para configurar las propiedades de la cuenta para la integración con Analytics y Destinatario. Cuando se utiliza el archivo de propiedades, el asistente para la selección utiliza automáticamente las propiedades del archivo y la configuración de nube se crea en consecuencia.

El archivo de propiedades es un archivo de texto llamado marketing cloud.properties que se guarda en el directorio de trabajo que está utilizando el proceso de AEM (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 utilice.
  • analytics.compañía: compañía 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 usar.
  • destinatario.clientcode: El código de cliente asociado a la cuenta de Destinatario.
  • destinatario.email: La dirección de correo electrónico que utiliza para autenticar su cuenta de Destinatario.
  • destinatario.password: La contraseña asociada a su dirección de correo electrónico.

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

El siguiente archivo de ejemplo .properties 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 archivo en el directorio de trabajo que está utilizando el proceso de AEM (instancia de autor).

    Nota

    El directorio de trabajo es generalmente el directorio que contiene el archivo o el archivo license.properties .

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

    mac.provisioning.file.container

  2. Añada los valores de las propiedades según sus cuentas de Analytics y/o Destinatario.

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

  4. Abra la tarea Configurar análisis y objetivos 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 del .properties archivo.

    Seleccione Añadir para el servicio adecuado y, a continuación, continúe con el asistente.

    optin-02

Acerca de las configuraciones de nube

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

No es necesario modificar las configuraciones de nube. Sin embargo, puede configurar los marcos según sea necesario. (Consulte Asignación de datos de componentes con propiedades de Adobe Analytics y Añadir un marcode Destinatario).

Nota

De forma predeterminada, cuando se selecciona en el asistente de configuración de Adobe Target, la segmentación precisa está activada.

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

La segmentación precisa siempre está habilitada en la instancia de creación. Sin embargo, en la instancia de publicación, puede desactivar la segmentación precisa globalmente borrando la marca de verificación junto a Objetivo preciso en la configuración del servicio en la nube (http://localhost:4502/etc/cloudservices.html). También puede activar y desactivar la segmentación precisa 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 afectarán a dichos componentes. Debe realizar cambios directamente en esos componentes.

PRECAUCIÓN

Cuando se selecciona en la configuración de Analytics y reportsuite se selecciona un elemento específico, el marco se restringe al modo de ejecución de publicación. Esto significa que el seguimiento solo funciona en la instancia de publicación.

Si también se necesita realizar el seguimiento en una instancia de creación, se debe cambiar el valor a all.

Configuración del programa de instalación y aprovisionamiento mediante script

Como administrador, puede que desee activar la configuración y el aprovisionamiento con una secuencia de comandos en lugar de pasar manualmente por el asistente. Puede hacerlo mediante:

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

Los parámetros que envía dependen de lo siguiente:

  • Si desea utilizar el archivo marketingcloud.properties con todas las credenciales necesarias, debe enviar los siguientes parámetros:

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

    Por ejemplo, una solicitud curl que crea configuraciones tanto de Analytics como de Destinatario y las adjunta a la página 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 el archivo marketingcloud.properties , deberá enviar las credenciales así como los parámetros; por ejemplo:

    • AutomaticProvisioning= true
    • servicename= analytics|target
    • path=path a una página AEM para adjuntar las configuraciones de servicios en la nube creadas; se pueden definir varias rutas
    • analytics.server= https://servername
    • analytics.compañía= Name of company
    • analytics.username= me
    • analytics.secret= secret
    • analytics.reportsuite= we-retail
    • destinatario.clientcode= mycompany
    • destinatario.email= me@adobe.com
    • destinatario.password= password

    En este caso, la solicitud curl que crea configuraciones tanto de Analytics como de Destinatario y las adjunta a la página de venta minorista virtual sería:

    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