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.

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) et getLocationHint .

MCAID

Analytics ID du visiteur.

MCMID

Experience Cloud ID du visiteur.

Voir Cookies et service Experience Cloud Identity .

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.

Sur cette page