如果客戶的裝置無法接受或使用我們的 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 Service。 |
d_orgid |
您的 Experience Cloud 組織 ID。如需尋找此 ID 的相關協助,請參閱 Experience Cloud Identity Service 的需求。 |
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 參數中的選用 ID,以整數方式呈現,而且能根據下列用戶的驗證狀態來識別用戶:
若要指定驗證狀態,可在用戶 ID (UUID) 變數後方設定此標幟。以非列印用的控制字元 %01 將 UUID 和選用的驗證標幟隔開。在下列範例中,驗證 ID 會以粗體文字強調顯示。 語法:...d_cid=DPID%01DPUUID%01authentication state 範例:
|
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 天)。 |