Update your code to use d_cid
or d_cid_ic
instead of d_dpid
and d_dpuuid
. The DPID and DPUUID variables will continue to work, but you should consider them deprecated. This includes DPID and DPUUID variants without the d_ prefix
.
The DPID and the DPUUID are key-value pairs that contain a data provider ID and a user ID. These key-value pairs link provider IDs to user IDs. They send in data during event calls, for inbound synchronization events, and for ID calls. Without them, Audience Manager, and other services or features, would not have a way to match and synchronize IDs. These variables are sometimes expressed with or without the d_
prefix as shown below. Note, in the code, italics indicates a variable placeholder.
Variable | Syntax |
---|---|
Data Provider ID (DPID) |
|
Data Provider Unique User ID (DPUUID) |
|
These key-value pairs still work, but they are deprecated. You should update your code to use CID or CID_IC instead.
The CID and CID_IC key-value pairs replace DPID and DPUUID. They provide the same functions as the DPID and DPUUID, but are more efficient because they include the data provider ID (or integration code) and user ID in a single key-value pair. In each key-value pair:
d_cid
and d_cid_ic
use the syntax shown below. Note, in the code, italics indicates a variable placeholder.
Variable | Syntax |
---|---|
Customer ID (CID) |
|
Customer ID Integration Code (CID_IC) |
An integration code is an alternate ID you can use instead of the Data Source ID, assigned by Audience Manager. See Create a Data Source if you need to configure an integration code. |
See also, URL Variables and Syntax for Declared IDs.
You can use integration codes for your own data sources and for global shared data sources, which you have access to. For example, you can use integration codes when working with mobile identifiers data sources. Use the following integration codes, exactly as specified below:
Examples
The following table provides examples by event type.
Event Type | Example |
---|---|
Event |
|
Inbound Synchronization (IBS) |
|
Generate Audience Manager UUID (ID) |
|
Each call can also include multiple d_cid
and d_cid_ic
key value pairs like this:
...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...
Item |
Description |
---|---|
URL encoding |
Your development teams must apply URL encoding to the following variables in the CID key-value pair:
Note: You must URL encode the user ID and integration code before concatenating them into a string. This is because the ASCII character %01 that separates the two variables must not be captured in the URL encoding. URL encoding assures that your user IDs and integration codes that contain reserved or unsafe characters such as, but not limited to, + or = are transmitted correctly to our servers. Use the ASCII encoding table for reference. |
Using integration codes for global shared data sources |
You can use integration codes for your own data sources and for global shared data sources, which you have access to. For example, you can use integration codes when working with mobile identifiers data sources. Use the following integration codes, exactly as specified below:
|