getVisitorValues 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 section-5aebe3907b2b46e997f45a1d1ed35c09
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 section-36a31683558742a5915db3a391e09f7b
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 section-467b2f4e513344c89b7332b05f6f59f3
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 section-4c4c300167694c6fbff1d6c612f372b5
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.
L'ID della regione di raccolta dati. Questo è un identificatore numerico per la posizione geografica di un particolare datacenter del servizio ID.
Consulta ID regioni DCS, posizioni e nomi host e getLocationHint
L’Experience Cloud ID del visitatore.
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.