Show Menu
TOPICS×

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). 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.
  • Configure y pruebe este código en un entorno de desarrollo antes de implementarlo en producción.
Siga estos pasos para implementar el servicio de ID para Adobe Analytics:

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

  • 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 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 deExperience 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", { ...
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: 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: 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 Experience Cloud servidor de no utilizadas del código.
Cuando se usen, combine las Experience Cloud URL del servidor de con las URL de su servidor de seguimiento correspondiente de esta manera: >
  • Experience CloudURL del servidor de = URL del servidor de seguimiento
  • Experience CloudURL segura del servidor de = URL segura del servidor de seguimiento
If you're not sure how to find your tracking server see the FAQ and Correctly Populate the trackingServer and trackingServerSecure variables .

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

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 dispone de páginas que usan el servicio de ID y otras que no, y todas reportan al mismo grupo de Analytics informes de. 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.
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
.
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:
Implementación de código
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 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.