DCS API调用支持的属性 supported-attributes-for-dcs-api-calls

列出并说明可传递到Data Collection Servers (DCS)的语法和支持的属性(或键值对)。 此信息可帮助您格式化DCS请求并了解此系统返回的参数。

属性前缀 attribute-prefixes

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

密钥前缀
保留用于
c_
客户定义的属性。
d_
Audience Manager属性。
h_
HTTP标头数据。
p_

私有、客户定义的属性。

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

d_属性 d-attributes

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

属性
描述
d_caller
用于标识对 DCS API进行调用的调用方。
d_cb
指定要使用 DCS响应作为回调函数的函数参数执行的JavaScript函数。
d_cid

包含由用户分配的一个或多个数据提供程序ID ( DPID)和数据提供程序Audience ManagerID ( DPUUID)对。 如果您使用多对 DPID DPUUID,请用非打印字符 %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 Analytics和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"
  • 数据Source ( DPID): 1
  • DPID集成代码:ic1
  • 特征T2,带:
  • 特征规则: " key2 == val2"
  • 数据Source (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中无法提供此值时标识访客。

h_属性

这些标头包含诸如HTTP调用中的数据请求和响应之类的信息。

属性
描述
h_host
设置为客户端的特定数据收集主机名。 它显示为host name .demdex.net。 请参阅了解 Demdex 域调用
h_user-agent
设置为User-Agent标头值。
h_accept-language
设置为Accept-Language标头值。
h_referer
设置为Referer标头值。
h_referrer
设置为Referrer标头值。
h_date
设置为Date标头值。
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695