DCS API调用支持的属性

列出并描述可传入Data Collection Servers (DCS)的语法和支持的属性(或键值对)。 此信息可帮助您设置DCS请求的格式,并了解此系统返回的参数。

属性前缀

DCS依赖于键值对中添加到键的特定前缀,来对您传入的数据类型进行分类。

键前缀 保留对象

c_

客户定义的属性。

d_

Audience Manager 属性。

h_

HTTP标头数据。

p_

由客户定义的专用属性。

当键具有 p_前缀时,DCS将接受您自己的专用数据。 专用数据用于特征评估,但不会将其记录或存储在我们的系统中。 例如,假设您的特征定义为 customers = p_age<25,并且在事件调用中传递了 p_age=23。 在这些情况下,符合基于年龄的资格条件的用户符合特征的条件,但键值对在Audience Manager收到请求后被丢弃,且未记录。

d_ 属性

除非您希望收到DCS的响应,否则所有这些都是可选的。 如果希望DCS返回响应,则需要d_rtbd=json

属性 描述

d_caller

用于标识对 DCS API进行调用的调用者。

d_cb

指定要使用 DCS响应作为回调函数的函数参数执行的JavaScript函数。

d_cid

包含由Audience Manager分配的一对或多对数据提供程序ID( DPID)和数据提供程序用户ID( DPUUID)。 如果使用多对 DPIDs和 DPUUIDs,请使用非打印字符 %01将每对分隔开。 例如:DPID%01DPUUUID

d_cid 替换 d_dpid d_dpuuid,虽然已弃用但仍受支持。 请参阅 CID 取代 DPID 和 DPUUID

d_cid_ic

在单个键值对中包含集成代码和关联的唯一用户ID。

d_cid_ic 替换 d_dpid d_dpuuid,虽然已弃用但仍受支持。 请参阅 CID 取代 DPID 和 DPUUID

d_coppa

为遵守儿童保护法规,禁止使用第三方Cookie。 此参数由AdobeAdobe Experience Platform Identity Service动态设置,并取决于 idSyncDisable3rdPartySyncing配置。 请参阅Adobe Experience Platform Identity服务中的 COPPA支持。

d_cts=1

d_cts=2

可选。在客户请求时启用。 请联系您的Adobe Audience Manager顾问或客户关怀团队。

指示应在 JSON响应中返回特征和区段。

  • d_cts=1 返回区段的旧版区段ID

  • d_cts=2 返回区段的区段ID。

示例响应可能如下所示:

{     "stuff": [],     "uuid": "07955261652886032950143702505894272138",     "dcs_region": 7,     "traits": [420020, 5421506],     "segments": [984263, 985264],     "tid": "ss3OTqPiQp0=" }

d_dpid

已弃用。请参阅 d_cid d_cid_ic

d_dpuuid

已弃用。请参阅 d_cid d_cid_ic

d_dst=1

JSON响应中返回URL目标数据。

d_dst_filter

d_dst_filter 是保留属性,用于Adobe Analytics与Audience Manager之间的集成。

我们建议不要创建使用保留属性的特征。 Adobe可以随时更改保留的属性。

d_jsonv=1|0

指示在响应中使用的 JSON版本。 通常,应将此参数设置为 d_jsonv=1。 设置 d_jsonv=0会禁用ID同步。

d_mid

指定Experience Cloud ID服务设置和使用的Experience CloudID。 有关ECID的更多信息,请参阅 Cookie和Experience CloudIdentity服务

d_nsid

命名空格ID。 指示使用的JavaScript容器。 DIL用于ID同步。

d_ptfm

允许Audience Manager将移动设备请求与桌面请求区分开。 支持的值包括:

  • ios
  • android
  • browser
  • all

d_rs

已弃用。 d_rs 是一个保留属性,用于Adobe分析与 Audience Manager 之间的 旧版集成

我们建议不要创建使用保留属性的特征。 Adobe可以随时更改保留的属性。

d_rtbd=json

如果您希望从 DCS获得 JSON响应,则此为必需参数。

  • 如果忽略此值, DCS将返回标头中的像素。
  • 如果包含此对象,则 DCS将在响应正文中返回一个 JSON对象。 请参阅以下示例。 您的响应可能会更加复杂。

{     "stuff": [],     "uuid": "22920112968019678612904394744954398990",     "dcs_region": 7,     "tid": "ss3OTqPiQp0=" }

d_sid

SID 表示分数ID。 这是特征或区段的唯一ID。

d_tdpid

传递数据源以进行特征评估。 仅评估此数据源中的特征。

例如,假设您具有:

  • 特征T1 ,具有:
  • 特征规则:" key1 == val1"
  • 数据源( DPID):1
  • DPID集成代码:ic1
  • 特征T2 ,具有:
  • 特征规则:" key2 == val2"
  • 数据源(DPID):2
  • DPID集成代码:ic2

在示例调用yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1中,仅返回特征T1。

d_tdpid_ic

其用途与上述 d_tdpid参数相同。 但是,在这种情况下,将使用集成代码传递数据源。

保留上述特征,请考虑示例调用:

对于yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2,仅返回特征T2。

d_uuid

独特用户ID。 在Cookie中无法使用此值时标识访客。

在此页面上