Show Menu
TOPICS×

getVisitorValues

Questa API asincrona restituisce per impostazione predefinita identificatori per Analytics, il servizio ID, la rinuncia alla raccolta di dati, la geolocalizzazione, e contenuti di metadati BLOB. Inoltre, è possibile controllare gli ID che dovranno essere restituiti con l'enum opzionale visitor.FIELDS.
Sommario:

Sintassi

Questa funzione utilizza la seguente sintassi (il corsivo rappresenta un segnaposto per una variabile):
var *
valori
* = visitor.getVisitorValues (callback, [visitor.FIELDS. *
tipo ID
*, visitor.FIELDS. *
tipo ID
*]);
Nei parametri della funzione:
  • *
    callback
    *
    rappresenta il codice di callback che riceve l'ID restituito.
  • (Facoltativo)
    visitor.FIELDS. *
    Tipo ID
    *
    è un enum che ti permette di specificare quali valori ID vuoi che siano restituiti da questa funzione.
Per maggiori informazioni, vedi i casi d'uso seguenti e le definizioni.

Caso d'uso 1: richiesta di impostazione di dati predefiniti

Questo codice restituisce il set di dati standard. La richiesta e la risposta potrebbero essere simili ai seguenti esempi.
//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);
Nella risposta di esempio predefinita alcuni valori sono stati abbreviati a scopo dimostrativo.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCOPTOUT: 'isoptedout-true', MCAID: 'aid-1234', MCAAMLH: 7, MCAAMB: 'hgfe54236786oygj' }

Caso d'uso 2: richiesta di impostazione di dati personalizzati

Questo codice utilizza un array facoltativo per restituire un set specifico di ID usando
visitor.FIELDS
l'enum. In questo caso vogliamo solo l’Experience Cloud ID (MCID) e l’ID Analytics (MCAID) del visitatore. La richiesta e la risposta potrebbero essere simili ai seguenti esempi.
//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]);
La risposta di esempio personalizzata restituisce solo gli ID specificati nella richiesta.
//Formatted IDs in JSON response { MCMID: 'mid-1234', MCAID: 'aid-4321' }

Parametri di risposta definiti

Nella seguente tabella sono elencati e definiti i parametri di risposta. Questi sono anche tutti i valori
visitor.FIELDS
nell'enum. Nota che questo metodo restituisce una stringa vuota se non sono presenti valori per una particolare variabile.
Valore
Descrizione
MCAAMB
Metadati
Audience Manager
crittografati noti come BLOB.
MCAAMLH
L'ID della regione di raccolta dati. Questo è un identificatore numerico per la posizione geografica di un particolare datacenter del servizio ID.
MCAID
L'ID
Analytics
del visitatore.
MCMID
L’Experience Cloud ID del visitatore.
MCOPTOUT
Flag che indica se un visitatore ha rinunciato alla raccolta dati.
I valori includono:
  • 'isoptedout-true'
    : un visitatore ha rinunciato alla raccolta dei dati.
  • 'isoptedout-false'
    : un visitatore non ha rinunciato alla raccolta dei dati.