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 :

  • *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 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.

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 d’identités Experience Cloud.

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.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a