Receive Data From the DCS
Continue here for information about how to request a DCS response in a /event
call. This section includes a response example and definitions for common data elements in a response.
Before reviewing this content, see Send Data to the DCS.
DCS Response Parameters: A Review
Your DCS request must include d_rtbd=json
if you want to receive a response from the DCS. The DCS will not return data if you omit this parameter. A basic call to the DCS to request data uses this syntax:
https://domain_alias.demdex.net/event?key1=val1&key2=val2&d_dst=1&d_rtbd=json&d_cb=callback
Sample Response
Recall that from the Send Data to the DCS documentation, the fictional company Acme, Inc. made this call:
https://acme_aam_domain.demdex.net/event?videoTypeID=2&data=moarData&d_dst=1&d_rtbd=json&d_cb=acme_callback
As this call includes the required response parameter, the DCS sent back the JSON object shown below. Yours may be similar or more complex.
{
"stuff": [],
"uuid": "22920112968019678612904394744954398990",
"dcs_region": 7,
"tid": "31ZpxW5bQGc="
}
Response Parameters
The table below lists and defines the more common parameters you may see in a response from the DCS. This applies to event calls or other DCS API queries that return data.
c
cn
cv
dcs_region
dests
dmn
aam-api.com
.e
stuff
tid
ttl
u
and uuid
y
iframe
) or image (img
).