Implementación del servicio Experience Cloud ID para Analytics

Estas instrucciones están destinadas a los clientes de Analytics que desean utilizar el servicio de ID de Experience Cloud y no utilizan Dynamic Tag Management (DTM). No obstante, le recomendamos encarecidamente que utilice DTM para implementar el servicio de ID. DTM racionaliza el flujo de trabajo de implementación y garantiza la colocación y secuencia correcta del código automáticamente.

Importante:
  • Lea los requisitos antes de comenzar.
  • Configure y pruebe este código en un entorno de desarrollo antes de implementarlo en producción.

Paso 1: Descarga del código de 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 archivo VisitorAPI.js.

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

Importante:
  • Las versiones anteriores de la API del servicio de ID ubicaban esta función en un lugar distinto y requerían una sintaxis diferente. Si va a migrar desde una versión anterior a la versión 1.4, anote la nueva ubicación y la sintaxis documentadas aquí.
  • El código que aparece TODO EN MAYÚSCULAS funciona como marcador de posición para valores reales. Sustituya este texto por el ID de su organización, la URL del servidor de seguimiento u otro valor con nombre.

Parte 1: Copia de 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: Adición del código de función al archivo VisitorAPI.js

Coloque la función Visitor.getInstance 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: Adición de su ID de organización de Experience Cloud a Visitor.getInstance

En la función Visitor.getInstance, 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. 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", { ...

Importante: 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 4: Adición de 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: Establecimiento de variables del servidor de seguimiento

Para determinar las variables del servidor de seguimiento que se van a emplear:

  1. Responda las preguntas de la matriz de decisión siguiente. Use las variables que se correspondan con las respuestas.
  2. Sustituya los marcadores del servidor de seguimiento por las URL de su servidor de seguimiento.
  3. Elimine las variables del servidor de seguimiento y del servidor de Experience Cloud no utilizadas del código.

Nota: 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 más 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) Crear 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 función doPlugins 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: Adición del código de API de visitante a la página

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

  • Hágalo al principio de la sección <head>, 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 se corresponde con su situación, pida al Servicio de atención al cliente que configure un período de gracia temporal. Los períodos de gracia pueden prolongarse hasta 180 días. Si es necesario, puede renovar un período de gracia.

Caso de uso Descripción

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 informes de Analytics. Esta suele ser la situación habitual cuando se tiene un grupo de informes global que reporta entre dominios.

Interrumpa el período de gracia una vez que se haya implementado el servicio de ID en todas las páginas web que reportan al mismo grupo de informes.

Requisitos de la cookie s_vi

Necesita un período de gracia si necesita que nuevos visitantes tengan una cookie s_vi después de migrar al servicio de ID. Esto es lo habitual si su implementación lee la cookie s_vi y la almacena en una variable.

Interrumpa el período de gracia cuando su implementación pueda capturar el MID en lugar de leer la cookie s_vi.

Consulte Las cookies y el servicio Experience Cloud ID.

Consumo de datos 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 período 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 8: Prueba e implementación del código de servicio de ID

Procedimiento Descripción

Prueba y verificación

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

Consulte Comprobación y verificación del servicio Experience Cloud ID

Implementación

Implementación del código una vez pasada la prueba.

Si ha habilitado un período de gracia en el Paso 7:

  • Asegúrese de que el ID de Analytics (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.