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.

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.

Consulta I cookie e il servizio Experience Cloud Identity.

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.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a