Как передать данные из формы на проект
  • 19 Jul 2022
  • 2 минуты
  • Темная тема
    Светлая тема
  • формат pdf

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

  • Темная тема
    Светлая тема
  • формат pdf

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

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

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

Поля ввода

Базовые поля

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

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

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

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

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

Не поддерживается заполнение дополнительных полей с множественными значениями.

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

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

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

Снимок экрана 2022-07-07 в 17.52.39.png

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

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

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

Базовые шаги

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

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

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

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

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

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

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

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

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

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

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

Понадобится имя поля из формы, если вы используете стандартные шаги, системное имя — при использовании пользовательского 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:

Снимок экрана 2022-07-07 в 19.41.46.png

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

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

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

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

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

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

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

Снимок экрана 2022-07-12 в 14.49.50.png
У блока есть свои дополнительные поля для сбора оценки и комментария.

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

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

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

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


Была ли эта статья полезной?