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调用期间发送数据。 如果没有这些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编码

您的开发团队 必须 对CID键值对中的以下变量应用URL编码:

  • 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