getVisitorValues 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 section-5aebe3907b2b46e997f45a1d1ed35c09

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 :

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 section-36a31683558742a5915db3a391e09f7b

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é section-467b2f4e513344c89b7332b05f6f59f3

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 section-4c4c300167694c6fbff1d6c612f372b5

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.