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

​
Сайты

Выберите сайты в форме виджета или включите All my sites: тогда виджет работает на всех одобренных площадках вашего аккаунта, включая добавленные позже, без правок виджета и с одним кодом вставки для всех. Таргетинг и лимиты в обоих случаях общие для всех сайтов.

​
Раскладки

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

​
Внешний вид

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

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

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

​
Backend

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

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

У каждого креатива в серверном ответе есть поле earn_cents: сколько вы заработаете за один валидный клик по этой карточке, в центах США. По нему удобно выбирать и сортировать карточки по выплате. Поле приходит только по запросам с API-ключом, браузерный виджет его не получает. Клик оплачивается этой суммой после валидации: дубли, подозрительные клики и клики мимо first-party канала не оплачиваются. В серверном ответе есть и creative_id, постоянный публичный id креатива (click_token живёт недолго и может повторяться в нескольких ответах). Если вы кешируете ответы по странице, по нему прячьте карточки, по которым посетитель уже кликал за последние 24 часа; при переданном в запросе uip мы делаем это сами. Страница Типы подключения описывает полный путь клика: resolve-запрос с обязательными и опциональными полями, формат ответа и примеры relay.