Implementación del servicio de ID de visitante de Adobe para Analytics y Audience Manager implement-the-experience-cloud-id-service-for-analytics-and-audience-manager

Estas instrucciones están destinadas a los clientes de Analytics y Audience Manager que desean utilizar el servicio de ID de visitante y no utilizan tags. Sin embargo, le recomendamos encarecidamente que utilice etiquetas para implementar el servicio de ID de visitante. Las etiquetas optimizan el flujo de trabajo de implementación y garantizan automáticamente la correcta ubicación y secuenciación del código.

Paso 1: Planificación del reenvío del lado de servidor section-880797cc992d4755b29cada7b831f1fc

Además de los pasos descritos aquí, los clientes que utilizan Analytics y Audience Manager deben migrar al reenvío del lado del servidor. El reenvío del lado del servidor permite eliminar DIL (código de recopilación de datos de Audience Manager) y sustituirlo por el Módulo de Gestión de público. Consulte la documentación del reenvío del lado del servidor para obtener más información.

La migración al reenvío del lado del servidor requiere planificación y coordinación. Este proceso incluye cambios externos en el código del sitio y pasos internos que Adobe debe realizar para aprovisionar la cuenta. De hecho, muchos de estos procedimientos de migración deben realizarse en paralelo y ponerse en libertad juntos. La ruta de implementación debe seguir esta secuencia de eventos:

Paso 2: Descarga del código del servicio de ID de visitante section-0780126cf43e4ad9b6fc5fe17bb3ef86

El servicio de ID de visitante requiere la biblioteca de códigos VisitorAPI.js. Para descargar esta biblioteca de códigos:

Paso 3: Añadir la función Visitor.getInstance al código del servicio de ID de visitante section-9e30838b4d0741658a7a492153c49f27

Parte 1: Copie la función Visitor.getInstance a continuación

var visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

Parte 2: Agregar código de función al archivo VisitorAPI.js

Coloque la Visitor.getInstance función al final del archivo, después del bloque de códigos. El archivo editado debería tener un aspecto similar a este:

/*
========== DO NOT ALTER ANYTHING BELOW THIS LINE ==========
Version and copyright section
*/

// Visitor API code library section

// Put Visitor.getInstance at the end of the file, after the code library

var visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

Paso 4: Añadir su ID de organización de IMS a Visitor.getInstance section-e2947313492546789b0c3b2fc3e897d8

En la función Visitor.getInstance, reemplace INSERT-IMS-ORG-ID-HERE por su ID de organización de IMS. Si no conoce su ID de organización de IMS, puede encontrarlo en la página de administración de CX Enterprise. Su función editada podría tener un aspecto similar al ejemplo siguiente.

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

Paso 5: Añadir sus servidores de seguimiento a Visitor.getInstance section-0dfc52096ac2427f86045aab9a0e0dfc

Analytics utiliza servidores de seguimiento para recopilar datos.

Parte 1: Búsqueda de las URL de su servidor de seguimiento

Consulte sus archivos s_code.js o AppMeasurement.js para buscar las URL del servidor de seguimiento. Buscará las URL especificadas por estas variables:

Parte 2: Configurar las variables del servidor de seguimiento

Para determinar qué variables de servidor de seguimiento utilizar:

Si no está seguro de cómo encontrar su servidor de seguimiento, consulte las preguntas frecuentes y Rellenar correctamente las variables trackingServer y trackingServerSecure.

Paso 6: Actualización del archivo AppMeasurement.js section-5517e94a09bc44dfb492ebca14b43048

Este paso requiere AppMeasurement. No podrá continuar si aún utiliza s_code.

Añada la Visitor.getInstance función que se muestra a continuación a su AppMeasurement.jsarchivo. Colóquela en la misma sección que contenga configuraciones como linkInternalFilters, charSet, trackDownloads, etc.:

s.visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE");

(Opcional, pero recomendada) Crear una variable prop personalizada.

Establezca una prop personalizada en AppMeasurement.js para medir la cobertura. Agregue esta variable prop personalizada a la doPlugins función de su AppMeasurement.js archivo:

// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Paso 7: Añadir el código de API de visitante a la página section-c2bd096a3e484872a72967b6468d3673

Coloque el VisitorAPI.js archivo dentro de las etiquetas <head> en cada página. Cuando coloque el VisitorAPI.js archivo en su página:

Paso 8: (Opcional) Configuración de un período de gracia section-aceacdb7d5794f25ac6ff46f82e148e1

Si alguno de estos casos de uso se aplica a su situación, pida al Servicio de atención al cliente que configure un periodo de gracia temporal. Los períodos de gracia pueden durar hasta 180 días. Si es necesario, puede renovar un periodo de gracia.

Implementación parcial

Necesita un periodo de gracia si dispone de páginas que usan el servicio de ID de visitante y otras que no, y todas reportan al mismo grupo de informes de Analytics. Esto es común si tiene un grupo de informes globales que informa entre dominios.

Interrumpa el periodo de gracia una vez que el servicio de ID de visitante se haya implementado en todas las páginas web que informan en el mismo grupo de informes.

Requisitos de la cookie s_vi

Necesita un periodo de gracia si necesita nuevos visitantes para tener una cookie s_vi después de migrar al servicio de ID de visitante. Esto es común si su implementación lee la cookie s_vi y la almacena en una variable.

Interrumpa el periodo de gracia después de que la implementación pueda capturar el MID en lugar de leer la cookie s_vi.

Consulte también Cookies y el servicio de identificación del visitante.

Integración de flujo de navegación

Necesita un período de gracia si envía datos a un sistema interno desde una fuente de datos de flujo de navegación y si sus procesos utilizan las columnas visid_high y visid_low.

Interrumpa el periodo de gracia una vez que su proceso de ingesta de datos pueda utilizar las columnas post_visid_high y post_visid_low.

Consulte Referencia de columnas de datos del flujo de navegación.

Paso 9: Prueba e implementación del código de servicio de ID de visitante section-f857542bfc70496dbb9f318d6b3ae110

Puede realizar pruebas e implementaciones de la siguiente manera.

Prueba y verificación

Para probar la implementación del servicio de ID de visitante, compruebe:

Para verificar el reenvío del lado del servidor, consulte Comprobar la implementación del reenvío del lado del servidor.

Implementar

Implemente el código después de pasar la prueba.

Si habilitó un periodo de gracia: