ÃÛ¶¹ÊÓƵ

Supported Attributes for DCS API Calls 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.

Attribute Prefixes 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 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_coppa
Disable usage of third party cookies in order to comply with child protection regulations. This parameter is dynamically set by the ÃÛ¶¹ÊÓƵ ÃÛ¶¹ÊÓƵ Experience Platform Identity Service and depends on the idSyncDisable3rdPartySyncing configuration. See COPPA Support in the ÃÛ¶¹ÊÓƵ Experience Platform Identity Service.

d_cts=1

d_cts=2

Optional. Enabled on customer request. Contact your ÃÛ¶¹ÊÓƵ 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_dst_filter

d_dst_filter is a reserved attribute, used in the integration between ÃÛ¶¹ÊÓƵ Analytics and Audience Manager.

We advise against creating traits that use reserved attributes. ÃÛ¶¹ÊÓƵ may change reserved attributes at any time.

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 Experience Cloud ID set and used by the Experience Cloud ID service. For more information about the ECID, see Cookies and the Experience Cloud Identity Service.
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_rs

Deprecated. d_rs is a reserved attribute, used in the legacy integration between ÃÛ¶¹ÊÓƵ Analytics and Audience Manager.

We advise against creating traits that use reserved attributes. ÃÛ¶¹ÊÓƵ may change reserved attributes at any time.

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_tdpid

Passes a data source for trait evaluation. Only traits from this data source are evaluated.

For example, say you have:

  • Trait T1 with:
  • Trait rule: " key1 == val1"
  • Data Source ( DPID): 1
  • DPID integration code: ic1
  • Trait T2 with:
  • Trait rule: " key2 == val2"
  • Data Source (DPID): 2
  • DPID integration code: ic2

In a sample call, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1, only trait T1 is returned.

d_tdpid_ic

The purpose is identical to the d_tdpid parameter described above. However, in this case, the data source is passed using the integration code.

Keeping the traits described above, consider the sample call:

For yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2, only trait T2 is returned.

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

h_ Attributes

These headers contain information like requests for data and responses in an HTTP call.

Attribute
Description
h_host
This is set to the client’s specific data collection host name. It appears as host name .demdex.net. See Understanding Calls to the Demdex Domain.
h_user-agent
Set to the User-Agent header value.
h_accept-language
Set to the Accept-Language header value.
h_referer
Set to the Referer header value.
h_referrer
Set to the Referrer header value.
h_date
Set to the Date header value.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695