Skip to content

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: POST with a JSON body (OpenRTB or custom) or GET with 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:

DataNotes
Request IDUnique per request; use it as OpenRTB id
Bid floorThe minimum bid for this request, in USD, CPM or CPC per your pricing
User agent and client hintssec-ch-ua* values when the browser sends them
IP addressIPv4, IPv6 or either
CountryISO 3166 alpha-2 or alpha-3
Language, platform, OS, time zoneAs detected for the request
Publisher domain and pageThe publisher's site domain, e.g. for OpenRTB site.domain / site.page
Source IDPublisher, placement and widget identifiers, e.g. for OpenRTB site.id / tagid
User IDPush subscription or Telegram user ID, where the format has one
Telegram signalsPremium user, rewarded traffic, TON wallet connected (Telegram formats)

What you return ​

FieldRequiredNotes
PriceyesYour bid, greater than 0
Click URLyesA plain URL the user is sent to on click
Title, description, image, icon, button textfor formats that show an adNot needed for Popunder
Win / impression notice URL (nurl)noCalled on impression; ${AUCTION_PRICE} is replaced with the price
Click notice URLnoCalled 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:

json
{
  "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:

json
{
  "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.