Obtention des identifiants de région et d’utilisateur via Adobe Experience Platform Identity Service 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 du visiteur pour les identifiants requis pour effectuer des appels API DCS.
Obtention de l’ID utilisateur à partir du cookie du service d’ID get-user-ids-from-service-cookie
Le Adobe Experience Platform Identity Service attribue des ID de visiteur et de région aux utilisateurs qui visitent votre site web. Ces identifiants identifient les utilisateurs et utilisatrices de toutes les solutions du Experience Cloud. Ils sont nécessaires si vous souhaitez effectuer des appels DCS.
- L’user ID est nécessaire pour identifier et associer des données à un visiteur particulier.
- Le region ID est obligatoire, car il est lié à un nom de serveur régional, auquel vous devez envoyer des données au DCS. Le DCS stocke les informations dans les centres de données 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 à partir du cookie du service d’ID ou en appelant une fonction . Le tableau ci-dessous décrit les tâches ou étapes à suivre pour commencer.
Le code en italique représente un espace réservé de variable.
Vous avez besoin d’un compte Experience Cloud pour utiliser le service d’ID. Si vous disposez d’un compte Experience Cloud, tant mieux !
Si vous ne faites pas partie de l’ Experience Cloud inscrivez-vous. Nous serions ravis de vous accueillir et il y a toujours de la place pour plus. Pour obtenir des instructions sur la configuration d’un compte, voir Activation de vos solutions pour les services principaux.
Le service ID stocke ’identifiant de l’utilisateur et de la région dans le cookie AMCV. Le nom complet du cookie est AMCV_###@AdobeOrg. Les éléments ### sont des espaces réservés pour votre ID d’organisation. Voir Cookies et Experience Cloud ID pour 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é conseil d’emplacement ) associé à un nom de serveur régional.
Vous pouvez effectuer des appels vers le DCS une fois que vous disposez des identifiants d’utilisateur et de région.
(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 identifiants 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 la ID service et renvoie un identifiant. getMarketingCloudVisitorID accepte l’argument de callback facultatif comme illustré ci-dessous :
var analyticsID = visitor.getAnalyticsVisitorID(callback)
Utilisation et objectif du rappel callback-usage
callback est facultatif. Cette fonction fonctionne sans elle, mais renvoie un identifiant uniquement lorsqu’un visiteur dispose d’un cookie Experience Cloud dans son navigateur. Si le cookie du visiteur est manquant ou si un visiteur ne dispose pas d’un identifiant, la fonction renvoie un objet () vide. Cela peut se produire même après le chargement de la page et la réception d’un nouvel identifiant par le visiteur. Pour éviter cela, callback force cette fonction à rechercher un identifiant visiteur après le chargement de la page. Sans callback, la fonction d’identifiant visiteur ne renvoie pas d’identifiant, même s’il est écrit dans le navigateur du visiteur ultérieurement.
Étapes suivantes next-steps
Une fois que vous disposez de l’identifiant d’utilisateur et de région, vous pouvez commencer à envoyer et à recevoir des données DCS. Voir Effectuer des appels API DCS.