CID取代DPID及DPUUID cid-replaces-dpid-and-dpuuid

更新您的程式碼以使用d_cidd_cid_ic,而非d_dpidd_dpuuid。 DPID和DPUUID變數可繼續運作,但您應將其視為已棄用。 這包含不含d_ prefix的DPID和DPUUID變體。

DPID和DPUUID:評論 dpid-dpuuid-review

DPID和DPUUID是機碼值組,包含資料提供者ID和使用者ID。 這些機碼值組會將提供者ID連結至使用者ID。 它們會在事件呼叫、傳入同步事件及ID呼叫期間傳送資料。 如果沒有這些識別碼,Audience Manager和其他服務或功能將無法比對及同步ID。 這些變數有時會有或不有d_首碼表示,如下所示。 請注意,在程式碼中,斜體 ​表示變數預留位置。

變數
語法
資料提供者ID (DPID)
  • d_dpid=data provider ID
  • dpid=data provider ID
資料提供者唯一使用者ID (DPUUID)
  • d_dpuuid=data provider unique user ID
  • dpuuid=data provider unique user ID

這些機碼值組仍然有效,但已過時。 您應該更新程式碼以改用CID或CID_IC。

CID和CID_IC:關於 cid-cidic-about

CID和CID_IC索引鍵值配對會取代DPID和DPUUID。 它們提供與DPID和DPUUID相同的函式,但效率較高,因為它們將資料提供者ID (或整合代碼)和使用者ID包含在單一索引鍵/值組中。 在每個機碼值組中:

  • =符號會將金鑰與其相關值分開。
  • 非列印ASCII字元%01會分隔值。

d_cidd_cid_ic使用下列語法。 請注意,在程式碼中,斜體 ​表示變數預留位置。

變數
語法
客戶ID (CID)
d_cid=data provider ID%01user ID
客戶ID整合代碼(CID_IC)

d_cid_ic=integration code%01user ID

整合代碼是可使用的備用ID,而非Audience Manager指派的資料Source ID。 如需設定整合代碼,請參閱建立資料Source

另請參閱宣告ID的URL變數和語法

NOTE
您可以將整合代碼用於您自己的資料來源以及您有權存取的全域共用資料來源。 例如,您可以在使用行動識別碼資料來源時使用整合代碼。 請使用下列整合程式碼,如下所指定:
  • GAID的​ DSID_20914,代表執行Android作業系統的裝置。
  • IDFA的​ DSID_20915,代表執行iOS作業系統的裝置。

範例

下表提供依事件型別的範例。

事件類型
範例
事件
  • 新增: .../event?d_cid=123%01987...
  • 已棄用: .../event?d_dpid=123&d_dpuuid=987...
傳入同步處理(IBS)
  • 新增: .../ibs:d_cid=123%01987...
  • 已棄用: .../ibs:d_dpid=123&d_dpuuid=987
產生Audience ManagerUUID (ID)
  • 新增: .../id?d_cid=123%01987...
  • 已棄用: .../id?d_dpid=123&d_dpuuid=987

每個呼叫也可以包含多個d_cidd_cid_ic機碼值組,如下所示:

...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...

開發團隊的重要考量 dev-considerations

項目
說明
URL編碼

您的開發團隊 必須 將URL編碼套用至CID機碼值組中的下列變數:

  • user ID (dpuuid)
  • integration code

注意:您必須先對使用者ID和整合代碼 進行URL編碼,然後再將 串連到字串中。 這是因為URL編碼中不能擷取分隔兩個變數的ASCII字元%01。

URL編碼可確保包含保留或不安全字元(例如但不限於、+或=)的使用者ID和整合程式碼正確傳輸至我們的伺服器。

使用 ASCII編碼資料表作為參考。

使用全域共用資料來源的整合程式碼

您可以將整合代碼用於您自己的資料來源以及您有權存取的全域共用資料來源。 例如,您可以在使用行動識別碼資料來源時使用整合代碼。 請使用下列整合程式碼,如下所指定:

  • GAID的 DSID_20914,代表執行Android作業系統的裝置。
  • IDFA的 DSID_20915,代表執行iOS作業系統的裝置。
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695