DSP Integration
This page is for demand partners (DSPs) that want to buy Adexium traffic through their own bidder. On every ad request Adexium calls your endpoint, and your bid competes in our auction.
There is no single fixed format. Your account manager sets up a request template and a response template for your endpoint, so we can speak OpenRTB 2.5 or your own JSON format. The examples below are illustrative — the exact fields are agreed during onboarding.
What we send
- Method:
POSTwith a JSON body (OpenRTB or custom) orGETwith query parameters. - Formats: one endpoint per format — Popunder, In-Page Push, Web Push, Telegram Mini Apps, Telegram Bot or iMe.
- Pricing: CPM or CPC — agreed per endpoint.
- Compression: we accept gzip-compressed responses.
Values we can put into the request:
| Data | Notes |
|---|---|
| Request ID | Unique per request; use it as OpenRTB id |
| Bid floor | The minimum bid for this request, in USD, CPM or CPC per your pricing |
| User agent and client hints | sec-ch-ua* values when the browser sends them |
| IP address | IPv4, IPv6 or either |
| Country | ISO 3166 alpha-2 or alpha-3 |
| Language, platform, OS, time zone | As detected for the request |
| Publisher domain and page | The publisher's site domain, e.g. for OpenRTB site.domain / site.page |
| Source ID | Publisher, placement and widget identifiers, e.g. for OpenRTB site.id / tagid |
| User ID | Push subscription or Telegram user ID, where the format has one |
| Telegram signals | Premium user, rewarded traffic, TON wallet connected (Telegram formats) |
What you return
| Field | Required | Notes |
|---|---|---|
| Price | yes | Your bid, greater than 0 |
| Click URL | yes | A plain URL the user is sent to on click |
| Title, description, image, icon, button text | for formats that show an ad | Not needed for Popunder |
Win / impression notice URL (nurl) | no | Called on impression; ${AUCTION_PRICE} is replaced with the price |
| Click notice URL | no | Called on click; ${AUCTION_PRICE} is replaced too |
${AUCTION_PRICE} inside the click URL is replaced as well.
To pass on a request, answer HTTP 204 No Content.
Timeouts
Answer within 250 ms (p99). Responses later than our deadline are dropped, and an endpoint that is slow or times out often is paused automatically for a while.
Example: OpenRTB 2.5 popunder
Request:
{
"id": "8f1c2a7e-3b4d-4e5f-9a6b-7c8d9e0f1a2b",
"at": 2,
"imp": [{
"id": "1",
"bidfloor": 0.35,
"bidfloorcur": "USD"
}],
"site": {
"id": "9c2d7b1e-0f3a-4b5c-8d6e-1f2a3b4c5d6e-1204",
"domain": "example.com",
"page": "https://example.com"
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0 Mobile Safari/537.36",
"ip": "203.0.113.10",
"language": "en",
"geo": { "country": "USA" }
},
"cur": ["USD"]
}Response:
{
"id": "8f1c2a7e-3b4d-4e5f-9a6b-7c8d9e0f1a2b",
"seatbid": [{
"bid": [{
"id": "1",
"impid": "1",
"price": 0.52,
"nurl": "https://dsp.example.com/win?price=${AUCTION_PRICE}",
"adm": "https://dsp.example.com/click?id=abc123"
}]
}]
}For a popunder, adm carries the URL the new tab opens.
Getting started
Contact your account manager or support with your endpoint, the formats and countries you buy, your pricing model and your request/response specification.