DCS API呼叫的支援屬性 supported-attributes-for-dcs-api-calls

列出並描述您可以傳遞至Data Collection Servers (DCS)的語法和支援的屬性(或機碼值組)。 此資訊可協助您格式化DCS要求,並瞭解此系統傳回的引數。

屬性首碼 attribute-prefixes

DCS依賴新增到索引鍵值配對中的索引鍵的特定首碼,以分類您傳入的資料型別。

金鑰首碼
保留給
c_
客戶定義的屬性。
d_
Audience Manager屬性。
h_
HTTP標頭資料。
p_

私人、客戶定義的屬性。

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

d_屬性 d-attributes

除非您想要來自DCS的回應,否則所有這些都是選擇性的。 若您希望DCS傳回回應,則需要d_rtbd=json

屬性
說明
d_caller
用於識別呼叫 DCS API的呼叫者。
d_cb
指定要使用 DCS回應作為回呼函式的函式引數執行的JavaScript函式。
d_cid

包含由Audience Manager指派的一或多組資料提供者ID ( DPID)和資料提供者ID ( DPUUID)。 如果您使用多對 DPID DPUUID,請以非列印字元 %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的使用以遵守兒童保護法規。 此引數由AdobeAdobe Experience Platform Identity Service動態設定,且取決於 idSyncDisable3rdPartySyncing設定。 請參閱Adobe Experience Platform Identity服務中的 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 CloudID。 如需有關ECID的詳細資訊,請參閱 Cookie與Experience Cloud識別服務
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。
d_tdpid

傳遞資料來源以進行特徵評估。 只會評估來自此資料來源的特徵。

例如,假設您有:

  • 特徵T1 包含:
  • 特徵規則: " key1 == val1"
  • 資料Source ( DPID): 1
  • DPID整合代碼:ic1
  • 特徵T2 包含:
  • 特徵規則: " key2 == val2"
  • 資料Source (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
不重複使用者識別碼。 無法從Cookie取得此值時識別訪客。

h_屬性

這些標頭包含HTTP呼叫中資料請求和回應之類的資訊。

屬性
說明
h_host
這會設定為使用者端的特定資料收集主機名稱。 它顯示為host name .demdex.net。 請參閱瞭解向 Demdex 網域進行的呼叫
h_user-agent
設定為User-Agent標頭值。
h_accept-language
設定為Accept-Language標頭值。
h_referer
設定為Referer標頭值。
h_referrer
設定為Referrer標頭值。
h_date
設定為Date標頭值。
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695