getVisitorValues getvisitorvalues

Questa API asincrona restituisce per impostazione predefinita identificatori per Analytics, il servizio ID visitatore, la rinuncia alla raccolta di dati, la posizione geografica 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 Visitor ID Service
var visitor = Visitor.getInstance ("INSERT-IMS-ORG-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’ECID (MCID) e l’ID Analytics (MCAID) del visitatore. La richiesta e la risposta potrebbero essere simili ai seguenti esempi.

//Call the Visitor ID Service
var visitor = Visitor.getInstance("INSERT-IMS-ORG-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 visitatore.

Consulta ID regioni DCS, posizioni e nomi host e getLocationHint

MCAID
L'ID Analytics del visitatore.
MCMID

ECID del visitatore.

Consulta cookie e il servizio ID visitatori.

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
id-service-help