从DCS接收数据 receive-data-from-the-dcs
继续此处以了解有关如何在/event
调用中请求DCS响应的信息。 此部分包括响应示例以及响应中常见数据元素的定义。
在查看此内容之前,请参阅将数据发送到DCS。
DCS响应参数:审查 dcs-response-parameters
如果您想从DCS接收响应,您的DCS请求必须包括d_rtbd=json
。 如果忽略此参数,DCS将不会返回数据。 对DCS的基本调用将使用此语法:
https://domain_alias.demdex.net/event?key1=val1&key2=val2&d_dst=1&d_rtbd=json&d_cb=callback
示例响应 sample-response
回想一下,在将数据发送到DCS文档中,虚构的公司Acme, Inc.进行了以下调用:
https://acme_aam_domain.demdex.net/event?videoTypeID=2&data=moarData&d_dst=1&d_rtbd=json&d_cb=acme_callback
由于此调用包含所需的响应参数,因此DCS发送回如下所示的JSON对象。 您的可能会相似或更复杂。
{
"stuff": [],
"uuid": "22920112968019678612904394744954398990",
"dcs_region": 7,
"tid": "31ZpxW5bQGc="
}
响应参数 response-parameters
下表列出并定义了您在DCS的响应中可能看到的更常见参数。 这适用于事件调用或其他DCS API返回数据的查询。
参数
描述
c
已设置为URL目标的URL。
cn
在Cookie目标的Cookie名称字段中设置的名称或ID。
cv
发送到由“cn”:“目标名称”参数定义的目标位置的值。
dcs_region
dests
此对象包含在UI中配置的所有URL目标的信息。 此对象的列表是动态的,取决于用户的操作。
dmn
这是Cookie目标的“Cookie域”字段中指定的域。 请参阅Cookie目标的可选设置。 对于服务器到服务器的集成,我们建议使用类似
aam-api.com
的域。e
已在URL目标中设置的安全URL。
stuff
此对象包含所有Cookie目标的信息。 此对象的列表是动态的,取决于用户的操作。
tid
交易ID,用于调试的唯一的12个字符ID。 对DCS进行的每个/event调用都会收到一个tid,您可以在支持查询中引用该值,以便做出更好、更快的响应。
ttl
Cookie存留期值(以天为单位)。
u
和 uuid
由Audience Manager分配的独特用户ID。 如果您正在进行服务器到服务器DCS调用,则需要此项。
y
目标类型、iFrame (
iframe
)或图像(img
)。recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695