Проекты

Установка скрипта

Раздел «Скрипт» в Kvality: автоматический и ручной режим (LeadTracker.sendForm), куда вставить код, строгий режим, доверенные iframe для квизов Марквиза, проверка установки.

В разделе «Скрипт» настраивают и устанавливают скрипт на сайт. Вверху — данные проекта: ID счётчика Яндекс Метрики, OAuth-токен (кнопка «Получить токен»), адрес сайта (кнопка «Проверить установку»), переключатель «Строгий режим», блок «Доверенные iframe» и сам код скрипта.

Раздел «Скрипт», режим «Автоматически»

Режим скрипта

В блоке «Скрипт» справа есть список с двумя режимами — код меняется вместе с режимом.

  • Автоматически — достаточно одной строки <script src="https://kvality.io/tracker.js" data-api-key="…">. Скрипт сам находит формы на сайте.
  • Вручную — скрипт сам формы не ловит, заявку передаёте вы: вызовите LeadTracker.sendForm(), когда форма успешно отправлена. Подходит для SPA-приложений и нестандартных форм.

Режим «Вручную»

Скопировать код можно иконкой слева от списка режимов.

Пример ручной отправки

  1. Вставьте скрипт из кабинета в <head> сайта. В режиме «Вручную» в нём есть data-disable-auto-detect="true" — это и отключает автоматический захват форм.
<head>
  <script src="https://kvality.io/tracker.js" data-api-key="ВАШ_КЛЮЧ" data-disable-auto-detect="true"></script>
</head>
  1. В обработчике отправки формы, после того как заявка ушла к вам, передайте её в Kvality: имя, телефон и другие поля формы.
<form id="callback-form">
  <input name="name" placeholder="Имя" />
  <input name="phone" placeholder="Телефон" />
  <button type="submit">Отправить</button>
</form>

<script>
  document.getElementById('callback-form').addEventListener('submit', async (event) => {
    event.preventDefault();
    const form = event.target;

    // ваша отправка заявки — в CRM, на почту и т. п.
    await fetch('/api/callback', { method: 'POST', body: new FormData(form) });

    // передаём ту же заявку в Kvality
    LeadTracker.sendForm({
      name: form.elements.name.value,
      phone: form.elements.phone.value
    });
  });
</script>

Куда вставить код

Разместите скрипт ближе к началу страницы — например, внутри тегов <head></head> или <body></body>.

<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <title>Мой сайт</title>
    <!-- Kvality: код из раздела «Скрипт», без изменений -->
    <script src="https://kvality.io/tracker.js" data-api-key="ВАШ_КЛЮЧ"></script>
  </head>
  <body>
    <!-- содержимое сайта и формы -->
  </body>
</html>

На конструкторах (Tilda, WordPress и др.) код вставляют в настройках сайта — в блок для своего кода в <head>.

Вставляйте код целиком

data-api-key — уникальный ключ вашего проекта. Не удаляйте его из кода и не публикуйте отдельно.

Строгий режим

«Заявки только с этого адреса и пути». Включите, если заявки нужно принимать только с определённой страницы, а не со всего домена. Например, если в адресе проекта указан путь /filial, Kvality будет принимать заявки только с этой страницы, а остальные страницы домена не тронет.

Строгий режим

Доверенные iframe

Для квизов и виджетов, встроенных с других доменов. Нажмите «Добавить адрес», вставьте адрес страницы квиза и нажмите «Сохранить». Адрес можно посмотреть (иконка глаза) или удалить крестиком. Заявки из квиза запишутся в общую сессию с основным сайтом.

Доверенные iframe

Один и тот же код — на сайт и в квиз

Если на сайте, например, квиз Марквиза, тот же самый код ставится и на сайт, и в настройки квиза. А адрес квиза добавляется в «Доверенные iframe».

Как это сделать на Марквизе:

  1. Скопируйте код из раздела «Скрипт» целиком, вместе с ключом.
  2. Вставьте его на сайт, как описано выше.
  3. В кабинете Марквиза откройте редактирование квиза, вкладку «Интеграции» и выберите «Свой код».
  4. Вставьте туда тот же код и сохраните квиз.
  5. В Kvality в разделе «Скрипт» → «Доверенные iframe» нажмите «Добавить адрес», вставьте адрес квиза и нажмите «Сохранить».

Подробнее о своём коде в квизе — в справке Марквиза.

Проверка установки

Когда скрипт стоит на сайте, нажмите «Проверить установку» рядом с адресом сайта. Что означает каждый ответ и как исправить ошибку — на странице «Проверка установки».

Что дальше

Остались вопросы?

Напишите в поддержку: @kval_support.

On this page