Se requieren varios pasos al implementar Adobe Analytics como fuente de sistema de informes para Target (A4T).
Las siguientes secciones describen los pasos necesarios para implementar esta integración en el sitio.
Después de implementar Analytics como fuente de sistema de informes para Target, debe estar aprovisionado para Analytics y Target. Rellene este formulario para solicitar el aprovisionamiento.
Los requisitos de cuenta de usuario deben cumplirse antes de poder crear una actividad basada en Analytics en Target. Consulte Requisitos de permisos de usuario.
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.
Consulte Implementar el servicio de ID de Experience Cloud para Destinatario en la documentación del servicio de ID de Visitante de Experience Cloud.
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 información general sobre la implementación de JavaScript en la Guía de implementación de Analytics.
Para ver una migración, consulte Migración a AppMeasurement para JavaScript en la Guía de implementación de Analytics.
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.
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.
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.
La manera en que la configuración predeterminada se configura para la integración Target y Analytics desde una perspectiva de implementación es utilizar automáticamente el SDID que se pasa desde la página para unir la solicitud Target y Analytics en el servidor.
Sin embargo, si desea obtener más control sobre cómo y cuándo enviar datos de análisis relacionados con Target a Analytics con fines de sistema de informes, y no desea optar por la configuración predeterminada de Target y Analytics unir automáticamente los datos de análisis mediante el 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 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ón de datos. Tenga en cuenta que, para las actividades Asignación automática y 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 para 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". La carga útil de Analytics se devolverá solo para esta llamada y el servidor Target no reenviará la carga útil a Analytics. Al seguir este método, cada solicitud de at.js Target no devolverá la carga útil de forma predeterminada, sino únicamente cuando se desee y se especifique.
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.
Cargue sus páginas después de haber actualizado las bibliotecas de JavaScript para confirmar que los valores del parámetro mboxMCSDID
Target en las llamadas de coinciden con el valor del parámetro sdid
Analytics 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.
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
.
En Target, haga clic en Administración > Compositor de experiencias visuales y elija Seleccionar por actividad o Adobe Analytics para habilitar las opciones.