Show Menu
TOPICS×

getVisitorValues

Il s’agit d’une API asynchrone qui renvoie les identifiants pour Analytics, le service d’ID, le droit d’opposition à la collecte de données, l’emplacement géographique et le contenu d’objet blob de métadonnées par défaut. Vous pouvez également contrôler les ID que vous souhaitez renvoyer à l’aide de l’énumération facultative visitor.FIELDS.
Contenu :

Syntaxe

Cette fonction utilise la syntaxe suivante (le format italique représente un espace réservé pour une variable) :
var *
valeurs
* = visitor.getVisitorValues (callback, [visitor.FIELDS. *
type d’ID
*, visitor.FIELDS. *
type d’ID
*]);
Dans les paramètres de la fonction :
  • *
    callback
    *
    représente votre propre code de rappel qui reçoit les ID renvoyés.
  • (Facultatif)
    visitor.FIELDS. *
    type d’ID
    *
    est une énumération permettant d’indiquer les valeurs d’ID que vous souhaitez que cette fonction renvoie.
Pour plus d’informations, voir les cas d’utilisation et définitions suivants.

Cas d’utilisation 1 : demander le jeu de données par défaut

Ce code renvoie le jeu de données standard. Votre demande et votre réponse peuvent ressembler aux exemples suivants.
//Call the ID service var visitor = Visitor.getInstance ("Insert Experience Cloud organization ID here",{...}); //Add your callback to the GET method to return IDs and data. visitor.getVisitorValues(visitorIdsCallback);
Dans l’exemple de réponse par défaut, certaines valeurs ont été raccourcies à des fins de démonstration.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCOPTOUT: 'isoptedout-true', MCAID: 'aid-1234', MCAAMLH: 7, MCAAMB: 'hgfe54236786oygj' }

Cas d’utilisation 2 : demander le jeu de données personnalisé

Ce code utilise un tableau facultatif pour renvoyer un jeu d’ID spécifique à l’aide de
visitor.FIELDS
l’énumération. Dans ce cas, nous voulons uniquement l’Experience Cloud ID (MCID) et l’Analytics ID (MCAID) du visiteur. Votre demande et votre réponse peuvent ressembler aux exemples suivants.
//Call the ID service var visitor = Visitor.getInstance("Insert Experience Cloud organization ID here", { ... }); // Add an optional array to specify which IDs you want to return. visitor.getVisitorValues(visitorIdsCallback, [visitor.FIELDS.MCMID, visitor.FIELDS.MCAID]);
L’exemple de réponse personnalisé renvoie uniquement les ID spécifiés dans la requête.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCAID: 'aid-4321' }

Paramètres de réponse définis

Le tableau suivant répertorie et définit les paramètres de réponse. Il s’agit également de toutes les valeurs de
visitor.FIELDS
l’énumération. Remarque : cette méthode renvoie une chaîne vide si aucune valeur n’est définie pour une variable particulière.
Valeur
Description
MCAAMB
Métadonnées
Audience Manager
chiffrées connues sous le nom d’objet blob.
MCAAMLH
ID de la région de collecte de données. Il s’agit d’un identifiant numérique pour l’emplacement géographique d’un centre de données de service d’ID en particulier.
MCAID
Analytics
 ID du visiteur.
MCMID
Experience Cloud ID du visiteur.
MCOPTOUT
Indicateur qui indique si un visiteur a exercé son droit d’opposition à la collecte de données.
Les valeurs sont les suivantes :
  • 'isoptedout-true'
     : un visiteur a exercé son droit d’opposition à la collecte de données.
  • 'isoptedout-true'
     : un visiteur n’a pas exercé son droit d’opposition à la collecte de données.