Supported Attributes for DCS API Calls

Lists and describes the syntax and supported attributes (or key-value pairs) you can pass in to the Data Collection Servers (DCS). This information can help you format your DCS requests and understand the parameters returned by this system.

Contents:

Attribute Prefixes

The DCS relies on specific prefixes added to the keys in key-value pairs to classify the type of data you're passing in.

Key Prefix Reserved For

c_

Customer-defined attributes.

d_

Audience Manager attributes.

h_

HTTP header data.

p_

Private, customer-defined attributes.

The DCS accepts your own, private data when the key has a p_ prefix. Private data is used for trait evaluation, but it will not be logged or stored in our system. For example, lets say you have a trait defined as customers = p_age<25 and you pass in p_age=23 in an event call. Given these conditions, the user who meets the age-based qualification criteria qualifies for the trait, but the key-value pair is dropped after Audience Manager receives the request and is not logged.

d_ Attributes

All of these are optional, unless you want a response from the DCS. If you want the DCS to return a response, then d_rtbd=json is required.

Attribute Description

d_caller

Used to identify the caller who is making the call to the DCS API.

d_cb

Specifies a JavaScript function you want to execute using the DCS response as a function parameter of the callback function.

d_cid

Contains one or more pairs of data provider IDs (DPID) and data provider user IDs (DPUUID) assigned by Audience Manager. If you use multiple pairs of DPIDs and DPUUIDs, separate each pair with the non-printing character %01. For example: DPID%01DPUUUID.

d_cid replaces d_dpid and d_dpuuid, which are deprecated but still supported. See CID Replaces DPID and DPUUID.

d_cid_ic

Contains an integration code and an associated unique user ID in a single key-value pair.

d_cid_ic replaces d_dpid and d_dpuuid, which are deprecated but still supported. See CID Replaces DPID and DPUUID.

d_cts=1

d_cts=2

Optional. Enabled on customer request. Contact your Adobe Audience Manager consultant or Customer Care.

Indicates that traits and segments should be returned inside the JSON response.

  • d_cts=1 returns legacy segment IDs for the segments.

  • d_cts=2 returns segment IDs for the segments.

A sample response could look like the one below:

{
    "stuff": [],
    "uuid": "07955261652886032950143702505894272138",
    "dcs_region": 7,
    "traits": [420020, 5421506],
    "segments": [984263, 985264],
    "tid": "ss3OTqPiQp0="
}

d_dpid

Deprecated. See d_cid and d_cid_ic.

d_dpuuid

Deprecated. See d_cid and d_cid_ic.

d_dst=1

Returns URL destination data in the JSON response.

d_jsonv=1|0

Indicates the JSON version to use in the response. Normally, you should set this to d_jsonv=1. Setting d_jsonv=0 disables ID syncs.

d_mid

Specifies the visitor ID set and used by the Experience Cloud ID service. For more information about the MID, see Cookies and the Experience Cloud ID.

d_nsid

Name Space ID. Indicates which JavaScript container is used. Used by DIL to for id-syncing.

d_ptfm

Allows Audience Manager to distinguish mobile requests from desktop requests. Supported values include:

  • ios
  • android
  • browser
  • all

d_rtbd=json

Required if you want a JSON response from the DCS.

  • If you omit this, the DCS returns a pixel in the header.
  • If you include this, the DCS returns a JSON object in the body of the response. See the example below. Your response could be more complex.
{
    "stuff": [],
    "uuid": "22920112968019678612904394744954398990",
    "dcs_region": 7,
    "tid": "ss3OTqPiQp0="
}

d_sid

SID stands for score ID. This is a unique ID for a trait or a segment.

d_uuid

Unique user ID. Identifies a visitor when this value is not available from a cookie.