CID 取代 DPID 和 DPUUID cid-replaces-dpid-and-dpuuid
更新您的程式碼以使用 d_cid
或 d_cid_ic
而非 d_dpid
和 d_dpuuid
. DPID和DPUUID變數仍會繼續運作,但您應將其視為已棄用。 這包含不具下列專案的DPID和DPUUID變體: d_ prefix
.
DPID和DPUUID:評論 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:關於 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的備用ID,指派者為 Audience Manager. 另請參閱 建立資料來源 如果您需要設定整合程式碼。
另請參閱 宣告ID的URL變數和語法.
- DSID_20914 對於GAID,代表執行Android作業系統的裝置。
- DSID_20915 對於IDFA,代表執行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...
開發團隊的重要考量 dev-considerations
您的開發團隊 必須 將URL編碼套用至CID機碼值組中的下列變數:
user ID
(dpuuid)
integration code
注意:您必須URL編碼使用者ID和整合代碼 早於 將它們串聯為字串。 這是因為URL編碼中不能擷取分隔兩個變數的ASCII字元%01。
URL編碼可確保包含保留或不安全字元(例如但不限於、+或=)的使用者ID和整合程式碼,正確傳輸至我們的伺服器。
使用 ASCII編碼表格 以供參考。
您可以將整合程式碼用於您自己的資料來源和全域 共用資料來源,您可存取此專案。 例如,使用行動識別碼資料來源時,可以使用整合代碼。 請使用下列整合程式碼,與以下指定完全一致:
- DSID_20914 對於GAID,代表執行Android作業系統的裝置。
- DSID_20915 對於IDFA,代表執行iOS作業系統的裝置。