Skip to content

Интеграция 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, если у формата он есть
Сигналы TelegramPremium, мотивированный трафик, подключённый 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 попандер ​

Запрос:

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"]
}

Ответ:

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"
    }]
  }]
}

Для попандера в adm передаётся URL, который откроется в новой вкладке.

Как подключиться ​

Напишите своему менеджеру или в поддержку: эндпоинт, форматы и страны, которые вы покупаете, модель оплаты и спецификацию запроса и ответа.