Obtention des identifiants et des régions via Adobe Experience Platform Identity 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.

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.

Tâche Description

1. Vérifiez votre Experience Cloud statut

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 d’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 du service d’ID

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.

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é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

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 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

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.

Sur cette page