Интеграция DSP
Эта страница — для партнёров по спросу (DSP), которые хотят покупать трафик Adexium через собственный биддер. На каждый рекламный запрос Adexium обращается к вашему эндпоинту, и ваша ставка участвует в нашем аукционе.
Единого фиксированного формата нет. Ваш менеджер настраивает шаблон запроса и шаблон ответа под ваш эндпоинт, поэтому мы можем работать по OpenRTB 2.5 или в вашем собственном JSON-формате. Примеры ниже — иллюстрация; точные поля согласуются при подключении.
Что мы отправляем
- Метод:
POSTс JSON-телом (OpenRTB или свой формат) илиGETс query-параметрами. - Форматы: один эндпоинт на формат — Popunder, In-Page Push, Web Push, Telegram Mini Apps, Telegram Bot или iMe.
- Модель оплаты: CPM или CPC — согласуется для каждого эндпоинта.
- Сжатие: мы принимаем ответы, сжатые gzip.
Что можно передать в запросе:
| Данные | Примечание |
|---|---|
| ID запроса | Уникален для каждого запроса; используйте как OpenRTB id |
| Минимальная ставка | Минимум для этого запроса в USD, CPM или CPC по вашей модели оплаты |
| User agent и client hints | Значения sec-ch-ua*, если их прислал браузер |
| IP-адрес | IPv4, IPv6 или любой |
| Страна | ISO 3166 alpha-2 или alpha-3 |
| Язык, платформа, ОС, часовой пояс | Как определены для запроса |
| Домен и страница паблишера | Домен сайта паблишера, например для OpenRTB site.domain / site.page |
| ID источника | Идентификаторы паблишера, плейсмента и виджета, например для OpenRTB site.id / tagid |
| ID пользователя | ID пуш-подписки или пользователя Telegram, если у формата он есть |
| Сигналы Telegram | Premium, мотивированный трафик, подключённый TON-кошелёк (форматы Telegram) |
Что вы возвращаете
| Поле | Обязательно | Примечание |
|---|---|---|
| Цена | да | Ваша ставка, больше 0 |
| URL клика | да | Обычный URL, куда пользователь попадёт по клику |
| Заголовок, описание, изображение, иконка, текст кнопки | для форматов с объявлением | Для Popunder не нужны |
URL уведомления о показе (nurl) | нет | Вызывается при показе; ${AUCTION_PRICE} заменяется ценой |
| URL уведомления о клике | нет | Вызывается при клике; ${AUCTION_PRICE} тоже заменяется |
${AUCTION_PRICE} внутри URL клика тоже заменяется.
Чтобы пропустить запрос, ответьте HTTP 204 No Content.
Таймауты
Отвечайте в пределах 250 мс (p99). Ответы позже нашего дедлайна отбрасываются, а эндпоинт, который часто отвечает медленно или по таймауту, автоматически приостанавливается на время.
Пример: OpenRTB 2.5 попандер
Запрос:
{
"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"]
}Ответ:
{
"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"
}]
}]
}Для попандера в adm передаётся URL, который откроется в новой вкладке.
Как подключиться
Напишите своему менеджеру или в поддержку: эндпоинт, форматы и страны, которые вы покупаете, модель оплаты и спецификацию запроса и ответа.