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.

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.