Typeform размещён на домене Typeform, даже когда встроен в вашу страницу. Cookie, выставленную на вашем сайте, там прочитать нельзя, поэтому обычная передача через cookie из подключения сайта здесь не работает. Идентификатор посетителя приходится передавать параметром ссылки.
Это делают две настройки: свой параметр в форме и одна строка, убранная из кода вставки.
Настройка в КО
- В разделе Коннекты откройте категорию Сайты, квизы, лидформы, чаты и выберите Сайт: трекинг и события.
- В блоке Подключение укажите платформу Typeform и опишите интеграцию.
- Держите открытыми HTML код и Вебхук / Webhook — оба понадобятся ниже.
Установка счётчика КО
Установите HTML-код на сайт, в который встроена форма: внутри <head> или через диспетчер
тегов. Счётчик должен работать на вашей странице, а не внутри формы: именно на вашей
странице известно, откуда пришёл посетитель.
Параметры в Typeform
- В Typeform выберите созданную форму.
- Перейдите в раздел Logic.
- Откройте на редактирование первый блок Pull data in.
- Добавьте Custom URL parameter с названием
ko_touch_id. КО заполняет этот параметр на вашей странице, а Typeform передаёт значение дальше, в отправленную заявку. - Не обязательно: включите параметры
utm_*в группе Source tracking — тогда они будут видны у заявки в самом Typeform, что удобно при проверке. - Сохраните изменения.
Добавление вебхука
- В Typeform перейдите в раздел Connect, вкладка Webhooks.
- Нажмите Add a webhook, вставьте ссылку вебхука из коннекта КО и сохраните.
- Переключите вебхук в положение Webhook ON.
Вставка Typeform в код сайта
Typeform предлагает код вставки такого вида:
<div data-tf-live="XXXXX"></div><script src="//embed.typeform.com/next/embed.js"></script>Используйте только первую часть — уберите тег <script>:
<div data-tf-live="XXXXX"></div>Форму загрузит сам КО и добавит к ней ko_touch_id и UTM-метки. Если оставить загрузчик
Typeform, форма встроится раньше, чем эти параметры будут добавлены, и каждая заявка придёт
без источника.
Завершение настройки
Когда настроите все опции, переключите статус интеграции в КО на Активен:
- Активен — всё функционирует.
- Настройка — всё функционирует, но обновление данных на паузе.
- В архиве — отключает интеграцию, сохраняет данные и статистику.
- Удалить — удаляет все данные и статистику интеграции.
Проверка
Откройте страницу с формой и отправьте заявку сами.
В настройках коннекта нажмите Перезагрузить данные: ваш визит должен появиться в таблице Последние визиты, а заявка — в Последние заявки, с источником.
Если не сходится
Заявки приходят без источника — проверьте код вставки. Строка со <script> — обычная
причина: после редизайна фрагмент легко вставить обратно целиком.
Проверьте имя параметра. Оно ровно ko_touch_id, в блоке Pull data in формы.
Проверьте, что счётчик стоит на странице с формой, а не только на главной.