Виджеты для вашего сайта
На всех тарифах, начиная с Free, владелец может установить на свой сайт два виджета: информер учтённых переходов и QR с короткой ссылкой и контактами. Виджеты не добавляют cookies и не используют хранилище браузера.
Где найти
Кабинет → Подключения → Виджеты для сайта. Прямой адрес: /agency/widgets.
Создайте и установите виджет
- Откройте «Виджеты для сайта» от имени владельца и выберите инструмент.
- На вкладке «Содержание и ссылки» выберите обычные активные ссылки и кнопки площадок. Для новых ссылок действуют обычные квоты агентства.
- На вкладке «Установка» укажите разрешённые HTTPS-сайты без пути, каждый с новой строки. www и домен без www добавляются отдельно.
- Сохраните черновик и нажмите «Опубликовать». Подтвердите, что выбранные адреса и число переходов можно показывать публично.
- Создайте отдельный ключ виджетов в списке. Вернитесь в редактор, скопируйте код и вставьте его в HTML-блок сайта.
Ключ виден в исходном коде сайта. Это публикуемый ключ только для виджетов, а не секретный ключ Enterprise REST API. Пароли, сессию кабинета и Integration API key в код вставлять нельзя.
Соберите виджет на холсте
На вкладке «Конструктор» перетаскивайте блоки за значок ⠿. Клавиатурой: сфокусируйте значок, нажмите пробел, выберите позицию стрелками и снова нажмите пробел; Escape отменяет перенос. У выбранного блока есть кнопки «Выше» и «Ниже».
Цветовая палитра меняет оформление сразу. Пипетка берёт цвет с экрана в поддерживаемом браузере через HTTPS; обычный выбор цвета доступен и без неё. Светлая и тёмная палитры настраиваются отдельно. Ползунки меняют скругление панели и кнопок, переключатель — форму плавающего значка. Дополнительные настройки цвета, формы и QR раскрываются отдельно.
Выберите блок на холсте или в списке «Настройка блока»: доступны жирный текст, курсив, подчёркивание, размер и выравнивание слева, по центру или справа. «+ Свой текст» добавляет до255 символов с переносами строк. У кнопок площадок можно выбрать горизонтальный ряд с переносом или вертикальный список и компактный либо обычный размер. Предпросмотр показывает демонстрационное число 1 420. Установленный информер использует реальные данные выбранной ссылки. Архивирование и снятие с публикации доступны в меню «Ещё». Сохранение черновика не меняет опубликованный виджет: для этого нажмите «Опубликовать». Обязательная подпись находится вне перетаскиваемых блоков.
Сайты, CSP и ключи
Если на сайте включена CSP, разрешите script-src и style-src https://bstat.ru, frame-src https://bstat.ru. Сам информер работает внутри отдельного iframe; стили сайта и кабинета не смешиваются.
Внешний виджет не читает cookies, localStorage/sessionStorage или содержимое страницы. Сетевые запросы всё равно передают обычные HTTP-заголовки и наблюдаемый IP серверу; настоящий переход по короткой ссылке обрабатывается обычной аналитикой.
При замене ключа можно оставить предыдущий на 24 часа. За это время обновите код на сайтах. Отзыв сразу отключает текущие и предыдущие ключи, но не удаляет ссылки или настройки.
QR текущей страницы и SPA
Для каждой публичной страницы заранее выберите короткую ссылку и её случайный код привязки. Цель должна быть HTTPS-адресом разрешённого сайта без query и fragment. Выберите эту страницу при копировании embed-кода.
В SPA автоматическое определение страницы по URL не выполняется. На старте навигации вызовите window.BStatWidgets.update(element, {pageId: null}), после рендера — update(element, {pageId: опубликованныйКодСтраницы}). Back/Forward должны вызывать тот же hook. Если кода нет, остаются только фиксированные контакты.
Для нового HTML-контейнера вызовите mount(element), при удалении — destroy(element). update принимает также theme: light, dark или auto. Старый QR очищается до загрузки новой привязки; поздний ответ прежней страницы не возвращает его.
Тарифы и исчерпание лимитов
На Free, Basic и Pro видна ссылка «Сделано в bstat.ru». Enterprise может отключить её в настройках и опубликовать изменение. После перехода с Enterprise подпись возвращается автоматически.
Переходы из виджета расходуют общую месячную квоту аналитики агентства. Показ панели, QR-картинка, копирование и обновление счётчика переходами не считаются. При исчерпании ссылки и QR продолжают открываться, кабинет остаётся доступен, а новые сверхлимитные события не записываются в статистику.
После увеличения квоты выше текущего расхода или в следующем UTC-месяце учитываются новые события. Простого пополнения баланса недостаточно. Ранее пропущенные события не восстанавливаются; информер отмечает неполноту выбранного периода.