How to Integrate Supply Partners (SSPs)

The SSP integration process consists of 3 stages:
1) An endpoint is issued to an SSP.
2) A test campaign is mapped to the endpoint. After an SSP starts sending requests and a test campaign runs for a day or two, you can compare the stats on their and your side to make sure the data match. 
3) If the stats match on both sides, endpoint can be switched to a production phase, and live campaigns can be added.
NB: SSPs may track impressions either by nURL or adm, so please inform our tech team what method they use for impressions tracking before you start integration testing.
OpenRTB specification for SSP integration can be found  here. We support OpenRTB 2.5 (and prior versions)

1. Issuing an Endpoint

To add a new SSP, please follow the steps below:

a) go to RTB tab in your admin panel and click on "Add RTB" button

b) provide RTB name (for SSP endpoint) and Display name (what name you want the SSP to be displayed in the UI)

1 - Status: choose Active if you'd like the SSP to be able to send requests and be visible in the UI, Inactive - if you'd like to pause requests from the SSP or hide it in the UI

2 - RTB Name: name of the SSP the endpoint will be based on

3 - RTB Display Name: name of the SSP that will be displayed in the UI 

4 - Test Mode: Phase I - allows to chek the ping and bid format, Phase II - is used for stats comparison, Production - is used after a test is over in order to add live demand to the ednpoint

5 - Supply Type: choose Display/ Video or Native based on the inventory type the SSP provides to you

6 - Endpoint: the URL the SSP should send requests to, e.g: http://rtbsupplier.rtb.adx1.com

7 - User Sync URL: the URL the SSP should implement on its side for cookie sync, e.g.: http://rtbsupplier.rtb.adx1.com/users/sync

c) click "Save"

2. Test Campaign Setup

After an endpoint is created, a test campaign should be mapped to it:

a) go to "Campaigns" tab and click "Add campaign"

b) set up a campaign to Phase II for a test with SSP. You can refer to the image below as an example:

c) click "Save campaign"

NB: this campaign in phase II can be used for integration with as many SSPs as you want. You can simply create a new ad group (strategy) for each new SSP under this campaign

d) create an ad group (strategy) for the SSP you are going to integrate, specifying it in "Supply sources" tab. You can also set the GEO, OS, browser, device, etc. 

e) let the ad group work for a day/ few days and then compare the stats on both your and SSP side (impressions, ad spend). The stats in the UI is povided in UTC

3. Production Mode

If there is mo mismatch between the stats recorded on your and SSP side, you can switch its endpoint from Phase II to Production (RTB tab). This means live demand will be added to the endpoint (if you already have active campaigns targeting the SSP you've just integrated with)

Still need help? Contact Us Contact Us