Как передать данные из формы на проект

Попапы и встроенные формы позволяют собирать данные по клиентам. В данной статье научимся настраивать их передачу в Mindbox.

Заполняем шаблон

Нужно учитывать, что некоторые поля клиента принимают значения только в определенном формате. Например, целочисленное поле принимает только числа, а логическое поле — значения 1/0, true/false, да/нет. Поэтому важно выбрать правильный тип поля ввода и указать подходящие значения при передаче данных.

Поля ввода

Базовые поля

Имеют установленные системные имена:

• email — email
• имя — name
• мобильный — phone

Другие типы полей ввода

Системное имя задается самостоятельно.

• строка / дата / число — записывается переданное значение.
• выпадающий список — нужно указать все варианты в «Значения списка».
• кнопка с двумя вариантами выбора. Передаются данные из «Значения левой/правой кнопки при передаче данных» выбранного варианта.
• чекбокс. Передается 1 при заполенном чекбоксе, 0 — при незаполненном.

Дополнительные поля шаблона

В части шаблонов есть дополнительные поля. Они содержат данные по выбору клиента в форме. Например, выпавший приз в колесе фортуны, оставленный комментарий в форме или оценка.

Их можно посмотреть в соответствующем разделе шаблона:

Также можно создавать свои дополнительные поля, объединять в них другие переменные и задавать значения по умолчанию.

Выбираем способ передачи данных

Настраивается в разделе «Действие после заполнения формы».

Базовые шаги

• не нужно создавать операции;
• простая настройка.

Создание клиента:

• Доступные поля по клиенту: имя, фамилия, отчество, ФИО, email, мобильный номер, пол, дата рождения, зона, дополнительные поля (кроме полей с множественными значениями), подписка.
• Не включает настройки по доступу к аккаунту и подтверждению контактов.
• Обязательная передача подписки.

Редактирование клиента:

• Доступные поля по клиенту: пол и публичные дополнительные поля.

Выдача действия:

• Доступные поля: действие и дополнительные поля по действию.

Дополнительные шаги

Вызывать пользовательский JS:

• нужно заранее создать операцию, зато можно настроить шаги по задаче;
• нужно самостоятельно вписать вызов операции.

Заполняем настройки формы

При использовании базовых шагов

Заполняем настройки:

• Поле в Mindbox — в какое поле в Mindbox вписываем данные.
• Поле формы — откуда из формы забираем данные для записи (имя поля).

Помимо полей ввода, из всех форм можно передать данные:

• UTM-метки (source, medium, campaign, term, content);
• URL, на котором был получен лид;
• Домен, на котором был получен лид;
• Название формы, из которой был создан лид;
• Город, ID города в базе GeoNames, страна пользователя;
• Дата, дата и время создания в формате ISO.

При использовании JS

В вызове обрамляем системное имя параметра знаками процента.

Базовые поля

%email% — email
%phone% — телефон
%name% — имя
%id% — ID лида (число)
%url% — URL, на котором был получен лид
%domain% — домен, на котором был получен лид
%form_name% — название формы, которой был собран лид
%utm_source% — UTM source текущей сессии
%utm_medium% — UTM medium текущей сессии
%utm_campaign% — UTM campaign текущей сессии
%utm_term% — UTM term текущей сессии
%utm_content% — UTM content текущей сессии
%geo_city_ru% — город пользователя по-русски
%geo_city_en% — город пользователя по-английски
%geo_country_ru% — страна пользователя по-русски
%geo_country_en% — страна пользователя по-английски
%geo_geoname_id% — ID города пользователя в базе GeoNames
%created_date% — Дата создания в формате ISO (YYYY-MM-DD)
%created_time% — Дата и время создания в формате ISO (YYYY-MM-DDTHH:mm:ssssssss+TZ)

Другие типы полей ввода

Также получают префикс customs.fields_list.:

%customs.fields_list.системное имя%

Дополнительные поля шаблона

Передаются как в форме, например: %customs.field%

Примеры

Пример 1. Попап с полями ввода

Email:

Кнопка для сбора данных по полу:

С помощью поля записываем клиентам пол, поэтому значения кнопок задаем в одном из подходящих форматов (f и m).

• Настройка при использовании базовых шагов:

В ’Поле в Mindbox’ выбираем, куда вписываем полученные данные, в ’Поле формы’ - имя поля из шаблона.

• Настройка при использовании JS:

Email — базовый параметр, а кнопка получает префикс customs.fields_list и заданное в шаблоне системное имя. Также не забываем про символы процента.
Операцию регистрации создали заранее.

Пример 2. Встроенный блок с дополнительными полями шаблона

У блока есть свои дополнительные поля для сбора оценки и комментария.

• Настройка при использовании базовых шагов:

Придумываем название шаблона.
В ’Поле в Mindbox’ выбираем, куда вписываем полученные данные, в ’Поле формы’ - имя переменной из шаблона.
Заранее создали на проекте дополнительные поля по действию для хранения данных.

• Настройка при использовании JS:

Передаем дополнительные поля из шаблона, поэтому только обрамляем параметры символами процента.
Операцию выдачи действия и шаблон для него создали заранее.