Describes the syntax and parameters used in the initial HTTP call to synchronize user IDs between Audience Manager and a third-party data provider. Contact your Adobe Audience Manager consultant before attempting your first ID synchronization.
Purpose of ID Synchronization
ID synchronization is the first step in the outbound, 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 the third-party data provider should have corresponding IDs for each unique user seen on our networks.
URL Syntax
In an ID exchange, a properly formatted URL string should look like this:
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 data provider (assigned by Audience Manager).
<VENDOR_UUID>
Unique user ID.
<REDIRECT_URL>
An encoded URL redirect with the macro ${DD_UUID} embedded within it.
Note: Added only when the data provider initiates the call.
gdpr = <0|1>
gdpr can be 0 (GDPR does not apply) or 1 (GDPR applies).
Note:
The gdpr and gdpr_consent parameters are being gradually rolled out in ID sync URLs with activation partners. See Activation partners that support IAB TCF in Audience Manager Plug-in for IAB TCF.
This parameter can only be used together with gdpr_consent.
gdpr_consent=<ENCODED STRING>
gdpr_consent is the URL-safe base64-encoded GDPR consent string (see IAB specification).
Note: This parameter can only be used together with gdpr.
