Obtention des identifiants et des régions 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 visiteur pour les ID requis pour effectuer des appels d’API DCS.
Obtention de l’ID utilisateur à partir du cookie du service d’ID get-user-ids-from-service-cookie
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 les 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.
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.
Le service d’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 Cloud pour plus d’informations.
Analysez le cookie AMCV pour ces paires clé-valeur :
mid=user ID: Cette paire clé-valeur contient l’identifiant 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.
(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ée.
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
Une autre méthode pour obtenir l’identifiant visiteur consiste à utiliser la fonction getMarketingCloudVisitorID. Lorsqu’elle est appelée, cette fonction interroge la balise ID service et renvoie un ID. getMarketingCloudVisitorID accepte l’ callback argument 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 ID uniquement lorsqu’un visiteur a un cookie Experience Cloud dans son navigateur. Si le cookie du visiteur est manquant ou si un visiteur n’a pas d’identifiant, 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’identifiant de région et de l’utilisateur, vous pouvez commencer à envoyer et recevoir des données DCS. Voir Lancement d’appels d’API DCS.