Obtención de ID y regiones de usuario a través del servicio de identidad de Adobe Experience Platform get-user-ids-and-regions-through-the-experience-cloud-id-service

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 llamadas a la API DCS.

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

  • Se requiere user ID para identificar y asociar datos con un visitante en particular.
  • Se requiere el region ID porque está vinculado a un nombre de servidor regional, que necesita para enviar datos al DCS. DCS almacena información en los centros de datos ubicados geográficamente más cerca de 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. Comprueba tu Experience Cloud estado

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

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

2. Configurar el servicio de ID
El servicio de ID consiste en código JavaScript que se coloca en cada página que desee usar para la recopilación de datos. Consulte las guías de implementación del servicio de ID para obtener más información.
3. Leer la cookie del servicio de ID

El servicio de ID almacena el ID de usuario y de 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 Cloudpara obtener más información.

Analice la cookie AMCV para estos pares clave-valor:

  • mid=user ID: este par clave-valor contiene el identificador de usuario Experience Cloud.
  • aamlh=region ID: este par clave-valor contiene el id. de región (a veces denominado indicio de ubicación ) que está asociado con un nombre de servidor regional.

Puede realizar llamadas al DCS de 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 Experience Cloud. Está diseñado para soluciones personalizadas y casos de uso específicos. Vea trabajar con getMarketingCloudVisitorID a continuación y la documentación del servicio de ID relacionada.

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

Trabajando Con getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid

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

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Uso y propósito de la llamada callback-usage

callback es opcional. Esta función funciona sin ella, pero devuelve un ID solo cuando un visitante tiene una cookie Experience Cloud en su explorador. Si falta la cookie del visitante o si un visitante no tiene un ID, la función devuelve un objeto () vacío. Esto puede ocurrir 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 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 más adelante en el explorador del visitante.

Pasos siguientes next-steps

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695