The SSP integration process consists of 3 stages:
- Issuing an Endpoint — An SSP is created in the system and an endpoint is automatically generated. This endpoint should be sent to the SSP for implementation.
- Test Campaign Setup — 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 side and yours to make sure the data matches (impressions, publisher revenue). By default, report timezone is UTC.
- Production Mode — If the stats match on both sides, the endpoint is switched from Test to Production, and live campaigns can be added to it. We support OpenRTB 2.5 and prior versions.
To set up a new SSP integration, contact your PPCmate account manager or support — SSP onboarding is configured on our side to make sure test-phase stats are properly validated before any live traffic is switched on.
1. Issuing an Endpoint
When a new SSP is added, PPCmate will configure:
- Status — Active (the SSP can send requests and is visible in the system) or Inactive (requests are paused / hidden).
- UI Name — the name of the SSP as it will be displayed internally.
- Phase — Test (used to run a comparison test with the SSP before going live) or Production (used once the test phase is complete).
- Integration Type — set to OpenRTB API for standard SSP integrations.
- Channel — Native, Video, or Display, based on the inventory type the SSP provides (you can select a combination, e.g. Display + Native, to target the SSP across multiple campaign types later).
- Creative Approval Vendors (optional) — if set, creatives will only run on this SSP once approved by the selected vendor(s).
- Endpoint — the URL the SSP should send requests to; this is generated automatically once the SSP is created.
- Reporting URL — an API URL that can be shared with the SSP for stats comparison (requests, bids, impressions, publisher revenue).
Always start with a Test Phase to compare your stats against the SSP's before switching an endpoint to production.
2. Test Campaign Setup
Once an endpoint is created, a test campaign is mapped to it in the Test Phase. Campaigns created in Test Phase will only see SSPs that are also in Test Phase — an SSP has to be switched to Production Phase before it becomes targetable from a Production campaign.
The test campaign is set up as a standard Media Buying campaign: targeting (location, devices, etc.) and creatives are added, and the test SSP is selected as its supply source.
3. Production Mode
Once stats match between your side and the SSP's, the endpoint is switched from Test to Production, and live demand can be added to it (assuming there are already active campaigns targeting that SSP).
Note: this guide describes the current PPCmate DSP (accessible at https://x.ppcmate.com). If you're referencing older documentation, disregard any mentions of the legacy dsp.ppcmate.com / my.ppcmate.com platforms — those have been retired.