Skip to main content
Skip table of contents

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

  • 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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.