getVisitorValues getvisitorvalues

Hierbei handelt es sich um eine asynchrone API, die standardmäßig Kennungen für Analytics, den Besucher-ID-Service, das Opt-out von der Datenerfassung, den geografischen Standort und „Blob“-Inhalte von Metadaten zurückgibt. Sie können auch mit dem optionalen Aufzählungswert visitor.FIELDS steuern, welche IDs zurückgegeben werden.

Inhalt:

Syntax section-5aebe3907b2b46e997f45a1d1ed35c09

Diese Funktion verwendet die folgende Syntax (kursiv stellt einen Platzhalter für eine Variable dar): var *values* = visitor.getVisitorValues (callback, [visitor.FIELDS. *ID type*, visitor.FIELDS. *ID type*]);

In den Funktionsparametern:

Weitere Informationen finden Sie in den folgenden Nutzungsszenarios und Definitionen.

Nutzungsszenario 1: Standarddatensatz anfordern section-36a31683558742a5915db3a391e09f7b

Dieser Code gibt den Standarddatensatz zurück. Ihre Anforderung und Ihre Antwort könnten den folgenden Beispielen ähneln.

//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);

Im Beispiel für die standardmäßige Antwort wurden einige Werte zu Demonstrationszwecken gekürzt.

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCOPTOUT: 'isoptedout-true',
    MCAID: 'aid-1234',
    MCAAMLH: 7,
    MCAAMB: 'hgfe54236786oygj'
}

Nutzungsszenario 2: Benutzerdefinierten Datensatz anfordern section-467b2f4e513344c89b7332b05f6f59f3

In diesem Code wird ein optionales Array verwendet, um einen spezifischen Satz von IDs mit der visitor.FIELDS-Aufzählung zurückzugeben. In diesem Fall benötigen wir nur die ECID (MCID) und Analytics ID (MCAID) des Besuchers. Ihre Anforderung und Ihre Antwort könnten den folgenden Beispielen ähneln.

//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]);

Die benutzerdefinierte Antwort im Beispiel gibt nur die in der Anforderung angegebenen IDs zurück.

//Formatted IDs in JSON response
{
    MCMID: 'mid-1234',
    MCAID: 'aid-4321'
}

Definierte Antwortparameter section-4c4c300167694c6fbff1d6c612f372b5

In der folgenden Tabelle sind die Antwortparameter aufgeführt und definiert. Dies sind auch alle Werte in der visitor.FIELDS-Aufzählung. Beachten Sie, dass diese Methode eine leere Zeichenfolge zurückgibt, wenn es für eine bestimmte Variable keine Werte gibt.