Start here for information about making /event
calls to the DCS. This section includes information about call syntax, parameters, formatting, and a request example.
In the code and examples, italics represents a variable placeholder. Substitute a real value for the placeholder when you send data to the DCS with this method.
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
You can also send data to the DCS by using the POST
method. The call syntax is described in DCS API Methods.
The following table defines the basic components of a simple DCS call.
Component | Description |
---|---|
|
This part of the call contains:
|
|
This part of the call:
|
|
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. |
|
A variable value that belongs to a set defined by a key in the key-value pair. When working with values:
|
|
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 |
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
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.