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

​
Раскладки

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

​
Внешний вид

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

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

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

​
Backend (S2S)

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

​
Backend + First-party

Тот же серверный запрос, что и в S2S, но клик-ссылки на странице ведут на ваш собственный домен: ваш сервер резолвит каждый клик через наш API и сам редиректит посетителя. На странице не остаётся ни одной внешней рекламной ссылки, что важно для страниц, которые ранжируются в поиске, и для площадок, страдающих от блокировщиков. С вашей стороны нужен один дополнительный элемент, небольшой relay-эндпоинт (готовый код есть в форме виджета). Страница Типы подключения сравнивает все три режима и описывает resolve-запрос: обязательные и опциональные поля, формат ответа и примеры relay.