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
• Caso d'uso 1: richiesta di impostazione di dati predefiniti
• Caso d'uso 2: richiesta di impostazione di dati personalizzati
• Parametri di risposta definiti

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.