DCS API呼叫的支援屬性

列出並說明您可傳入至Data Collection Servers (DCS)的語法和支援的屬性(或鍵值配對)。 這些資訊可協助您設定DCS要求的格式,並瞭解此系統傳回的參數。

屬性前置詞

DCS依賴於在鍵值對中添加到鍵的特定前置詞來分類要傳入的資料類型。

密鑰前置詞 保留對象

c_

客戶定義的屬性。

d_

觀眾管 理員屬性。

h_

HTTP標題資料。

p_

私人、客戶定義的屬性。

當金鑰具有 p_首碼時,DCS會接受您自己的私人資料。 私人資料用於特徵評估,但不會記錄或儲存在我們的系統中。 例如,假設您有定義為 customers = p_age<25的特徵,而您在事件呼叫中傳入 p_age=23。 基於這些條件,符合年齡資格條件的使用者符合特徵資格,但在 Audience Manager收到請求後,會捨棄金鑰值配對,且不會記錄。

d_ 屬性

所有這些都是可選的,除非您想要DCS的回應。 如果希望DCS返迴響應,則需要d_rtbd=json

屬性 說明

d_caller

用於標識對 DCS API進行呼叫的呼叫者。

d_cb

指定要使用 DCS回應作為回呼函式函式函式參數來執行的JavaScript函式。

d_cid

包含由 Audience Manager指派的一對或多對資料提供者ID( DPID)和資料提供者使用者ID( DPUUID)。 如果您使用多對 DPIDs和 DPUUIDs,請使用非列印字元 %01來分隔每對。 例如: DPID%01DPUUUID.

d_cid 取代 d_dpid d_dpuuid,這些已過時但仍受支援。 請參閱 CID 取代 DPID 及 DPUUID

d_cid_ic

在單一金鑰值配對中包含整合程式碼和相關聯的唯一使用者ID。

d_cid_ic 取代 d_dpid d_dpuuid,這些已過時但仍受支援。 請參閱 CID 取代 DPID 及 DPUUID

d_coppa

停用第三方Cookie的使用,以符合兒童保護法規。 此參數由Adobe Experience Platform Identity Service動態設定,並視 idSyncDisable3rdPartySyncing組態而定。 請參閱Adobe Experience Platform Identity Service中的 COPPA支援。

d_cts=1

d_cts=2

選填。在客戶要求時啟用。 請連絡您的Adobe Audience Manager顧問或客戶服務。

指出應在 JSON回應內傳回特徵和區段。

  • d_cts=1 傳回區段的舊式區段ID

  • d_cts=2 傳回區段的區段ID。

範例回應可能如下所示:

{     "stuff": [],     "uuid": "07955261652886032950143702505894272138",     "dcs_region": 7,     "traits": [420020, 5421506],     "segments": [984263, 985264],     "tid": "ss3OTqPiQp0=" }

d_dpid

不再提倡。請參閱 d_cid d_cid_ic

d_dpuuid

不再提倡。請參閱 d_cid d_cid_ic

d_dst=1

JSON回應中傳回URL目標資料。

d_dst_filter

d_dst_filter 是保留屬性,用於Adobe Analytics與Audience Manager的整合。

我們建議不要建立使用保留屬性的特徵。 Adobe得隨時變更保留屬性。

d_jsonv=1|0

指示要在響應中使用的 JSON版本。 通常,應將此設定為 d_jsonv=1。 設定 d_jsonv=0會停用ID同步。

d_mid

指定 Experience Cloud ID服務所設定及使用的Experience Cloud ID。 如需ECID的詳細資訊,請參閱 Cookie和Experience Cloud Identity Service

d_nsid

命名空間ID。 指出使用的JavaScript容器。 DIL用於ID同步。

d_ptfm

可讓Audience Manager將行動裝置要求與案頭要求區分開來。 支援的值包括:

  • ios
  • android
  • browser
  • all

d_rs

不再提倡。 d_rs 是保留屬性,用於 Adobe Analytics和 Audience Manager之間的舊式整合中。

我們建議不要建立使用保留屬性的特徵。 Adobe得隨時變更保留屬性。

d_rtbd=json

如果您希望 DCS JSON回應,則此為必要項。

  • 如果省略此項, DCS會傳回標題中的像素。
  • 如果包含此項, DCS會在回應內文中傳回 JSON物件。 請參閱以下範例。 您的回應可能會更複雜。

{     "stuff": [],     "uuid": "22920112968019678612904394744954398990",     "dcs_region": 7,     "tid": "ss3OTqPiQp0=" }

d_sid

SID 代表分數ID。 這是特徵或區段的唯一ID。

d_tdpid

傳遞特徵評估的資料來源。 僅評估此資料來源的特徵。

例如,假設您有:

  • 特徵T1 含:
  • 特徵規則:" key1 == val1"
  • 資料來源( DPID):1
  • DPID整合程式碼:ic1
  • 特徵T2 含:
  • 特徵規則:" key2 == val2"
  • 資料來源(DPID):2
  • DPID整合程式碼:ic2

在範例呼叫yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1中,只會傳回特徵T1。

d_tdpid_ic

其用途與上述的 d_tdpid參數相同。 不過,在此情況下,會使用整合程式碼來傳遞資料來源。

保留上述特性,請考慮範例呼叫:

對於yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2,僅傳回特徵T2。

d_uuid

唯一使用者ID。 識別無法從Cookie使用此值的訪客。

本頁內容