Implementación de Analytics for Target

Several steps are required when implementing Adobe Analytics as the reporting source for Target (A4T).

Implementation steps

Las siguientes secciones describen los pasos necesarios para implementar esta integración en el sitio.

Paso 1: Solicitud de aprovisionamiento para Analytics y Destinatario

After you implement Analytics as the reporting source for Target, you must be provisioned for Analytics and Target. Rellene este formulario para solicitar el aprovisionamiento.

Paso 2: Configurar los permisos de usuario

User account requirements must be met before you can create an Analytics-based activity in Target. See User permission requirements.

Paso 3: Implementar el servicio ID de visitante de Experience Cloud

El servicio de ID de visitante permite identificar a usuarios en todas las soluciones de Adobe Experience Cloud. Debe implementar o migrar a la versión requerida del ID de visitante de Experience Cloud. Para obtener más información, consulte “Requisitos de implementación” en Antes de la implementación.

See Implement the Experience Cloud ID Service for Target in the Experience Cloud Visitor ID Service documentation.

Paso 4: Actualizar AppMeasurement para JavaScript o s_code

Debe implementar o migrar a la versión requerida de appMeasurement.js. Para obtener más información, consulte “Requisitos de implementación” en Antes de la implementación.

Para nuevas implementaciones, consulte Introducción a la implementación de JavaScript en la Guía de implementación de Analytics.

Para realizar una migración, consulte Migración a AppMeasurement para JavaScript en la Guía de implementación de Analytics.

Paso 5: Descargar y actualizar at.js

Debe implementar o migrar a la versión requerida de at.js con su cuenta de producción. No es necesario modificar el código.

Para obtener más información, consulte “Requisitos de implementación” en Antes de la implementación.

Paso 6: Host de at.js

Si ya ha implementado at.js, puede reemplazar el archivo existente por la versión actualizada. Para obtener más información, consulte “Requisitos de implementación” en Antes de la implementación.

En caso contrario, el archivo se puede alojar junto con los archivos del servicio ID de visitante y de AppMeasurement for JavaScript. Estos archivos deben alojarse en un servidor web al que se pueda acceder desde todas las páginas del sitio. En el paso siguiente necesitará la ruta de acceso a estos archivos.

Step 7: Reference at.js on all site pages

Incluya at.js debajo de VisitorAPI.js agregando la siguiente línea de código en la etiqueta de cada página:

Para at.js:

<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

Es esencial que VisitorAPI.js se cargue antes que at.js. Si está actualizando un archivo at.js o mbox.js existente, asegúrese de comprobar el orden de carga.

The way the out-of-the-box settings are configured for Target and Analytics integration from an implementation perspective is to use the SDID that is passed from the page to stitch the Target and Analytics request together on the backend automatically for you.

However, if you want more control on how and when to send analytics data related to Target to Analytics for reporting purposes, and you do not want to opt-in to the default settings of having Target and Analytics automatically stitch the analytics data via the SDID, then you can set analyticsLogging = client_side via window.targetGlobalSettings. Nota: Las versiones anteriores a 2.1 no son compatibles con este método.

Por ejemplo:

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

Esta configuración tiene un efecto global, lo que significa que cada llamada realizada por at.js enviará analyticsLogging: "client_side" en las solicitudes de y devolverá una carga útil de Analytics para cada solicitud. Target Cuando se configura, el formato de la carga útil que se devuelve es el siguiente:

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

La carga útil se puede reenviar a Analytics mediante la API de inserciónde datos. Tenga en cuenta que, para las actividades de asignación automática y de Destinatario automático, también deberá reenviar el sessionId. Para obtener más información, consulte el sistema de informes Analytics para Destinatario (A4T) en la guía SDK de Adobe Target.

Si no desea una configuración global y prefiere un método bajo demanda, puede utilizar la función at.js getOffers() para conseguirlo al pasar analyticsLogging: "client_side". The analytics payload will be returned for only this call and the Target backend will not forward the payload to Analytics. By pursuing this approach, every at.js Target request will not return the payload by default, but instead only when desired and specified.

Por ejemplo:

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Esta llamada invoca una respuesta desde la cual puede extraer la carga útil de Analytics.

La respuesta es la siguiente:

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

La carga útil se puede reenviar a Analytics través de la API de inserciónde datos.

Paso 8: Validar la implementación

Cargue sus páginas después de haber actualizado las bibliotecas de JavaScript para confirmar que los valores del parámetro mboxMCSDIDTarget en las llamadas de coinciden con el valor del parámetro sdidAnalytics en la llamada de vista de página de

Es especialmente importante confirmar esto en las aplicaciones de una sola página (SPA), donde el orden de las llamadas no siempre es predecible.

Nota: Es necesario que estos valores coincidan para que A4T funcione correctamente.

Paso 9 (opcional): Eliminar el código de integración anterior

Recomendamos quitar la integración anterior para simplificar la implementación y que no resulte necesario resolver discrepancias entre los sistemas. Puede eliminar cualquier código que haya implementado para una integración anterior de SC a T&T, como mboxLoadSCPlugin.

Paso 10: Habilitar las opciones para usar Analytics como fuente de informes para Target

In Target, click Administation > Visual Experience Composer and choose either Select per activity or Adobe Analytics to enable the options.

  • **La opción Seleccionar por actividad permite elegir entre y a la hora de crear cada actividad.**TargetAnalytics
  • **La opción Adobe establece Analytics como fuente de informes para todas las actividades que cree.**Analytics

En esta página