Show Menu
TOPICS×

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

Estas instrucciones están destinadas a los clientes de Analytics y Audience Manager que desean utilizar el servicio de identidad 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.
  • Lea los requisitos antes de comenzar.
  • Este procedimiento requiere AppMeasurement. Los clientes que usen s_code no podrán 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 de servidor permite eliminar el código DIL (el código de recopilación de datos de Audience Manager) y sustituirlo por el módulo Gestión de público . Consulte la documentación de reenvío del lado de servidor para obtener más información.
Migrar al reenvío del lado de servidor requiere planificación y coordinación. Este proceso conlleva realizar cambios externos en el código del sitio, así como determinados pasos internos que Adobe debe implementar para aprovisionar su cuenta. De hecho, muchos de estos procedimientos de migración han de suceder en paralelo e implementarse al mismo tiempo. Su ruta de implementación deberá seguir esta secuencia de eventos:
  1. 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.
  2. Complete el formulario en el sitio de aprovisionamiento e integraciones para ponerse en marcha.
  3. 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:
  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 3: Añadir la función Visitor.getInstance al código del servicio de ID

  • 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
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", { ...
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: 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.
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 6: Actualización del archivo AppMeasurement.js

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.js
archivo. 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");
En este punto deberá eliminar el código Audience Manager DIL de y sustituirlo por el módulo Gestión de audiencias. Consulte las instrucciones en Implementar el reenvío del lado de servidor .
***(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

If any of these use cases apply to your situation, ask Customer Care to set up a temporary grace period . Los períodos de gracia pueden prolongarse hasta 180 días. Si es necesario, puede renovar un período de gracia.
Implementación parcial
Necesita un período de gracia si hay páginas que usan el servicio de ID y otras no, y si todas envían su informe 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 también la información relativa a las Cookies y el servicio de Experience Cloud ID .
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
.

Paso 9: 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:
Para verificar el reenvío del lado del servidor, vea Cómo verificar la implementación del reenvío del lado del servidor
Implementación
Implementación del código una vez pasada la prueba.
Si ha habilitado un período de gracia:
  • 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.