Publishers (SSP) integration

You send us OpenRTB 2.5 bid requests for popunder impressions; we answer with a first-price bid or no bid. You are paid for impressions confirmed by our billing notice.

Endpoint

POST https://rtb.example.net/openrtb/{your-key}
Content-Type: application/json
X-Openrtb-Version: 2.5        (optional)

• The full URL, with {your-key}, is issued by your account manager. The key works as your password: keep it private.
• HTTPS is recommended; plain HTTP is accepted too. We never redirect the bid endpoint.
• Method POST, a JSON Content-Type, body up to 64 KB, no compression (Content-Encoding is not supported).

Response codes

We never answer the bid endpoint with other codes. A malformed request, an unknown key, a paused feed, a request above your agreed rate or an overload are all answered as no bid — your system never sees an error status from us and never has to throttle us.

Bid request

{
  "id": "079675c8bdb440daa073c39fbac3bacc",
  "imp": [{
    "id": "3851dc773b66462f81bc32c3a07a08aa",
    "instl": 1,
    "tagid": "1234",
    "bidfloor": 0.01,
    "bidfloorcur": "USD",
    "secure": 1
  }],
  "site": {
    "id": "777",
    "domain": "example.com",
    "page": "https://example.com/page",
    "publisher": {"id": "12"}
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 13; Pixel 7)",
    "ip": "203.0.113.10",
    "language": "en",
    "js": 1,
    "geo": {"country": "DEU"}
  },
  "user": {"id": "64223830e7e94f0ebedf5966599fc9d8"},
  "at": 1,
  "tmax": 250,
  "cur": ["USD"]
}

curl -i -X POST 'https://rtb.example.net/openrtb/YOUR_KEY' \
  -H 'Content-Type: application/json' \
  --data @request.json
# 200 with a bid, or 204 for no bid

Floors and timeouts

• Floor. Our bid price is never below your imp.bidfloor. Bids under the floor are dropped on our side and you get no bid.
• Time. We answer within tmax (at most 250 ms) minus a network reserve, or with no bid. Late buyer answers are dropped, never sent to you after the time is up.

Bid response

{
  "id": "079675c8bdb440daa073c39fbac3bacc",
  "seatbid": [{
    "seat": "…",
    "bid": [{
      "id": "…",
      "impid": "3851dc773b66462f81bc32c3a07a08aa",
      "price": 0.0388,
      "adm": "https://go.example.net/r/…",
      "burl": "https://burl.example.net/b/…",
      "nurl": "https://burl.example.net/w/…",
      "adomain": ["advertiser.example"],
      "crid": "…"
    }]
  }],
  "cur": "USD"
}

• id equals your request id; cur is always USD.
• price — our CPM bid in USD. It is final: first price, it is what you bill us.
• adm — the popunder URL: open it as is. It redirects (HTTP 302) to the advertiser's page.
• burl — our billing notice, nurl — our win notice (see Notices). There is no lurl.
• At most one bid per impression: the highest valid one. Other bid fields (adomain, crid, cat …) are the buyer's.

Notices

• Call notices with GET (POST is accepted). HEAD requests are ignored, so link checkers never count an impression.
• Our burl carries no price: the price is the one in the bid. If you append the clearing price (for example ?p=0.0388), we keep it for reconciliation only.
• The notice URLs never redirect.

Statistics and reconciliation

Your statistics with us (requests, bids, wins, impressions, amount) are available by the reporting API. If you give us a read-only key to your reporting API, we reconcile with your numbers every day.

FAQ

Why do I get many 204 answers?

A 204 means no bid. Common reasons: no buyer bid above your floor, the traffic does not match the feed's filters, the request is above your agreed rate, the currency is not USD, the request is malformed (for example a missing id or imp), or the buyer did not answer in time. Your manager can see a breakdown of the reasons for your feed.

Do you answer HTTP 429 or 5xx?

No. The bid endpoint only answers 200 with a bid or 204 (or 200 empty) with no bid.

Which formats do you buy?

Popunder only.

Do I need to fill in ${AUCTION_PRICE}?

No. We bid first price and our burl carries no price macro.

Can I send several impressions in one request?

Yes. Each impression gets at most one bid — the best valid one.

Is there a test mode?

There is no test flag yet. We test the integration together on a small volume before the feed goes live.