Show Menu
主題×

與 Experience Cloud Identity 服務直接整合

如果客戶的裝置無法接受或使用我們的 JavaScript 或 SDK 程式碼,本實作能讓他們在這些裝置上使用該 ID 服務,這些裝置包括遊戲主機、智慧型電視或其他支援網際網路連線的設備。請參閱本節以瞭解語法、程式碼範例和定義。

語法

如果裝置無法使用 VisitorAPI.js 或 SDK 程式碼程式庫,可以直接呼叫由 ID 服務使用的資料收集伺服器 (DCS)。若要這麼做,您可以呼叫
dpm.demdex.net
,並根據下列格式提出要求。
斜體
​表示變數預留位置。
在這個語法範例中,前置詞
d_
會做為系統層級變數,用於識別呼叫中的機碼-值組。您可以將幾個
d_
參數傳遞至 ID 服務,但要把重點放在上述程式碼中的機碼-值組上。如需關於其他變數的詳細資訊,請參閱 DCS API 呼叫支援的屬性
ID 服務支援 HTTP 和 HTTPS 呼叫。使用 HTTPS 以透過安全網頁傳遞資料。

範例要求

您的要求看起來可能類似於下列範例。冗長的變數已縮短。

範例回應

ID 服務會傳回 JSON 物件中的資料,如下所示。您的回應可能會有所不同。
{ "d_mid":"12345", "dcs_region":"6", "id_sync_ttl":"604800", "d_blob":"wxyz5432" }

已定義的要求與回應參數

要求參數
參數
說明
dpm.demdex.net
Adobe
控制的舊版網域。請參閱 瞭解向 Demdex 網域進行的呼叫
d_mid
Experience Cloud 訪客 ID。請參閱 Cookie 與 Experience Cloud Identity 服務
d_orgid
您的 Experience Cloud 組織 ID。如需尋找此 ID 的協助,請參閱 Experience Cloud Identity 服務的需求
d_cid
此選用參數會將資料提供者 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...
dcs_region
ID 服務是一個依地理位置分佈且負載平衡的系統。ID 會識別處理呼叫的資料中心所在的地區。請參閱 DCS 地區 ID、位置與主機名稱
d_cb
(選用)
回呼參數可讓您執行要求內文中的 JavaScript 函數。
d_blob
加密的 JavaScript 中繼資料區塊blob 的大小限制為 512 位元組以下。
d_ver
必填.這會設定 API 版本編號。將此值設定為
d_ver=2
回應參數
某些回應參數屬於要求的一部分,並已在上一節加以定義。
參數
說明
id_sync_ttl
重新同步的時間間隔 (以秒為單位加以指定)。預設時間間隔為 604,800 秒 (7 天)。