DCS API调用支持的属性 supported-attributes-for-dcs-api-calls
列出并说明可传递到Data Collection Servers (DCS)的语法和支持的属性(或键值对)。 此信息可帮助您格式化DCS请求并了解此系统返回的参数。
属性前缀 attribute-prefixes
DCS依赖于添加到键值对中的键的特定前缀来分类您要传入的数据类型。
c_
d_
h_
p_
私有、客户定义的属性。
当密钥具有 p_
前缀时,DCS接受您自己的私有数据。 私有数据用于特征评估,但不会记录或存储在我们的系统中。 例如,假设您有一个定义为 customers = p_age<25
的特征,并且在事件调用中传入 p_age=23
。 根据这些条件,符合基于年龄的资格标准的用户符合特征资格,但在Audience Manager收到请求且未记录后,键值对将被删除。
d_属性 d-attributes
除非您需要DCS的响应,否则所有这些都是可选的。 如果您希望DCS返回响应,则需要d_rtbd=json
。
d_caller
d_cb
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
d_nsid
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
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
标头值。