Analytics para Target implementación
Se requieren varios pasos al implementar Adobe Analytics como fuente de informes para Adobe Target (A4T). El proceso varía en función de si implementa A4T con la variable Adobe Experience Platform Web SDK o con at.js.
Pasos de implementación de un SDK web de Adobe Experience Platform platform
En las secciones siguientes se describen los pasos necesarios para implementar esta integración en el sitio si tiene pensado utilizar el SDK web de Platform:
Paso 1: Solicitar aprovisionamiento para Analytics y Target
Antes de implementar A4T, debe estar aprovisionado para Analytics y Target. Utilice este formulario para solicitar el aprovisionamiento.
Paso 2: Configurar los permisos de usuario
Deben cumplirse los requisitos de cuenta de usuario para poder crear una actividad basada en Analytics in Target. Consulte Requisitos de permisos de usuario.
Paso 3: Crear una configuración de Edge
Creación de una configuración de Edge con Adobe Experience Platform uso de la herramienta de configuración edge. Configure las variables Creación y configuración de flujos de datos.
Paso 4: Instalación y configuración del SDK web de Platform
Para empezar a enviar Target experiencias y para aplicar Analytics para fines de seguimiento y análisis, Instalar y configurar el SDK web de Platform en las páginas del sitio.
Paso 5: Habilitar las opciones para usar A4T
En el Target IU, haga clic en Administration > Visual Experience Composer y, a continuación, elija Select per activity o Adobe Analytics.
- Select per activity permite elegir entre Target y Analytics al crear cada actividad.
- Adobe Analytics conjuntos Analytics como fuente de informes para todas las actividades que cree.
Pasos de implementación para una implementación de at.js section_73961BAD5BB4430A95E073DE5C026277
Las secciones siguientes describen los pasos necesarios para implementar esta integración en su sitio si planea utilizar at.js:
Paso 1: Solicitar el aprovisionamiento para Analytics y Target
Después de la implementación Analytics como fuente de informes para Target, debe estar aprovisionado para Analytics y Target. Utilice este formulario para solicitar el aprovisionamiento.
Paso 2: Configurar los permisos de usuario
Deben cumplirse los requisitos de cuenta de usuario para poder crear un Analyticsactividad basada en en en Target. 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 los usuarios en Adobe Experience Cloud soluciones. Implemente o migre 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 ID de Experience Cloud para Target en el Servicio de ID de visitante de Experience Cloud documentación.
Paso 4: Actualizar AppMeasurement para JavaScript o s_code
Implemente o migre 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 el Guía de implementación de Analytics.
Para ver una migración, consulte Migración a AppMeasurement para JavaScript en el Guía de implementación de Analytics.
Paso 5: Descargar y actualizar at.js
Implemente o migre 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 at.js
Si ha implementado anteriormente at.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 a todas las páginas del sitio step7
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>
VisitorAPI.js debe cargarse antes que at.js. Si está actualizando un archivo at.js existente, asegúrese de comprobar el orden de carga.
La configuración predeterminada para Target y Analytics La integración de, desde una perspectiva de implementación, es utilizar el SDID que se pasa desde la página para unir el Target y Analytics solicitar juntos en el backend automáticamente.
Puede controlar cómo y cuándo enviar datos de análisis relacionados con Target hasta Analytics para fines de informes. Si no desea adherirse a la configuración predeterminada de tener Target y Analytics unir automáticamente los datos de Analytics mediante el SDID, establecido 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 tiene analyticsLogging: "client_side" enviado dentro de Target y se devuelve una carga útil de analytics por cada solicitud. Cuando se configura esta opción, 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 a través de la variable API de inserción de datos. Para las actividades de Asignación automática y Segmentación automática, también debe reenviar el sessionId. Para obtener más información, consulte Creación de informes en Analytics for Target (A4T) en el SDK para Adobe Target guía.
Si no desea una configuración global y prefiere un método bajo demanda, utilice la función at.js getOffers() al pasar analyticsLogging: "client_side". La carga útil de Analytics solo se devuelve para esta llamada y el Target backend no reenvía la carga útil a Analytics. Al llevar a cabo este enfoque, cada at.js Target La solicitud de devuelve la carga útil de forma predeterminada, pero solo cuando 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 a través de API de inserción de datos.
Paso 8: Validar la implementación step8
Cargue las páginas después de actualizar las bibliotecas JavaScript para confirmar que la variable mboxMCSDID
valores de parámetro en Target las llamadas coinciden con sdid
valor de parámetro en Analytics llamada de vista de página.
SPA Es especialmente importante confirmar que estos valores coinciden en Aplicaciones de una sola página () en las que el orden de las llamadas no siempre es predecible.
Paso 9 (opcional): Eliminar el código de integración anterior
Adobe recomienda eliminar la integración anterior para simplificar la implementación y eliminar la necesidad de 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
Entrada Target, haga clic en Administration > Reporting y elija Select per activity o Adobe Analytics para activar las opciones.
- Select per activity permite elegir entre Target y Analytics al crear cada actividad.
- Adobe Analytics conjuntos Analytics como fuente de informes para todas las actividades que cree.