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_cid 和使 d_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。 如果需要配置集成代码,请参阅创建数据源

另请参阅已声明ID的URL变量和语法

注意

您可以将集成代码用于您自己的数据源和全局共享数据源,您有权访问这些数据源。 例如,在使用移动标识符数据源时,您可以使用集成代码。 完全按照以下指定方式使用以下集成代码:

  • 用于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和集成代码进行URL编码,然后再将用户ID和集成代码连接到字符串中。 这是因为在URL编码中不能捕获用于分隔两个变量的ASCII字符%01。

URL编码可确保将包含保留或不安全字符(例如,但不限于,+或=)的用户ID和集成代码正确传输到我们的服务器。

使用 ASCII编码表作为参考。

将集成代码用于全局共享数据源

您可以将集成代码用于您自己的数据源和全局共享数据源,您有权访问这些数据源。 例如,在使用移动标识符数据源时,您可以使用集成代码。 完全按照以下指定方式使用以下集成代码:

  • 用于GAID的DSID_20914 ,表示运行Android操作系统的设备。
  • 用于IDFA的DSID_20915 ,表示运行iOS操作系统的设备。

在此页面上