Obtention des identifiants et des régions via Adobe Experience Platform Identity Service

Les clients du service d’ID doivent consulter cette section pour savoir comment lire le cookie visiteur pour les ID requis pour effectuer des appels d’API DCS.

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

  • user ID est requis 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 des données à DCS. DCS stocke les 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 à suivre pour commencer.

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

Tâche Description

1. Vérifiez votre Experience Cloud état

Vous avez besoin d’un compte Experience Cloud pour utiliser le service d’ID. Si vous avez 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 savoir comment configurer un compte, voir Activation de vos solutions pour les services principaux .

2. Configuration du service d’ID

Le service d’ID est constitué du code JavaScript qui est placé sur chaque page à utiliser pour la collecte de données. Pour plus d’informations, voir les guides de mise en oeuvre du service d’ID .

3. Lisez le cookie Service d’identification.

Le service d’identification stocke l’ID d’utilisateur et de région dans le cookie AMCV. Le nom du cookie complet est AMCV_###@AdobeOrg. Les éléments ### sont des espaces réservés pour l'ID d'organisation. Pour plus d'informations, consultez la section Cookies et l'ID d'Experience Cloud.

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

  • mid=user ID: Cette paire clé-valeur contient l’ID de l’ utilisateur d’expérience.
  • 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' Experience Cloud ID 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 relative au service d’ID .

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

La fonction getMarketingCloudVisitorID permet également d’obtenir l’ID de visiteur. Lorsqu’elle est appelée, cette fonction requête ID service et renvoie un identifiant. getMarketingCloudVisitorID accepte l' callback argument facultatif comme illustré ci-dessous :

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Utilisation et objectif du rappel

callback est facultatif. Cette fonction fonctionne sans elle, mais renvoie un identifiant uniquement lorsqu’un visiteur a un cookie [!DNL Experience Cloud] dans son navigateur. Si le cookie de visiteur est manquant ou si un visiteur ne possède pas d’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 ID de visiteur après le chargement de la page. 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

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

Sur cette page