Публикация и сайт
Виджет квиза на сайт
Как вставить квиз на сайт: виджет в углу страницы или блок на лендинге
Обновлено 2026-09-03
Чтобы вставить квиз на сайт, скопируйте готовый код из конструктора после публикации. Есть два варианта: плавающая кнопка-виджет в углу экрана и квиз прямо в блоке страницы. Заявки в обоих случаях попадают в кабинет.
Как вставить квиз на сайт
- Опубликуйте квиз в кабинете.
- Скопируйте код —
widget.js(кнопка) илиembed.js(блок на странице). - Вставьте скрипт в HTML сайта. В CMS обычно нужен блок «HTML» или Custom code.
- Откройте тестовую страницу, пройдите квиз до формы и проверьте, что лид появился в разделе «Лиды».
Код в конструкторе генерируется автоматически: подставляются public id, цвет темы и текст кнопки.
Плавающая кнопка (widget.js)
Кнопка в углу экрана открывает квиз в модальном окне — удобно, если не хотите менять вёрстку сайта.
<script src="https://quizai.pro/widget.js"
data-quiz="ВАШ_PUBLIC_ID"
data-color="#5cb85c"
data-label="Подбор квартиры"
data-delay="500"
async>
</script>
Настройки кнопки в конструкторе
| Параметр | Описание |
|---|---|
| Заголовок | Действие, например «Запросите расчёт». Пусто — заголовок стартового экрана (если стартовый экран выключен — название квиза) |
| Подзаголовок | Выгода, например «Получите скидку 5%». Пусто — бейдж стартового экрана, а без него кнопка в одну строку |
| Задержка появления кнопки | 0–300 секунд (0 = сразу, по умолчанию 0,5 с) |
| Автооткрытие | Через сколько секунд квиз откроется сам, 0–600 (0 = не открывать) |
| Цвет | Из темы квиза |
С подзаголовком кнопка в две строки: сверху мелко заголовок, ниже крупно подзаголовок. Такой формат «действие + выгода» обычно лучше конвертирует, чем одна строка.
Автооткрытие срабатывает один раз за визит и только если посетитель сам не открыл квиз и не скрыл кнопку крестиком. Код вставляется на сайт один раз. При загрузке страницы кнопка сама берёт тексты, цвет, задержку и автооткрытие из опубликованного квиза, поэтому после изменения настроек достаточно обновить публикацию: кнопка на сайте поменяется в течение минуты. Атрибуты data-label, data-sublabel, data-color, data-delay и data-auto-open в коде нужны только на случай, если сервис недоступен. Если снять квиз с публикации, кнопка на сайте пропадёт.
Дополнительные атрибуты (вручную в коде)
| Атрибут | Значения |
|---|---|
data-position |
bottom-left (по умолчанию), bottom-right |
data-offset |
Отступ от края в px (по умолчанию 24) |
Поведение виджета
- Закрытие по ×, Escape или клику вне окна.
- На мобильных при длинном квизе — скролл внутри окна.
- Крестик на самой кнопке скрывает её до конца сессии (вкладки).
- Анимация появления; при
prefers-reduced-motion— без анимации.
Квиз внутри страницы (embed.js)
Квиз встраивается прямо в страницу — iframe сразу после скрипта. Подходит для лендингов, где опрос — основной блок.
<script src="https://quizai.pro/embed.js" data-quiz="ВАШ_PUBLIC_ID"></script>
Особенности:
- Высота iframe подстраивается автоматически под содержимое.
- Квиз открывается с параметром
?embed=1(упрощённая оболочка без лишних элементов).
Цели в Яндекс Метрике сайта
Квиз может отправлять цели в счётчик Метрики того сайта, на котором стоит. Работает и с кнопкой, и с блоком; код вставки менять не нужно.
- В конструкторе откройте раздел «Цели Метрики» и укажите номер счётчика.
- Проверьте идентификаторы целей. По умолчанию:
quizai_start— посетитель нажал кнопку на стартовом экране или ответил на первый вопрос;quizai_submit— заявка отправлена и сохранена.
- В Метрике создайте цели типа «JavaScript-событие» с теми же идентификаторами.
- Обновите публикацию квиза.
Каждая цель отправляется один раз за прохождение. По прямой ссылке на квиз цели не отправляются: на странице quizai.pro нет счётчика вашего сайта.
Переход с другого конструктора. Если реклама в Директе оптимизируется по цели старого квиза, впишите идентификатор этой цели в поле «Цель «отправил заявку»». Цель продолжит срабатывать, и статистика по ней не прервётся.
Для своих скриптов на странице появляются события quizai:start и quizai:submit, в event.detail.quizId — public id квиза. Данные посетителя в события не передаются.
Какой способ выбрать
| Сценарий | Рекомендация |
|---|---|
| Квиз дополняет существующий сайт | widget.js |
| Не хотите менять вёрстку страницы | widget.js |
| Квиз — главный блок лендинга | embed.js |
Требования
- Квиз должен быть опубликован.
- Сайт должен позволять подключение внешнего
<script>(некоторые CMS — через блок HTML/Custom code).
Проверка
- Вставьте код на тестовую страницу.
- Пройдите квиз до отправки формы.
- Убедитесь, что лид появился в кабинете.