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 de 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 ingresan al sitio web. Estos ID identifican a los usuarios en todas las soluciones de Experience Cloud y son necesarios si desea realizar DCS llamadas.

  • Se requiere user ID para identificar y asociar datos con un visitante en particular.
  • El region ID es necesario porque está vinculado a un nombre de servidor regional, que debe enviar datos al DCS. El DCS almacena información en los centros de datos más cercanos geográficamente 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. En la tabla siguiente se describen las tareas o 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 de Experience Cloud

Necesita una cuenta Experience Cloud para utilizar el servicio de ID. Si tiene una cuenta de 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 Habilitación de sus soluciones para servicios principales.

2. Configure el servicio de ID

El servicio de ID consiste en 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 (a veces llamado indicio de ubicación), que está asociado con 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 Uso de 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.

Trabajar 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 llamada de retorno

callback es opcional. Esta función funciona sin ella, pero devuelve un ID únicamente cuando un visitante tiene una cookie Experience Cloud en su explorador. Si falta la cookie de 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 evitarlo, callback fuerza a esta función a buscar 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 haya escrito en el explorador del visitante más adelante.

Pasos siguientes

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

En esta página