| Widget | Backend + First-party | Backend (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полностью скрывает ваш домен.
Как это работает
Запросите креативы
Тот же запрос, что и в Backend (S2S): вызовите эндпоинт виджета со своего сервера с заголовком
X-Api-Key, передавая uip, uua и page посетителя.Отрендерите first-party ссылки
У каждого креатива есть
click_token. Ссылайте карточку на собственный роут, например https://yoursite.com/go?t=<click_token>. Не используйте click_url в этом режиме; пиксель показа (impression_url) работает так же, как в S2S.Отрезолвьте клик
Когда посетитель кликает по вашей ссылке, вызовите resolve-эндпоинт сервер-к-серверу:
Что передавать при каждом резолве
| Поле | Обязательно | Что это |
|---|---|---|
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 должны описывать запрос посетителя к вашему сайту, а не ваш сервер. Валидация кликов, гео-статистика и уникальность считаются по тому, что вы передали; клики с отсутствующим или подделанным контекстом помечаются и не оплачиваются. Опциональные поля включают дополнительные фильтры антифрода: чем больше вы передаёте, тем привлекательнее ваша площадка для рекламодателей.
Ответ
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.