Show Menu
TEMAS×

Implementación de Analytics for Target

Se requieren varios pasos a la hora de implementar Adobe Analytics como fuente de informes para Target (A4T).

Pasos de la implementación

En la tabla siguiente se describen los pasos necesarios para implementar esta integración en un sitio.

Paso 1: Solicitar el aprovisionamiento para Analytics y Target

Después de implementar Analytics como fuente de informes para Target, debe aprovisionar para Analytics y Target. Rellene este formulario para solicitar el aprovisionamiento .

Paso 2: Configurar los permisos de usuario

Deben cumplirse los requisitos de cuenta de usuario para poder crear en Adobe Target una actividad basada en Adobe Analytics. Consulte Requisitos de permisos de usuario .

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 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 .
Consulte Implementación del servicio de Experience Cloud ID para Target en la documentación del servicio ID de visitante de Experience Cloud.

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 o mbox.js

Debe implementar o migrar a la versión requerida de at.js o mbox.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 at.js o mbox.js

Si ha implementado anteriormente at.js o mbox.js, puede reemplazar el archivo existente con 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.

Paso 7: Agregar la referencia de at.js o mbox.js a todas las páginas del sitio.

Incluya at.js o mbox.js debajo de VisitorAPI.js. Para ello, agregue la siguiente línea de código dentro de la etiqueta de todas las páginas:
Para at.js:
<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

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

Es esencial que VisitorAPI.js se cargue antes que at.js o mbox.js. Si va a actualizar un archivo at.js o mbox.js existente, compruebe el orden de carga.
La forma en la que los ajustes predeterminados están configurados para la integración de Target y Analytics desde una perspectiva de implementación es utilizar el SDID que se pasa desde la página para unir la solicitud de Target y Analytics en forma conjunta en el backend automáticamente.
Sin embargo, si desea tener más control sobre cómo y cuándo enviar datos de análisis relacionados con Target a Analytics con fines de creación de informes, y no desea utilizar la configuración predeterminada de que Target y Analytics incluyan automáticamente los datos de análisis a través del SDID, puede establecer analyticsLogging = client_ side mediante 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 Target y devolverá una carga útil de Analytics para cada solicitud. 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ón de datos.
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" . La carga útil de Analytics solo se devolverá para esta llamada, y el backend de Target no reenviará la carga útil a Analytics. Al llevar a cabo este enfoque, cada solicitud de at.js de Target no devolverá la carga útil de forma predeterminada, sino solo si se desea y se especifica.
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 mediante la API de inserción de 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 mboxMCSDID en las llamadas de Target coinciden con el valor del parámetro sdid en la llamada de vista de página de Analytics.
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

En Target, haga clic en Configuración &gt; Preferencias y elija Seleccionar por actividad o Adobe Analytics para habilitar las opciones.
  • La opción Seleccionar por actividad permite elegir entre Target y Analytics a la hora de crear cada actividad.
  • La opción Adobe Analytics establece Analytics como fuente de informes para todas las actividades que cree.