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 saranno simili a quelle di questi 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 per fini dimostrativi.
//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'Analytics ID (MCAID) del visitatore. La richiesta e la risposta saranno simili a quelle di questi 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 quegli 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, questo metodo restituisce una stringa vuota se non ci sono 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 della posizione geografica di un particolare datacenter del servizio ID.
MCAID
L'ID
Analytics
del visitatore.
MCMID
L'Experience Cloud ID del visitatore.
MCOPTOUT
Un flag che indica se un visitatore ha rinunciato alla raccolta dei 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.