OpenRTB S2S guide

oRTB 2.5
Version: 1.3

Getting Started

In order to start receiving requests you need to supply us with:

  1. Endpoints (URLs) and optional port number (Default is 80) - US SC, US NY, EU, FR, IN, APAC
  2. QPS limit (if needed)
  3. Sync URL - in case of web environment
  4. Campaign ID - the relevant seat\campaign being called
  5. Specify unique requests which are not based on oRTB 2.5 standard
  6. Targeting: The Primis SSP can send bid requests to the specific targeting, based on your needs

Bid Request

The Primis SSP service follows the OpenRTB 2.5 guidelines.
In addition, our service is flexible and can support additional variables or any required customization.

Restrictions

  • Supported inventory: inline video
  • Supported platforms: desktop, mobile web and mobile apps
  • Bid request timeout is 1000ms (bidrequest.tmax)
  • First-price auction is applied (bidrequest.at is set to 1)
  • All bid requests requires secure (bidrequest.secure is set to 1)
  • TAG pchain is always sent (bidrequest.source.pchain)
  • GDPR consent string is send if GDPR should be applied (bidrequest.regs.ext.gdpr, bidrequest.regs.ext.consent) according to TCF 2.0
  • Schain object is sent according to oRTB 2.5 standartd (bidrequest.source.ext.schain), but can support other hierarchies as well
  • Supported blocking capabilites (bcat, badv)

Cookie Syncing

This applies only to desktop and mobile web traffic
Syncing DSP user ID with Primis’ user ID is initiated by the DSP.
The Primis user ID and The DSP user ID will be added to the bid request (bidrequest.user.id, bidrequest.user.buyeruid)

Syncing Primis (the DSP initiates the call):

👍

Create a “cookie mapping URL” using the below template:

https://live.primis.tech/live/liveCS.php?source=external&pixel=<REDIRECT_URL_ENCODED>&advId=<DSP_ID>&advUuid=<DSP_UNIQUE_USER_ID>

  • DSP_ID. Replace this with your assigned DSP ID (received from our account manager)
  • DSP_UNIQUE_USER_ID. Replace with your user ID for syncing
  • REDIRECT_URL_ENCODED. Replace a redirection link (if necessary, not mandatory). a ${UUID_MACRO} macro can be added to the redirection link in order to receive back Primis's user id.

Wrap the URL with an image pixel and drop the pixel in the appropriate location in your creative


Did this page help you?