Skip to main content
Виджет определяет, как карточки моделей выглядят и ведут себя на ваших страницах. Каждый виджет принадлежит одной площадке и работает только на её доменах.

​
Раскладки

Для Custom HTML есть галерея шаблонов (Classic, Dark, Minimal, Wide banner), чтобы не писать разметку с нуля.

​
Внешний вид

У виджета есть тема (Light, Dark или Auto по системной теме посетителя), плотность (Comfortable или Compact) и опциональная кнопка Show more: вы выбираете, сколько карточек видно сразу, остальные подгружаются порциями по клику. Форма показывает живой предпросмотр каждой комбинации до сохранения.

​
Вставка на сайт

Скопируйте сниппет из формы виджета и вставьте туда, где должны появиться карточки. Настройки внешнего вида зашиты в сниппет data-атрибутами: после изменения настроек форма даёт обновлённый сниппет, а сам виджет подхватывает сохранённые изменения при следующей загрузке страницы. Показ засчитывается только когда карточка реально видна во вьюпорте, а настройка частоты ограничивает, сколько раз один посетитель видит одну и ту же модель за 24 часа.

​
Backend + First-party

Если нужен полный контроль над разметкой или страницы рендерятся на сервере, запрашивайте рекламу со своего бэкенда по API-ключу виджета и стройте собственный HTML. С каждым запросом передавайте контекст посетителя: IP, user agent и URL просматриваемой страницы (именно URL страницы наполняет ваш отчёт By page). Клик-ссылки на странице ведут на ваш собственный домен: ваш сервер резолвит каждый клик через наш API и сам редиректит посетителя, поэтому на странице не остаётся ни одной внешней рекламной ссылки. Это важно для страниц, которые ранжируются в поиске, и для площадок, страдающих от блокировщиков. В форме виджета есть готовые примеры для Node и PHP (рендер страницы плюс небольшой relay-эндпоинт), скрипт для показов и промпт, который можно отдать ИИ-ассистенту, чтобы он собрал интеграцию под ваш стек. Три важных правила:
  1. Ссылайте карточки на собственный relay-роут. У каждого креатива есть click_token для вашей клик-ссылки и готовый URL показа; URL показа используйте как есть. Ответ виджета можно кешировать по странице до 30 минут; resolve-вызов выполняется на каждый клик и не кешируется никогда.
  2. Отправляйте только viewable-показы. Фиксируйте показ, когда карточка видна хотя бы наполовину около секунды. Приложенный скрипт делает это через IntersectionObserver, скопировать его - самый простой способ не ошибиться.
  3. Не срезайте referrer на своих клик-ссылках. Никаких rel="noreferrer" и политики no-referrer на них: иначе вашему relay неоткуда взять URL страницы для uref, а клики без uref получают предупреждение и ослабляют фрод-фильтры для вашего трафика. Дефолтной политики браузера достаточно.
Точные показы важны не только для статистики: на них работает ограничение частоты и подбор кампаний под вашу площадку.

​
Ваша цена за клик

У каждого креатива в серверном ответе есть поле earn_cents: сколько вы заработаете за один валидный клик по этой карточке, в центах США. По нему удобно выбирать и сортировать карточки по выплате. Поле приходит только по запросам с API-ключом, браузерный виджет его не получает. Клик оплачивается этой суммой после валидации: дубли, подозрительные клики и клики мимо first-party канала не оплачиваются. Страница Типы подключения описывает полный путь клика: resolve-запрос с обязательными и опциональными полями, формат ответа и примеры relay.