Besucherdaten abrufen

Verwenden Sie diese Methode, um Besucheridentifikationsdaten in Echtzeit zu erhalten.

  • Sie müssen Web Personalization-Kunde sein und das RTP-Tag auf Ihrer Site bereitstellen lassen, bevor Sie die User Context-API verwenden.
  • RTP unterstützt keine Listen mit Account-basierten Marketing-Konten. ABM-Listen und Code beziehen sich nur auf die hochgeladenen Kontolisten (CSV-Dateien), die in RTP verwaltet werden.

Wenn ein Fehler auftritt, enthält die JSON-Antwort eine Fehlermeldung. Wenn die API einen 500-Code zurückgibt, wenden Sie sich an den Support und geben Sie die Anfrage an, die den Fehler verursacht hat.

Parameter
Optional/Erforderlich
Typ
Beschreibung
get
Erforderlich
String
Aktion der Methode.
visitor
Erforderlich
String
Methodenname.
callback
Erforderlich
Funktion
Callback-Funktion, die für jede zurückgegebene Kampagne ausgelöst werden soll.

Beispiele

Im folgenden Beispiel werden Daten zur Besucheridentifizierung abgerufen.

function callbackFunction() {
    console.log('RTP is awesome!');
}
rtp('get', 'visitor', callbackFunction);

Antwort mit Segment Match:

Die folgende Antwort enthält matchedSegments, da der Besucher vor dem Aufruf der API zum Abrufen von Besucherdaten mit Echtzeit-Segmenten abgeglichen hat.

{
    "status": 200,
    "results": {
        "matchedSegments": [
            {
                "name": "first click",
                "id": 177
            }
        ],
        "abm": [
            {
                "code": 4,
                "name": "abm_saleforce_customers"
            },
            {
                "code": 5,
                "name": "abm_top_customers"
            }
        ],
        "org": "Marketo",
        "location": {
            "country": "United States",
            "city": "San Mateo",
            "state": "CA"
        },
        "industries": [
            "Software & Internet"
        ],
        "isp": false
    }
}

Antwort ohne Segment Match:

Die folgende Antwort enthält keine matchedSegments, da der Besucher vor dem Aufruf der API zum Abrufen der Besucherdaten mit keinen Echtzeit-Segmenten übereinstimmte.

{
    "status": 200,
    "results": {
        "abm": [
            {
                "code": 4,
                "name": "abm_saleforce_customers"
            },
            {
                "code": 5,
                "name": "abm_top_customers"
            }
        ],
        "org": "Marketo",
        "location": {
            "country": "United States",
            "city": "San Mateo",
            "state": "CA"
        },
        "industries": [
            "Software & Internet"
        ],
        "isp": false
    }
}
recommendation-more-help
marketo-developer-help