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. Vos requête et réponse pourraient 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 ne voulons que l’Experience Cloud ID (MCID) et l’Analytics ID (MCAID) du visiteur. Vos requête et réponse pourraient 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ée renvoie uniquement les ID indiqué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. Notez que cette méthode renvoie une chaîne vide en l’absence de valeurs pour une variable spécifique.
Valeur
Description
MCAAMB
Métadonnées
Audience Manager
chiffrées connues sous le nom d’objet blob.
MCAAMLH
ID de zone géographique de la collecte de données. Il s’agit d’un identifiant numérique pour l’emplacement géographique d’un centre de données spécifique du service d’ID.
MCAID
Analytics
 ID du visiteur.
MCMID
Experience Cloud ID du visiteur.
MCOPTOUT
Indicateur qui signale si un visiteur a exercé son droit d’opposition à la collecte de données.
Les valeurs incluent :
  • '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.