Direct integration with the Experience Cloud Identity Service
This implementation lets customers use the ID service on devices that cannot accept or work with our JavaScript or SDK code. This includes devices such as gaming consoles, smart TVs, or other Internet-enabled appliances. Refer to this section for syntax, code samples, and definitions.
Syntax
Devices that cannot use the VisitorAPI.js or SDK code libraries can make calls directly to the data collection servers (DCS) used by the ID service. To do this, you would call dpm.demdex.net and format your request as shown below. Italics indicates a variable placeholder.
In this syntax example, the d_ prefix identifies the key-value pairs in the call as a system-level variable. You can pass quite a few d_ parameters to the ID service, but stay focused on the key-value pairs as shown in the code above. For more information about other variables, see Supported Attributes for DCS API calls.
The ID service supports HTTP and HTTPS calls. Use HTTPS to pass data from a secure page.
Sample request
Your request could look similar to the sample shown below. Long variables have been shortened.
Sample response
The ID service returns data in a JSON object as shown below. Your response may be different.
{
"d_mid":"12345",
"dcs_region":"6",
"id_sync_ttl":"604800",
"d_blob":"wxyz5432"
}
Request and response parameters defined
Request Parameters
An optional parameter that passes the Data Provider ID (DPID), the Unique User ID (DPUUID), and an authenticated state ID to the ID service. As shown in the code sample, separate the DPID and DPUUID with the non-printing control character, %01.
DPID and DPUUID
In the d_cid parameter, assign each related DPID and DPUUID combination to the same d_cid parameter. This lets you return multiple ID sets in a single request. Also, separate the DPID, DPUUID, and optional authentication flag with the non-printing control character, %01. In the examples below, the provider and user IDs are highlighted in bold text.
- Syntax: ...d_cid=DPID%01DPUUID%01authentication state...
- Example: ...d_cid=123%01456%011...
Authentication State
This is an optional ID in the d_cid parameter. Expressed as an integer, it identifies users according to their authentication status as shown below:
- 0 (Unknown)
- 1 (Authenticated)
- 2 (Logged out)
To specify an authentication state, you set this flag after the user ID (UUID) variable. Separate the UUID and authentication flag with the non-printing control character, %01. In the examples below, the authentication IDs are highlighted in bold text.
Syntax: ...d_cid=DPID%01DPUUID%01authentication state
Examples:
- Unknown: ...d_cid=123%01456%010...
- Authenticated: ...d_cid=123%01456%011...
- Logged out: ...d_cid=123%01456%012...
Response Parameters
Some response parameters are part of the request and have been defined in the section above.