DokumentationMarketo-Entwicklerhandbuch

Besucherdaten abrufen

Last update: Mon Sep 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin

Diese Methode wird verwendet, um Echtzeit-Besucheridentifizierungsdaten abzurufen.

  • Sie müssen Web Personalization-Kunde werden und das RTP-TagIhrer 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, wird als Teil der Antwort-JSON eine Fehlermeldung angezeigt. Wenn ein 500-Code zurückgegeben wird, wenden Sie sich mit der von Ihnen gestellten Anfrage an den Support.

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

Abrufen von Besucheridentifizierungsdaten:

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

Antwort mit Segment Match:

Nachfolgend finden Sie eine Beispielantwort, die zurückgegeben wird, falls der Besucher vor dem API-Aufruf 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:

Nachfolgend finden Sie eine Beispielantwort, die zurückgegeben wird, falls der Besucher vor dem Aufruf der API zum Abrufen von Besucherdaten mit keinem Echtzeit-Segment ü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
bb269a6d-047a-4bf7-9acd-23ad9a63dc59