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:
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. 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.
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'
}
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'
}
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. Consulta ID regioni DCS, posizioni e nomi host e getLocationHint |
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:
|