與Adobe訪客ID服務直接整合 direct-integration-with-the-experience-cloud-id-service
如果客戶的裝置無法接受或使用我們的JavaScript或SDK程式碼,本實作能讓他們在這些裝置上使用訪客ID服務, 這類裝置包括遊戲主機、智慧型電視,或其他可上網的設備等等。 請參閱本節,以取得語法、程式碼範例和定義。
語法 section-a4754afec5ad40b6be00d6f1011d68bb
無法使用VisitorAPI.js或SDK程式碼庫的裝置可以直接呼叫訪客ID服務使用的資料收集伺服器(DCS)。 若要這麼做,您可以呼叫 dpm.demdex.net,並根據下列格式提出要求。 斜體表示變數預留位置。
在這個語法範例中,前置詞 d_ 會做為系統層級變數,用於識別呼叫中的機碼-值組。 您可以將許多d_引數傳遞至訪客ID服務,但要把重點放在上述程式碼中的機碼 — 值組上。 如需其他變數的詳細資訊,請參閱支援的 DCS API 呼叫屬性。
訪客ID服務支援HTTP和HTTPS呼叫。 使用 HTTPS 從安全頁面傳送資料。
範例要求 section-26302b8851704888b6f8e6b2071bcdb0
您的請求可能會如下列範例所示。 長變數已縮短。
範例回應 section-89bc103b3e9e4a8b98e74c32897b1200
訪客ID服務會傳回JSON物件中的資料,如下所示。 您的回應可能不同。
{
"d_mid":"12345",
"dcs_region":"6",
"id_sync_ttl":"604800",
"d_blob":"wxyz5432"
}
已定義的要求與回應引數 section-4a9912b545364dc4acad4f1ea5ec641d
請求參數
您的IMS組織ID。 如需尋找此ID的相關協助,請參閱訪客ID服務的需求。
此選用引數會將資料提供者ID (DPID)、唯一使用者ID (DPUUID)及驗證狀態ID傳給訪客ID服務。 如程式碼範例所示,以非列印用的控制字元 %01 將 DPID 和 DPUUID 隔開。
DPID 與 DPUUID
在 d_cid 參數中,將每個相關的 DPID 和 DPUUID 組合指派至相同的 d_cid 參數。 如此,能讓您在單一要求中傳回多個 ID 集合。 另外,以非列印用的控制字元 %01 將 DPID、DPUUID 和選用的驗證標幟隔開。 在下列範例中,提供者和用戶的 ID 都會以 粗體 文字強調顯示。
- 語法:...d_cid=DPID%01DPUUID%01authentication state...
- 範例:...d_cid=123%01456%011...
驗證狀態
這是 d_cid 參數中的選用 ID, 以整數方式呈現,而且能根據下列用戶的驗證狀態來識別用戶:
- 0 (未知)
- 1 (驗證)
- 2 (登出)
若要指定驗證狀態,可在用戶 ID (UUID) 變數後方設定此標幟。 以非列印用的控制字元 %01 將 UUID 和選用的驗證標幟隔開。 在下列範例中,驗證 ID 會以 粗體 文字強調顯示。
語法:...d_cid=DPID%01DPUUID%01authentication state
範例:
- 未知:...d_cid=123%01456%010...
- 驗證:...d_cid=123%01456%011...
- 登出:...d_cid=123%01456%012...
回應參數
部分回應參數是請求的一部分,已定義於上一節中。