ID Synchronization for Outbound Data Transfers id-synchronization-for-outbound-data-transfers
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:
https://dpm.demdex.net/ibs:dpid=<VENDOR_ID>&dpuuid=<VENDOR_UUID>&redir=<REDIRECT_URL>
URL Parameters
The URL for your inbound ID synchronization call should contain variables described in the table below.
<VENDOR_ID><VENDOR_UUID><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
gdprandgdpr_consentparameters 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.