Obtention des identifiants de région et d’utilisateur via le service Adobe Experience Platform Identity get-user-ids-and-regions-through-the-experience-cloud-id-service

Les clients du service d’ID doivent se référer à cette section pour plus d’informations sur la lecture du cookie visiteur pour les ID requis pour effectuer des appels API DCS.

Le service Adobe Experience Platform Identity affecte les identifiants de visiteur et de région aux utilisateurs qui se rendent sur votre site Web. Ces identifiants identifient les utilisateurs de toutes les solutions dans Experience Cloud et ils sont nécessaires si vous souhaitez effectuer des appels DCS.

  • user ID est nécessaire pour identifier et associer des données à un visiteur particulier.
  • region ID est requis car il est lié à un nom de serveur régional, que vous devez envoyer aux DCS. DCS stocke des informations dans des centres de données qui sont géographiquement les plus proches des visiteurs du site. Voir ID de zone géographique, emplacements et noms d’hôte du serveur de collecte de données (DCS Region IDs, Locations, and Host Names).

Les clients du service d’ID peuvent extraire ces informations du cookie du service d’ID ou en appelant une fonction. Le tableau ci-dessous décrit les tâches ou les étapes à réaliser pour commencer.

Le code de italics représente un espace réservé de variable.

Tâche
Description
1. Vérifiez votre état d'Experience Cloud

Vous avez besoin d’un compte Experience Cloud pour utiliser le service d’ID. Si vous disposez d’un compte Experience Cloud, c’est super !

Si vous ne faites pas partie de l’Experience Cloud , inscrivez-vous. Nous aimerions vous avoir et il y a toujours de la place pour plus. Pour plus d’informations sur la configuration d’un compte, voir Activation de vos solutions pour les services principaux.

2. Configuration du service ID
Le service d’ID est constitué de code JavaScript qui est placé sur chaque page que vous souhaitez utiliser pour la collecte de données. Pour plus d’informations, consultez les guides de mise en oeuvre du service d’ID .
3. Lisez le cookie ID service

Le service ID stocke l’identifiant utilisateur et l’identifiant de région dans le cookie AMCV. Le nom complet du cookie est AMCV_###@AdobeOrg. Les éléments ### sont des espaces réservés pour l’ID d’organisation. Voir Cookies et ID Experience Cloudpour plus d’informations.

Analysez le cookie AMCV pour ces paires clé-valeur :

  • mid=user ID : cette paire clé-valeur contient l’identifiant utilisateur Experience Cloud.
  • aamlh=region ID : cette paire clé-valeur contient l’identifiant de région (parfois appelé indicateur d’emplacement ) associé à un nom de serveur régional.

Vous pouvez appeler le DCS une fois que vous disposez des identifiants d’utilisateur et de région.

4. Récupérez l’ ID Experience Cloud avec getMarketingCloudVisitorID

(Facultatif) Cette fonction renvoie l’identifiant visiteur Experience Cloud. Il est conçu pour des solutions personnalisées et des cas d’utilisation spécifiques. Voir Utilisation de getMarketingCloudVisitorID ci-dessous et la documentation du service d’ID associé.

Vous n’avez pas besoin de l’utiliser si vous obtenez les ID d’utilisateur et d’emplacement à partir du cookie du service d’ID.

Utilisation De getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid

La fonction getMarketingCloudVisitorID permet également d’obtenir l’identifiant visiteur. Lorsqu’elle est appelée, cette fonction interroge le ID service et renvoie un ID. getMarketingCloudVisitorID accepte l’argument facultatif callback comme illustré :

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Utilisation et objectif du rappel callback-usage

callback est facultatif. Cette fonction fonctionne sans elle, mais renvoie un ID uniquement lorsqu’un visiteur a un cookie Experience Cloud dans son navigateur. Si le cookie visiteur est manquant ou si un visiteur ne dispose pas d’un ID, la fonction renvoie un objet () vide. Cela peut se produire même après le chargement de la page et la réception par le visiteur d’un nouvel identifiant. Pour éviter cela, callback force cette fonction à rechercher un identifiant visiteur une fois la page chargée. Sans callback, la fonction d’identification du visiteur ne renvoie pas d’identifiant même s’il est écrit ultérieurement dans le navigateur du visiteur.

Étapes suivantes next-steps

Une fois que vous disposez de l’utilisateur et de l’identifiant de région, vous pouvez commencer à envoyer et recevoir des données DCS. Voir Lancement d’appels d’API DCS.

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