CID 取代 DPID 及 DPUUID

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

DPID和DPUUID:評論

DPID和DPUUID是機碼值組,包含資料提供者ID和使用者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和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指派的資料來源ID。 如果您需要設定整合代碼,請參閱建立資料來源

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

注意

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

  • 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...

開發團隊的重要考量

項目

說明

URL編碼

您的開發團隊必須將URL編碼套用至CID索引鍵值配對中的下列變數:

  • user ID (dpuuid)
  • integration code

注意:您必須在將使用者ID和整合程式碼串連至字串之前,將使用者ID和整合程式碼編碼為URL。 這是因為分隔兩個變數的ASCII字元%01在URL編碼中不能被捕獲。

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

使用 ASCII編碼表作為參考。

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

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

  • GAID的DSID_20914 ,代表執行Android作業系統的裝置。
  • IDFA的DSID_20915 ,代表執行iOS作業系統的裝置。

本頁內容