Obtención de ID y regiones de usuario a través del servicio de identidad de Adobe Experience Platform

Los clientes del servicio de ID deben consultar esta sección para obtener información sobre cómo leer la cookie del visitante para los ID necesarios para realizar DCS llamadas de API.

El servicio de identidad de Adobe Experience Platform asigna ID de visitante y región a los usuarios que llegan al sitio web. Estos ID identifican a los usuarios en todas las soluciones de Experience Cloud y son necesarios si desea realizar DCS llamadas.

  • El user ID es necesario para identificar y asociar datos con un visitante en particular.
  • El region ID es obligatorio porque está vinculado a un nombre de servidor regional, que debe enviar datos al DCS. El DCS almacena información en centros de datos geográficamente más cercanos a los visitantes del sitio. Consulte DCS Region IDs, Locations, and Host Names (ID de región de DCS, ubicaciones y nombres de host).

Los clientes del servicio de ID pueden extraer esta información de la cookie del servicio de ID o llamando a una función . La tabla siguiente describe las tareas o los pasos que debe completar para comenzar.

El código de cursiva representa un marcador de posición de variable.

Tarea Descripción

1. Compruebe su estado del Experience Cloud

Necesita una cuenta Experience Cloud para utilizar el servicio de ID. Si tiene una cuenta Experience Cloud, ¡buena!

Si no forma parte del Experience Cloud , regístrese. Nos encantaría tenerte y siempre hay espacio para más. Para obtener instrucciones sobre cómo configurar una cuenta, consulte Activación de las soluciones para los servicios principales.

2. Configurar el servicio de ID

El servicio de ID consta de código JavaScript que se coloca en cada página que desee utilizar para la recopilación de datos. Consulte las guías de implementación del servicio de ID para obtener más información.

3. Lea la cookie del servicio de ID

El servicio de ID almacena el ID de usuario y región en la cookie AMCV. El nombre completo de la cookie es AMCV_###@AdobeOrg. Los elementos ### son marcadores de posición para su ID de organización. Consulte Cookies y el ID de Experience Cloud para obtener más información.

Analice la cookie AMCV para estos pares clave-valor:

  • mid=user ID: Este par clave-valor contiene el ID de usuario de Experience Cloud.
  • aamlh=region ID: Este par clave-valor contiene el ID de región (también llamado indicio de ubicación) asociado a un nombre de servidor regional.

Puede realizar llamadas al DCS una vez que tenga los ID de usuario y región.

4. Recupere el ID de Experience Cloud con getMarketingCloudVisitorID

(Opcional) Esta función devuelve el ID de visitante de Experience Cloud. Está diseñado para soluciones personalizadas y casos de uso específicos. Consulte Trabajo con getMarketingCloudVisitorID a continuación y la documentación del servicio de ID relacionada.

No es necesario que utilice esto si obtiene los ID de usuario y ubicación de la cookie del servicio de ID.

Trabajo con getMarketingCloudVisitorID

Otra forma de obtener el ID de visitante es con la función getMarketingCloudVisitorID . Cuando se invoca, esta función consulta el ID service y devuelve un ID. getMarketingCloudVisitorID acepta el callback argumento opcional como se muestra a continuación:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Uso y propósito de devolución de llamada

callback es opcional. Esta función funciona sin él, pero devuelve un ID solo cuando un visitante tiene una cookie [!DNL Experience Cloud] en su explorador. Si falta la cookie del visitante o un visitante no tiene un ID, la función devuelve un objeto () vacío. Esto puede suceder incluso después de que la página se cargue y el visitante reciba un nuevo ID. Para evitar esto, callback fuerza a esta función a comprobar si hay un ID de visitante después de que se cargue la página. Sin callback, la función de ID de visitante no devolverá un ID aunque se escriba en el explorador del visitante más adelante.

Pasos siguientes

Una vez que tenga el ID de usuario y región, puede empezar a enviar y recibir datos DCS. Consulte Realización de llamadas a la API DCS.

En esta página