Supply Cookie Sync
Overview
The Supply Cookie Sync mechanism allows Quantive to map user identifiers between supply partners (publishers) and Quantive's demand partners to enable personalized advertising and measurement. This process is privacy-compliant and supports major consent frameworks such as GDPR and CCPA.
Sync URL
To perform a sync, the following URL should be called via an <iframe>
on the publisher's page:
https://static.qntv.io/sync.html?gdpr=[GDPR]&gdpr_consent=[GDPR_CONSENT]&us_privacy=[US_PRIVACY]&gpp=[GPP]&gpp_sid=[GPP_SID]&redi=[REDIRECT_URL][XUID]
URL Macro Reference
gdpr
Indicates if GDPR applies (0
= No, 1
= Yes).
gdpr_consent
Encoded IAB TCF consent string (if GDPR applies).
us_privacy
CCPA/US Privacy string, typically in IAB format (e.g., 1YNN
).
gpp
Global Privacy Platform (GPP) encoded string.
gpp_sid
GPP Section ID, indicating applicable consent frameworks (e.g., 7
for TCF).
redi
URL-encoded redirect URL which will be called after sync completes.
[XUID]
Placeholder that will be replaced with the user ID during the sync.
Example
https://static.qntv.io/sync.html?gdpr=1&gdpr_consent=CONSENT_STRING&us_privacy=1YNN&gpp=GPP_STRING&gpp_sid=7&redi=https%3A%2F%2Fpartner.com%2Fsetuid%3Fuid%3D[XUID]
Notes
The
redi
parameter must be URL-encoded before being inserted into the sync URL.The
[XUID]
macro should be included within the encoded redirect URL and will be replaced dynamically with the user ID during the sync.
Publisher Requirements
To complete the cookie sync, publishers are required to host the user ID matching table on their end. This table is used to map between Quantive's user ID and the publisher’s internal user ID system.
Requirements:
The matching table must be up-to-date and served from a reliable endpoint.
The redirect URL should include a dynamic placeholder (
[XUID]
) which Quantive will replace during the sync.Proper CORS and caching policies should be applied to ensure efficient and secure delivery.
OpenRTB Integration
Once the sync is complete, the user ID provided by Quantive must be included in the OpenRTB request payload under the following field:
"user": {
"buyeruid": "QUANTIVE_USER_ID"
}
This ensures Quantive can identify and target the user appropriately in programmatic transactions.
Last updated