Sovrn oRTB Cookie Sync Spec
About the Sovrn Cookie Sync Pixel
The Sovrn Cookie Sync Pixel is initiated by the publisher when a request is sent to Sovrn with the below endpoint.
This method allows a cookie sync to occur more often. Other integrations with Sovrn will only launch a cookie sync when Sovrn generates an impression.
Here is the full endpoint:
https://ap.lijit.com/pixel?gdpr=${GDPR}&gdpr_consent=${GDPRString}&gpp=${GPP}&gpp_sid=${GPPSid}&redir=${URLEncodedRedirectString}=$UID
Here's a quick explanation of each parameter you will need.
gdpr
the gdpr flag
use 1 if the geo is a GDPR territory, if not use 0
needs to be populated by the partner
gdpr_consent
the tcf2.2 gdpr consent string
needs to be populated by the partner
gpp
the GPP string
needs to be populated by the partner
gpp_sid
the section ID(s) in force for the current transaction. (comma-separated sequence of integers)
needs to be populated by the partner
redir
Redirect URL encoded sync pixel provided by the partner
use the macro below at the end of the encoded redir
Server Side Macros
The following macro is used to populate dynamic parameter values. It must be placed at the end of the redir parameter. Please refer to the examples below to see how this should look.
$UID
Populates Sovrn Reader ID (a.k.a. the Sovrn Cookie)
Examples
Here is an example of the cookie sync pixel with the URL not encoded:
https://ap.lijit.com/pixel?gdpr=${GDPR}&gdpr_consent=${GDPRString}&gpp=${GPP}&gpp_sid=${GPPSid}&redir=https://ssp.disqus.com/match?bidder=12&buyeruid=$UID
Here is an example of the cookie sync pixel with the location encoded:
https://ap.lijit.com/pixel?gdpr=${GDPR}&gdpr_consent=${GDPRString}&gpp=${GPP}&gpp_sid=${GPPSid}&redir=https%3A%2F%2Fssp.disqus.com%2Fmatch%3Fbidder%3D12%26buyeruid%3D%24UID
URL Encoding
The redirect URL parameter should always be encoded. It's also important that the Sovrn ID macro ($UID) is already included in the URL before it is encoded as well.
Here is an encoding tool that our teams regularly use.
Our team can set this up for you if you provide your pixel. Of course, please reach out to Sovrn Support if you have any issues with setup.