Implementación de Analytics for Target

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 se implementa A4T con la variable Adobe Experience Platform Web SDK o con at.js.

Pasos de implementación para una implementación del SDK web de Adobe Experience Platform

Las secciones siguientes describen los pasos necesarios para implementar esta integración en su sitio si planea utilizar el SDK web de Platform:

Paso 1: Solicitar aprovisionamiento para Analytics y Target

Antes de implementar A4T, debe aprovisionarse 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 una actividad basada en Analytics en Target. Consulte Requisitos de permisos de usuario.

Paso 3: Crear una configuración de Edge

Crear una configuración de Edge usando Adobe Experience Platform con la herramienta de configuración de edge. Configure las variables Analytics and Target configuración de edge.

Paso 4: Instalación y configuración del SDK web de Platform

Para empezar a entregar Target experiencias y aplicar Analytics con fines de seguimiento y análisis, Instalar y configure el SDK web de Platform en las páginas del sitio.

Paso 5: Habilitar las opciones para utilizar A4T

En el Target IU, haga clic en Administración > Compositor de experiencias visuales, elija Seleccionar por actividad o Adobe Analytics.

• **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

Pasos de implementación para una implementación de at.js

Las secciones siguientes describen los pasos necesarios para implementar esta integración en su sitio si planea utilizar at.js:

Paso 1: Solicitud de 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. 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 una Analyticsactividad basada 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 usuarios en todas las soluciones de Adobe Experience Cloud. 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 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 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.

Paso 7: Haga referencia a at.js en todas las páginas del sitio

Incluya at.js debajo de VisitorAPI.js ; para ello, agregue la línea de código siguiente 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>

VisitorAPI.js debe cargarse antes que at.js. Si va a actualizar un archivo at.js existente, asegúrese de comprobar el orden de carga.

La configuración predeterminada para Target y Analytics , desde una perspectiva de implementación, es utilizar el SDID que se pasa desde la página para unir Target y Analytics solicite conjuntamente en el backend automáticamente.

Puede controlar cómo y cuándo enviar datos de análisis relacionados con Target a Analytics a efectos de la elaboración de informes. Si no desea utilizar la configuración predeterminada de Target y Analytics vincular automáticamente los datos de análisis mediante el SDID, establezca 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 tiene analyticsLogging: "client_side" enviado dentro de la variable Target se devuelven solicitudes y una carga útil de analytics para 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"
   }
}

A continuación, la carga útil se puede reenviar a Analytics mediante el complemento 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 la sección 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() pasando analyticsLogging: “client_side”. La carga útil de Analytics solo se devuelve para esta llamada y la variable Target backend no reenvía la carga útil a Analytics. Al seguir este enfoque, cada at.js Target de forma predeterminada, devuelve la carga útil, 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 la variable 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 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 que estos valores coinciden en las aplicaciones de una sola página (SPA), donde 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

En Target, haga clic en Administración > Compositor de experiencias visuales y elija Seleccionar por actividad o Adobe Analytics para activar las opciones.

• **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