取得訪客資料

最後更新： 2026年5月13日

建立對象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

使用此方法可即時取得訪客身分識別資料。

您必須是Web Personalization客戶，並在您的網站上部署RTP標籤，才能使用使用者內容API。
RTP不支援以帳戶為根據的行銷指定帳戶清單。 ABM清單和程式碼只與在RTP內管理的已上傳帳戶清單（CSV檔案）有關。

如果發生錯誤，回應JSON會包含錯誤訊息。如果API傳回500程式碼，請聯絡支援並提供導致錯誤的要求。

參數

選用/必要

類型

說明

get

必要

字串

方法動作。

visitor

必要

字串

方法名稱。

callback

必要

功能

針對每個傳回的行銷活動觸發的回呼函式。

範例

下列範例會取得訪客身分識別資料。

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

具有區段比對的回應：

下列回應包含matchedSegments，因為訪客在取得訪客資料API呼叫之前符合即時區段。

{
    "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
    }
}

沒有區段比對的回應：

下列回應不包含matchedSegments，因為訪客在取得訪客資料API呼叫之前並未符合任何即時區段。

{
    "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