CID取代DPID及DPUUID :headding-anchor:cid-replaces-dpid-and-dpuuid
更新您的程式碼以使用d_cid
或d_cid_ic
,而非d_dpid
和d_dpuuid
。 DPID和DPUUID變數可繼續運作,但您應將其視為已棄用。 這包含不含d_ prefix
的DPID和DPUUID變體。
DPID和DPUUID:評論 :headding-anchor:dpid-dpuuid-review
DPID和DPUUID是機碼值組,包含資料提供者ID和使用者ID。 這些機碼值組會將提供者ID連結至使用者ID。 它們會在事件呼叫、傳入同步事件及ID呼叫期間傳送資料。 如果沒有這些識別碼,Audience Manager和其他服務或功能將無法比對及同步ID。 這些變數有時會有或不有d_
首碼表示,如下所示。 請注意,在程式碼中,斜體 表示變數預留位置。
d_dpid=data provider ID
dpid=data provider ID
d_dpuuid=data provider unique user ID
dpuuid=data provider unique user ID
這些機碼值組仍然有效,但已過時。 您應該更新程式碼以改用CID或CID_IC。
CID和CID_IC:關於 :headding-anchor:cid-cidic-about
CID和CID_IC索引鍵值配對會取代DPID和DPUUID。 它們提供與DPID和DPUUID相同的函式,但效率較高,因為它們將資料提供者ID (或整合代碼)和使用者ID包含在單一索引鍵/值組中。 在每個機碼值組中:
- =符號會將金鑰與其相關值分開。
- 非列印ASCII字元%01會分隔值。
d_cid
和d_cid_ic
使用下列語法。 請注意,在程式碼中,斜體 表示變數預留位置。
d_cid=data provider ID%01user ID
d_cid_ic=integration code%01user ID
整合代碼是可使用的備用ID,而非Audience Manager指派的資料Source ID。 如需設定整合代碼,請參閱建立資料Source。
另請參閱宣告ID的URL變數和語法。
- GAID的 DSID_20914,代表執行Android作業系統的裝置。
- IDFA的 DSID_20915,代表執行iOS作業系統的裝置。
範例
下表提供依事件型別的範例。
- 新增:
.../event?d_cid=123%01987...
- 已棄用:
.../event?d_dpid=123&d_dpuuid=987...
- 新增:
.../ibs:d_cid=123%01987...
- 已棄用:
.../ibs:d_dpid=123&d_dpuuid=987
- 新增:
.../id?d_cid=123%01987...
- 已棄用:
.../id?d_dpid=123&d_dpuuid=987
每個呼叫也可以包含多個d_cid
和d_cid_ic
機碼值組,如下所示:
...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...
開發團隊的重要考量 :headding-anchor:dev-considerations
您的開發團隊 必須 將URL編碼套用至CID機碼值組中的下列變數:
user ID
(dpuuid)
integration code
注意:您必須先對使用者ID和整合代碼 進行URL編碼,然後再將 串連到字串中。 這是因為URL編碼中不能擷取分隔兩個變數的ASCII字元%01。
URL編碼可確保包含保留或不安全字元(例如但不限於、+或=)的使用者ID和整合程式碼正確傳輸至我們的伺服器。
使用 ASCII編碼資料表作為參考。
您可以將整合代碼用於您自己的資料來源以及您有權存取的全域共用資料來源。 例如,您可以在使用行動識別碼資料來源時使用整合代碼。 請使用下列整合程式碼,如下所指定:
- GAID的 DSID_20914,代表執行Android作業系統的裝置。
- IDFA的 DSID_20915,代表執行iOS作業系統的裝置。