Send Data to the DCS
Start here for information about making /event
calls to the DCS. This section includes information about call syntax, parameters, formatting, and a request example.
Call Syntax
A basic URL
string that sends data to the DCS uses the syntax shown below.
https://domain_alias.demdex.net/event?key1=val1&key2=val2&d_dst=1&d_rtbd=json&d_cb=callback
POST
method. The call syntax is described in DCS API Methods.Call Parameters
The following table defines the basic components of a simple DCS call.
domain alias.demdex.net
This part of the call contains:
- Your domain alias assigned by Audience Manager (e.g.,
my_domain.demdex.net
). - The destination domain, which is always
demdex.net
. See Understanding Calls to the Demdex Domain.
/event?
This part of the call:
- Identifies the call as an event call.
- Defines the start of the URL string that contains the data you want to send to the DCS.
key
A unique identifier in the key-value pair.
These key-value pairs use a specific prefix to identify the type of data you're sending to the DCS. For more information, see Supported Attributes for DCS API Calls.
val
A variable value that belongs to a set defined by a key in the key-value pair.
When working with values:
- Enclose string data in double quotes (e.g.,
age="41 to 55"
). - You can pass multiple keys in on a single value (e.g.,
key
=val1,val2,val3
).
d_dst=1
d_rtbd=json
d_cb=callback
Optional response parameters.
None of these are required to send data to the DCS. However, if you want the DCS to return a response, you must include d_rtbd=json
in your request.
Sample Call
This example shows the fictional company Acme, Inc. sending data to the DCS via an HTTP call. Note that this call includes the optional parameters d_dst=1
, d_rtbd=json
, and d_cb=callback
. These indicate that Acme wants to receive a JSON response from the DCS with a call back function. Remember, this is just an example. Do not cut and paste this code.
https://acme_aam_domain.demdex.net/event?videoTypeID=2&data=moarData&d_dst=1&d_rtbd=json&d_cb=acme_callback
Next Steps
Now that you’re familiar with sending data to the DCS, it’s time to look at how to get data back from it and parse that information. See Receive Data From the DCS.