Implementación del servicio de identidad de Experience Cloud para Analytics

Estas instrucciones están destinadas a los clientes de Analytics que desean utilizar el servicio de Experience Cloud ID y no utilizan Dynamic Tag Management (DTM). Sin embargo, le recomendamos encarecidamente que utilice DTM al implementar el servicio de ID. DTM optimiza el flujo de trabajo de implementación y garantiza automáticamente la correcta ubicación y secuenciación del código.

Siga estos pasos para implementar el servicio de ID para Adobe Analytics:

1. Descarga del código del servicio de ID
2. Añadir la función Visitor.getInstance al código de servicio de ID
3. Añadir su ID de organización de Experience Cloud a Visitor.getInstance
4. Añadir sus servidores de seguimiento a Visitor.getInstance.
5. Actualización de su archivo AppMeasurement.js o s_code.js
6. Añadir el código de API de visitante a la página
7. (Opcional) Configurar un periodo de gracia
8. Prueba e implementación del código de servicio de ID

Paso 1: Descarga del código del servicio de ID

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

1. Vaya a Administración > Administrador de códigos.

2. En Administrador de códigos, haga clic en JavaScript (nuevo) o JavaScript (heredado).

   Se descargarán las bibliotecas de códigos comprimidas.

3. Descomprima el archivo de códigos y abra el VisitorAPI.js archivo.

Paso 2: Añadir la función Visitor.getInstance al código de servicio de ID

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

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-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: Añadir 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-MARKETING-CLOUD-ORGANIZATION-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 3: Añadir su ID de organización de Experience Cloud a Visitor.getInstance

En la Visitor.getInstance función, sustituya INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE por su Experience Cloud ID de organización de. Si no conoce su ID de organización, puede encontrarlo en la página de administración de Experience Cloud. Consulte también Administración - Servicios principales. Su función editada podría tener un aspecto similar al ejemplo siguiente.

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

Paso 4: Añadir sus servidores de seguimiento a Visitor.getInstance

Los servidores de seguimiento se emplean para la recopilación de datos de Analytics.

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:

• s.trackingServer
• s.trackingServerSecure

Parte 2: Configurar las variables del servidor de seguimiento

Para determinar qué variables de servidor de seguimiento utilizar:

1. Responda las preguntas de la matriz de decisión siguiente. Utilice las variables que correspondan a sus respuestas.
2. Reemplace los marcadores de posición del servidor de seguimiento con las direcciones URL del servidor de seguimiento.
3. Elimine las variables del servidor de seguimiento y del Experience Cloud servidor de no utilizadas del código.

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 5: Actualización de su archivo AppMeasurement.js o s_code.js

Añada esta función a su archivo AppMeasurement.js o s_code.js:

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

Coloque el código en la misma sección que contenga configuraciones como linkInternalFilters, charSet, trackDownloads, etc.

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

Configurar una variable prop personalizada en AppMeasurement.js o s_code.js para medir la cobertura. Añada esta variable prop personalizada a la doPlugins función de sus archivos AppMeasurement.js o s_code.js:

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

Paso 6: Añadir el código de API de visitante a la página

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

• Hágalo al principio de la <head> sección, de modo que aparezca antes que las etiquetas de otras soluciones.
• Debe ejecutarse antes de AppMeasurement y el código de otras soluciones de Experience Cloud.

Mueva este código a producción después de la prueba y verificación.

Paso 7: (Opcional) Configuración de un período de gracia

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 periodos de gracia pueden durar hasta 180 días. Si es necesario, puede renovar un periodo de gracia.

Implementación parcial

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

Interrumpa el periodo de gracia después de implementar el servicio de ID 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. 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 Cookies y el servicio de Experience Cloud ID.

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 consumo de datos pueda utilizar las columnas post_visid_high y post_visid_low.

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

Consumo de datos de flujo de navegación

Paso 8: Prueba e implementación del código de servicio de ID

Puede realizar pruebas e implementaciones de la siguiente manera.

Prueba y verificación

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

• La cookie AMCV en el dominio en el que está alojada su página.
• Valor MID en la solicitud de imagen de Analytics con la herramienta Adobe Debugger.

Consulte Comprobación y verificación del servicio de identidad de Experience Cloud.

Implementación de código

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

Si habilitó un periodo de gracia en el paso 7:

• Asegúrese de que el Analytics ID de (AID) y el MID estén en la solicitud de imagen.
• Recuerde deshabilitar el período de gracia cuando se cumplan los criterios para ello.

Recursos de Business.Adobe.com