ID Synchronization for Inbound Data Transfers

Describes the syntax and parameters used in the initial HTTP call to synchronize user IDs between a vendor and Audience Manager. ID synchronization can begin after you send your data taxonomy to Audience Manager.

ID synchronization is the first step in the inbound, asynchronous data transfer process. In this step, Audience Manager and the vendor compare and match IDs for their respective site visitors. For example, an Audience Manager customer may know a user by ID 123. However, your data partner could identify this user with ID 456. The synchronization process allows Audience Manager and a data vendor to reconcile these different IDs and identify users in their respective systems. Once complete, Audience Manager and your third-party partner should have corresponding IDs for each unique user seen on our networks.

You can use the following methods to get your data into Audience Manager:

ID Synchronization HTTP Request

In an ID exchange, a properly formatted URL string should look like this:

https://dpm.demdex.net/ibs:dpid=<VENDOR_ID>&dpuuid=<VENDOR_UUID>&redir=<REDIRECT_URL>

The URL for your inbound ID synchronization call should contain variables described in the table below.

NOTE
Replace italicized content with actual parameter values.
Parameter
Description
<VENDOR_ID>
Unique ID for the content provider (assigned by Audience Manager).
<VENDOR_UUID>

URL (Percent) Encoded representation of your Unique User ID. In addition to encoding reserved ASCII characters, any non-ASCII characters should be percent encoded based on the UTF-8 character encoding table.

For more information, see the URL Encode/Decode Online website.

<REDIRECT_URL>

An encoded URL redirect with the macro ${DD_UUID} embedded within it.

Note: Added only when the content provider initiates the call.

gdpr = <0|1>

Optional. Add this parameter if you are using the Audience Manager Plug-in for IAB TCF.

gdpr can be 0 (GDPR does not apply) or 1 (GDPR applies).

Note: This parameter can only be used together with gdpr_consent.

gdpr_consent=<ENCODED STRING>

Optional. Add this parameter if you are using the Audience Manager Plug-in for IAB TCF.

gdpr_consent is the URL-safe base64-encoded GDPR consent string (see IAB specification).

Note: This parameter can only be used together with gdpr.

Declared ID Event

For more information, see Declared IDs.

ID Synchronization From an Email Embedded Image

The format for matching IDs via an email image is the same as shown above. Note, however, that images in an email must be enabled for this to work. This can affect ID synchronization via email because most mail systems disable images by default.

de293fbf-b489-49b0-8daa-51ed303af695