DCS API呼叫的支援屬性

列出並說明可傳遞至Data Collection Servers (DCS)的語法和支援的屬性(或機碼值組)。 此資訊可協助您設定DCS請求的格式,並了解此系統傳回的參數。

屬性前置詞

DCS仰賴新增至索引鍵值配對中索引鍵的特定字首,以分類您要傳入的資料類型。

密鑰前置詞 保留

c_

客戶定義的屬性。

d_

Audience Manager屬性。

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的使用。 此參數由AdobeAdobe 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 CloudID。 如需ECID的詳細資訊,請參閱 Cookie與Experience CloudIdentity服務

d_nsid

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

d_ptfm

允許Audience Manager區分行動請求與案頭請求。 支援的值包括:

  • ios
  • android
  • browser
  • all

d_rs

不再提倡。 d_rs 是保留屬性,用於Adobe分析與 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):3
  • 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取得此值時,可識別訪客。

本頁內容