Send Data to the DCS 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.

NOTE
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.

Call Syntax dcs-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
NOTE
You can also send data to the DCS by using the POST method. The call syntax is described in DCS API Methods.

Call Parameters dcs-call-parameters

The following table defines the basic components of a simple DCS call.

Component
Description
domain alias.demdex.net

This part of the call contains:

/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).

See Formatting Key-Value Pairs in DCS Calls.

  • 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.

See d_ Key-Value Pairs Defined.

Sample Call dcs-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 dcs-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.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695