> ## Documentation Index
> Fetch the complete documentation index at: https://onlytraffic.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Виджеты

> Раскладки, темы, сниппет для вставки, свои шаблоны и Backend (S2S) API с viewable-показами.

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

## Раскладки

| Режим           | Что делает                                                                |
| --------------- | ------------------------------------------------------------------------- |
| Responsive grid | Карточки заполняют ширину контейнера, количество подстраивается под экран |
| Single row      | Один горизонтальный ряд карточек                                          |
| Carousel        | Автопрокручиваемая лента                                                  |
| Custom HTML     | Ваша собственная разметка карточки с плейсхолдерами, рендерит наш скрипт  |
| Backend (S2S)   | Вообще без скрипта: ваш сервер сам запрашивает и рендерит рекламу         |

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

## Внешний вид

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

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

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

Показ засчитывается только когда карточка реально видна во вьюпорте, а настройка частоты ограничивает, сколько раз один посетитель видит одну и ту же модель за 24 часа.

## Backend (S2S)

Если нужен полный контроль над разметкой или страницы рендерятся на сервере, запрашивайте рекламу со своего бэкенда по API-ключу виджета и стройте собственный HTML. В форме виджета есть готовые примеры для Node и PHP, небольшой скрипт для показов и промпт, который можно отдать ИИ-ассистенту, чтобы он собрал интеграцию под ваш стек.

Для S2S важны два правила:

1. **Используйте полученные URL как есть.** У каждого креатива свои ссылки клика и показа: не переписывайте их и не кешируйте между просмотрами страницы.
2. **Отправляйте только viewable-показы.** Фиксируйте показ, когда карточка видна хотя бы наполовину около секунды. Приложенный скрипт делает это через IntersectionObserver, скопировать его - самый простой способ не ошибиться.

Точные показы важны не только для статистики: на них работает ограничение частоты и подбор кампаний под вашу площадку.