Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

Steps for integrating with Springserve as an OpenRTB partner.

Cookie Syncing

The user mappings can be hosted either by Springserve or by the integrating partner. 

For us to initiate cookie sync you need to provide us with your cookie sync url (either to initiate a mapping or to get your user id so we can store the mapping).

If your SpringServe is compliant with the IAB OpenRTB 2.4 specification.  

http://www.iab.com/wp-content/uploads/2016/01/OpenRTB-API-Specification-Version-2-4-DRAFT.pdf

To complete an integration, SpringServe will be asking you for information about the following:

  • Cookie Syncing
  • OpenRTB Bidder Endpoints 
  • QPS and Throttling Preferences

Details and questions can be found below.  For any questions or concerns please email integrations@springserve.com. 

Cookie Syncing

Cookie Syncing is the process by which SpringServe and the integrating partner (IP) can translate a SpringServe user id into the IP user id.  There are two options for integration

SpringServe Hosts

SpringServe is happy to host the mapping of SpringServe user_ids to IP user_ids.  On bid request, we will pass through your user_id. 

Integrating Partner Hosts

If you are hosting the user mapping database you can use the following call to get a springserve user id

...

sync.springserve.com/usersync?redirect_url=https://springserve.com?uid=SS_UUID

In this case we will redirect to springserve and replace SS_UUID with the user's id.

Required Information:

In order to begin a cookie syncing integration, please answer the following questions:

  • Who would you like to initiate the cookie sync (default: SpringServe)?
  • What is your cookie sync URL?
  • Are there any QPS or throttling constraints on your cookie sync URL?


The user mappings can be hosted either by Springserve or by the integrating partner. 

For us to initiate cookie sync you need to provide us with your cookie sync url (either to initiate a mapping or to get your user id so we can store the mapping).


OpenRTB Endpoints

Provide us with your openrtb endpoint/endpoints.

Our datacenters are located in:

  1. Dublin 
  2. Northern Virginia
  3. Cleveland
  4. Portland

Let us know if you need us to hit specific endpoints based on the request region. 

Other Matters

Our protocol follows IAB OpenRTB API 2.4 specifications. Let us know if you have any specific requirements.

...