Перейти к основному содержанию
Есть три способа показывать карточки моделей. Отличаются они тем, кто рендерит карточки и куда ведёт клик-ссылка на вашей странице.
WidgetBackend + First-partyBackend (S2S)
Карточки рендеритнаш скрипт, в браузереваш серверваш сервер
Клик-ссылка на страниценаш трекинг-доменваш собственный доменнаш трекинг-домен
Клик резолвитбраузер посетителяваш сервер через resolve APIбраузер посетителя
Внешние рекламные ссылки в HTMLестьнетесть
Подключениевставить сниппетзапрос к API + небольшой relay-эндпоинтзапрос к API
Кому подходитобычные страницы, быстрый стартстраницы, которые ранжируются в поиске; площадки, чувствительные к блокировщикамсерверный рендеринг, когда профиль ссылок не важен

Widget

Вставьте один сниппет там, где должны появиться карточки; рендеринг, показы и клики обрабатываются автоматически. Раскладки, темы и свои шаблоны описаны в разделе Виджеты.

Backend (S2S)

Ваш сервер запрашивает креативы как JSON по API-ключу виджета и строит собственный HTML. Карточки ссылаются на готовые трекинг-ссылки из ответа. Правила и примеры: Виджеты, Backend (S2S).

Backend + First-party

Серверный рендеринг как в S2S, плюс first-party клик-ссылки: каждая ссылка на странице остаётся на вашем домене, а ваш сервер резолвит каждый клик через наш API и сам редиректит посетителя. Зачем выбирать этот тип:
  • Чистый профиль ссылок. В вашем HTML нет внешних рекламных ссылок, поэтому у ранжирующихся страниц нет футпринта рекламной сети.
  • Блокировщики не режут путь клика. Ссылку на собственный домен нельзя заблокировать, не сломав сам сайт.
  • Referrer под вашим контролем. URL страницы передаётся в resolve-запросе явно, а на финальном редиректе вы сами решаете, что увидит сайт назначения: заголовок Referrer-Policy: no-referrer полностью скрывает ваш домен.
Каждый клик по-прежнему проходит через OnlyTraffic: токен в каждой карточке выдаём мы, и клик засчитывается (и оплачивается) только после того, как ваш сервер его отрезолвил.

Как это работает

1

Запросите креативы

Тот же запрос, что и в Backend (S2S): вызовите эндпоинт виджета со своего сервера с заголовком X-Api-Key, передавая uip, uua и page посетителя.
2

Отрендерите first-party ссылки

У каждого креатива есть click_token. Ссылайте карточку на собственный роут, например https://yoursite.com/go?t=<click_token>. Не используйте click_url в этом режиме; пиксель показа (impression_url) работает так же, как в S2S.
3

Отрезолвьте клик

Когда посетитель кликает по вашей ссылке, вызовите resolve-эндпоинт сервер-к-серверу:
4

Сделайте редирект

В ответе придёт URL назначения. Ответьте посетителю 302 Location: <url>. По желанию добавьте Referrer-Policy: no-referrer, чтобы сайт назначения не видел ваш домен.

Что передавать при каждом резолве

ПолеОбязательноЧто это
tдаclick_token из креатива
Заголовок X-Api-KeyдаAPI-ключ виджета; подтверждает, что запрос идёт с вашего сервера
uipдаIP-адрес посетителя
uuaдаUser-Agent посетителя
urefдаURL страницы, на которой произошёл клик
asnнетASN сети посетителя. На Cloudflare выведите ip.src.asnum через Transform Rule и передавайте его
countryнетISO2-переопределение; обычно страна определяется по uip
Заголовок X-OT-Bot-ScoreнетBot score от Cloudflare, если доступен на вашем тарифе
Заголовок X-OT-Verified-BotнетФлаг verified-bot от Cloudflare (1 или true)
uip, uua и uref должны описывать запрос посетителя к вашему сайту, а не ваш сервер. Валидация кликов, гео-статистика и уникальность считаются по тому, что вы передали; клики с отсутствующим или подделанным контекстом помечаются и не оплачиваются. Опциональные поля включают дополнительные фильтры антифрода: чем больше вы передаёте, тем привлекательнее ваша площадка для рекламодателей.
Вызывайте resolve-эндпоинт только со своего сервера, на каждый клик, и никогда не кешируйте ответ. Один токен резолвится в один оплачиваемый клик; повторы редиректят, но не оплачиваются.

Ответ

  • url: куда редиректить посетителя. Для живого токена присутствует всегда. null означает, что токен истёк: отправьте посетителя на собственную страницу.
  • billable: прошёл ли клик валидацию и засчитан ли в заработок. Только для диагностики; редиректить нужно в любом случае.
  • reason: почему клик не оплачен. Частые значения: duplicate (токен уже отрезолвлен), not_unique (тот же посетитель и та же модель в окне уникальности), stale_token, бот-маркеры. ref_not_forwarded это предупреждение: клик оплачен, но uref был пуст, интеграцию стоит поправить.

Пример relay-эндпоинта

Путь роута (здесь /go) выбираете вы.
uref обычно берётся из заголовка Referer клика по ссылке того же домена. Если на сайте стоит глобальная политика no-referrer, добавляйте URL страницы к своим клик-ссылкам сами (например /go?t=...&p=<URL страницы>) и передавайте это значение как uref. В форме виджета есть полные примеры для копирования (рендер страницы плюс relay) и готовый промпт для ИИ-ассистента.

Какой тип выбрать

  • Страница ранжируется в поиске или важен чистый профиль исходящих ссылок: Backend + First-party.
  • Рендерите на сервере и нужен самый быстрый бэкенд-вариант: Backend (S2S).
  • Всё остальное: Widget.