Direct integration with the Experience Cloud Identity Service direct-integration-with-the-experience-cloud-id-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 section-a4754afec5ad40b6be00d6f1011d68bb
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 section-26302b8851704888b6f8e6b2071bcdb0
Your request could look similar to the sample shown below. Long variables have been shortened.
Sample response section-89bc103b3e9e4a8b98e74c32897b1200
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 section-4a9912b545364dc4acad4f1ea5ec641d
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.