Documentación Guía del servicio de identidad

Implementación del servicio de identidad de Experience Cloud para Analytics, Audience Manager y Target

Última actualización: 18 de julio de 2024

Temas:

Creado para:

Desarrollador
Usuario
Administrador
Líder

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

IMPORTANT

Lea los requisitos del servicio de ID antes de empezar y tenga en cuenta los requisitos a continuación que son específicos de esta implementación:

Los clientes que utilizan s_code no pueden completar este procedimiento. Actualice al código de mbox 61 para completar este procedimiento.
Configure y pruebe este código en un entorno de desarrollo antes de implementarlo en producción.

Paso 1: Planificación del reenvío del lado de servidor

Además de los pasos descritos aquí, los clientes que usan Analytics y Audience Manager deben migrar al reenvío del lado de 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:

Trabaje con sus contactos de Analytics y Audience Manager para planificar el servicio de ID y la migración de reenvío del lado de servidor. Haga que la selección de un servidor de seguimiento conforme una parte importante de este plan.
Complete el formulario en el Sitio de integraciones y aprovisionamiento para empezar.
Implementar el servicio de ID y el Audience Management Module simultáneamente. Para que funcione correctamente, el Audience Management Module módulo Gestión de audiencias (reenvío del lado de servidor) y el servicio de ID deben iniciarse para el mismo conjunto de páginas y de forma simultánea.

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

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

Vaya a Administración > Administrador de códigos.
En Administrador de códigos, haga clic en JavaScript (nuevo) o JavaScript (heredado). Se descargarán las bibliotecas de códigos comprimidas.
Descomprima el archivo de códigos y abra el VisitorAPI.js archivo.

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

IMPORTANT

Las versiones anteriores de la API de servicio de ID ubicaban esta función en una ubicación diferente y requerían una sintaxis diferente. Si va a realizar la migración desde una versión anterior a la versión 1.4, tenga en cuenta la nueva ubicación y sintaxis documentadas aquí.
El código en MAYÚSCULAS es un marcador de posición para los valores reales. Reemplace este texto con el identificador de organización, la URL del servidor de seguimiento u otro valor con nombre.

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 API.js de Visitante

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 4: 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 ID de organización de Experience Cloud. Si no conoce su ID de organización, puede encontrarlo en la página de administración de Experience Cloud. Su función editada podría tener un aspecto similar al ejemplo siguiente.

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

IMPORTANT

Respete las mayúsculas y minúsculas de su ID de organización. El ID distingue entre mayúsculas y minúsculas y debe escribirse exactamente como se facilita.

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

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:

s.trackingServer
s.trackingServerSecure

Parte 2: Configurar las variables del servidor de seguimiento

Para determinar qué variables de servidor de seguimiento utilizar:

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

NOTE

Cuando se usen, combine las URL del servidor de Experience Cloud con las URL de su servidor de seguimiento correspondiente de esta manera:

URL del servidor de Experience Cloud = URL del servidor de seguimiento
URL segura del servidor de Experience Cloud = URL segura del servidor de seguimiento

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

Este procedimiento 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-MARKETING-CLOUD-ORGANIZATION ID-HERE");

IMPORTANT

En este punto deberá eliminar el código Audience Manager DIL de y sustituirlo por el módulo Gestión de público. Consulte Implementar reenvío del lado del servidor para obtener instrucciones.

(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

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.

Paso 8: (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 periodo de gracia si dispone de páginas que usan el servicio de ID 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 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 también la información relativa a las Cookies y el servicio de identidad Experience Cloud.

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 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.

Paso 9: Prueba y verificación

Las soluciones de Experience Cloud de esta implementación devuelven ID en forma de pares clave-valor. Cada solución utiliza claves diferentes (p. ej., el Analytics SDID de frente al Target mboxMCSDID de) para guardar el mismo ID. Para probar su implementación, cargue sus páginas en un entorno de desarrollo. Utilice la consola de su navegador o software que permita supervisar las solicitudes y respuestas HTTP para comprobar los ID que aparecen a continuación. El servicio de ID se ha implementado correctamente cuando los pares clave-valor que se enumeran a continuación devuelven los mismos valores de ID.

TIP

Puede utilizar Adobe Debugger o el proxy HTTP Charles para buscar estos ID específicos de soluciones. No obstante, es libre de usar la herramienta o el depurador que más le convenga.

Todas las soluciones

Compruebe:

La cookie AMCV en el dominio en el que está alojada su página.
El ID de Experience Cloud (MID) con la herramienta de depuración de Adobe o su herramienta de depuración favorita.

Para realizar comprobaciones adicionales que permitan determinar si el servicio de identidad funciona correctamente, consulte Prueba y verificación del servicio de identidad de Experience Cloud.

Analytics

Compruebe el identificador SDID en la solicitud de JavaScript. El SDID de Analytics debe coincidir con el mboxMCSDID de Target.

Si las pruebas devuelven un AID, esto indica cualquiera de los siguientes factores:

Usted es un visitante que regresa en el proceso de migrar Analytics ID de heredados.
Tiene un período de gracia habilitado.

Si ve un AID, compare su valor con el Target mboxMCAVID de. Estos valores son idénticos cuando el servicio de ID se ha implementado correctamente.

Audience Manager

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

Target

Compruebe:

mboxMCGVID
mboxMCSDID (el mboxMCSDID debe coincidir con el SDID de Analytics).

Si las pruebas devuelven un mboxMCAVID, esto indica cualquiera de las siguientes opciones:

Usted es un visitante que regresa en el proceso de migrar Analytics ID de heredados.
Tiene un período de gracia habilitado.

Si ve un mboxMCAVID, compare su valor con el Analytics AID de. Estos valores son idénticos cuando el servicio de ID se ha implementado correctamente.

Implementación

Paso 10: Implementación

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

Si habilitó un periodo de gracia:

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

recommendation-more-help