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

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

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的備用ID,指派者為 Audience Manager. 另請參閱 建立資料來源 如果您需要設定整合程式碼。

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

NOTE
您可以將整合程式碼用於您自己的資料來源和全域 共用資料來源,您可存取此專案。 例如,使用行動識別碼資料來源時,可以使用整合代碼。 請使用下列整合程式碼,與以下指定完全一致:
  • DSID_20914 對於GAID,代表執行Android作業系統的裝置。
  • DSID_20915 對於IDFA,代表執行iOS作業系統的裝置。

示例

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

事件类型
示例
Event
  • 新增了: .../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

注意:您必須URL編碼使用者ID和整合代碼 早於 將它們串聯為字串。 這是因為URL編碼中不能擷取分隔兩個變數的ASCII字元%01。

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

使用 ASCII編碼表格 以供參考。

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

您可以將整合程式碼用於您自己的資料來源和全域 共用資料來源,您可存取此專案。 例如,使用行動識別碼資料來源時,可以使用整合代碼。 請使用下列整合程式碼,與以下指定完全一致:

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