CID取代DPID和DPUUID cid-replaces-dpid-and-dpuuid
更新您的代码以使用d_cid
或d_cid_ic
,而不是d_dpid
和d_dpuuid
。 DPID和DPUUID变量将继续工作,但您应将其视为已弃用。 这包括不带d_ prefix
的DPID和DPUUID变量。
DPID和DPUUID:审核 dpid-dpuuid-review
DPID和DPUUID是包含数据提供程序ID和用户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,而不是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...
开发团队的重要注意事项 dev-considerations
您的开发团队 必须 对CID键值对中的以下变量应用URL编码:
user ID
(dpuuid)
integration code
注意:在将用户ID和集成代码 串联到字符串之前,必须对其进行URL编码。 这是因为URL编码中不能捕获分隔两个变量的ASCII字符%01。
URL编码可确保将包含保留字符或不安全字符(例如但不限于、+或=)的用户ID和集成代码正确传输到我们的服务器。
使用 ASCII编码表作为参考。
您可以将集成代码用于您自己的数据源以及您有权访问的全局共享数据源。 例如,在处理移动标识符数据源时,您可以使用集成代码。 完全按照以下指定方式使用以下集成代码:
- GAID的 DSID_20914,表示运行Android操作系统的设备。
- IDFA的 DSID_20915,表示运行iOS操作系统的设备。