1) Какие поля считаются стандартными?

На данный момент у нас есть такие стандартные поля:
  • %email% - email
  • %phone% - телефон
  • %first_name% - имя
  • %last_name% - фамилия
  • %name% - имя + фамилия
  • %id% - ID лида в Popmechanic(число)
  • %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.mindboxDeviceUUID% = deviceUUID в Mindbox (только для интеграции с этим сервисом, появляется, когда есть код Mindbox на сайте)
Эти поля можно использовать при интеграциях без дополнительных заведений.
То есть, если вы в интеграциях любых используете конструкцию %url%, то вместо неё будет отправлен url, на котором посетитель оставил свои контакты.
Это касается всех вышеперечисленных полей.

Наши базовые шаблоны уже размечены для передачи этих данных в сервисы рассылок, вам не нужно ничего делать дополнительно.
Если вы создавали свой шаблон согласно нашим правилам верстки, то ничего делать дополнительно не нужно для передачи этих данных.


Пример использования основных данных в интеграциях:
Передача данных со значениями полей, где слева - название поле в вашем сервисе, а справа, значение, которое будет подставленно
2) Как создать собственный шаблон с кастомными полями?

Допустим, вам не подходит не один из предложенных шаблонов, вы хотите создать свой, в котором спрашивать ближайший магазин к подписчику, чтобы присылать актуальные предложения.
Или же хотите спросить подписчика дополнительно:
- категории подписки
- желаемую частоту
- размер
- любимые бренды
- пол
- дату рождения
- или другие данные, которые могут быть вам важны для сегментации

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

У нас есть 3 типа кастомных полей:

1. Поле ввода
Используется для ввода пользователем любых данных, например это может быть поле "Комментарий", "Имя питомца", "Адрес" и т. д.

Пример такого поля с его разметкой:
<textarea class="popmechanic-textarea" data-popmechanic-input="customs.message" placeholder="Ваш комментарий"></textarea>

Где "customs.message" конструкция, которую нужно добавлять к полю, чтобы записывалось значение этого поля на вкладке Лиды и было доступно для выгрузки и интеграций.

2. Выбор ОДНОГО варианта из предложенных
Это может быть выпадающий список или несколько строк с предложением выбрать одну, несколько кнопок.
Использоваться этот вариант может для полей "Пол", "Домашний питомец", "Оценка качества сервиса" и т. д.

Пример 1.
2 кнопки и нам нужно записать по какой из них кликали:

<button type="button" name="button" class="popmechanic-submit" onclick="PopMechanic.customs.action = 'Позвонить'" data-popmechanic-submit >
<Позвонте мне> </button>

<button type="button" name="button" class="popmechanic-submit popmechanic-btn-second" onclick="PopMechanic.customs.action = 'Написать'" data-popmechanic-submit> <Напишите мне> </button>


Пример 2.
2 варианта выбора и подписчику нужно выбрать один из них:

<label class="popmechanic-checkbox-block radio">
<input type="radio" name="popmechanic-radio" class="popmechanic-checkbox" onclick="PopMechanic.customs.test = '1'">
<div class="popmechanic-checkbox-check"></div>
ВАРИАНТ 1 </label>
<label class="popmechanic-checkbox-block radio">
<input type="radio" name="popmechanic-radio" class="popmechanic-checkbox" onclick="PopMechanic.customs.test = '2'">
<div class="popmechanic-checkbox-check"></div>
ВАРИАНТ 2 </label>


3. Выбор НЕСКОЛЬКИХ вариантов из предложенных
Используется, когда вы хотите спросить категории подписки, любимые бренды и т. д.

Пример: выбор из 3 брендов, где можно отметить или не отметить каждый из них:
<label class="popmechanic-checkbox">
<input type="checkbox" class="popmechanic-checkbox_hidden" data-popmechanic-input="customs.brand.Gucci" value="1">
<span class="popmechanic-checkbox_text">Gucci</span> </label>
<label class="popmechanic-checkbox">
<input type="checkbox" class="popmechanic-checkbox_hidden" data-popmechanic-input="customs.brand.Adidas" value="1">
<span class="popmechanic-checkbox_text">Adidas</span> </label>
<label class="popmechanic-checkbox">
<input type="checkbox" class="popmechanic-checkbox_hidden" data-popmechanic-input="customs.brand.Philipp Plein" value="1">
<span class="popmechanic-checkbox_text">Philipp Plein</span> </label>

На выходе вы получаете значение 1, если бренд был выбран или 0, если не выбран.
3) Как проверить корректность записи данных дополнительных полей?

1) Создайте форму на основе заранее добавленного шаблона.
2) Активируйте её на сайте (как протестировать форму)
3) Заполните её на своем сайте тестовыми данными
4) Посмотрите, какие данные приходят на вкладке Лиды - тут должны попадать при нажатии на дополнительно все поля с формы и их значения:

5) Проверьте, все ли данные появились на вкладке Лиды после заполнения формы:
Если каких-то данных после заполнения формы не хватает на вкладке Лиды, то:
- убедитесь, что все поля корректно размечены в шаблоне
- обратить в поддержку
4) Как передать данные с формы с кастомными полями?

1) Выяснить, как называется поле, чтобы его прописать в настройках интеграции.
Если вы самостоятельно верстали и загружали шаблон, то названия переменных для полей вы задавали сами.
Например, если в верстке была пометка data-popmechanic-input="customs.message"

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

2) Задать свои значения, если это нужно
В некоторых шаблонах форм в каталоге возможно сразу поменять значения для ответов на вкладке "Параметры для интеграции" при создании дизайна формы.
Например, в формах с 2 кнопками можно задать, какие значения может принимать 1 и 2 кнопка:

3) Создать дополнительные поля контакта в сервисе, куда вы хотите передавать данные с формы

Чтобы передавать любимые бренды, категории подписки или другие значения с форм вам нужно создать "место", куда эти данные можно отправлять.
Чаще всего это дополнительные поля контакта, в которые в сервисе рассылок/CRM-системе добавляются любые значения.

Мы подготовили небольшую таблицу о том, как создать доп. поля в популярных сервисах:
Если у вас возникли трудности с созданием дополнительных полей - обратитесь в поддержку сервиса, в котором вам их необходимо создать или посмотрите Базу знаний нужного сервиса.

4) Настроить интеграцию с передачей значений дополнительных полей

1. Перейдите на вкладку Интеграции – Добавить интеграцию – Нужный вам сервис
2. Введите данные для подключения к вашему аккаунту – API-ключ и/или логин-пароль от сервиса, куда нужно передать данные
3. У вас должна появится кнопка Добавить доп. поле и Группы (если они есть в сервисе), куда передавать данные
4. Выберите нужное доп. поле с выпадающего списка и задайте его значение в таком формате %customs.gender%

Где gender - название переменной, которую вы посмотрели на шаге 1.
А customs. - всегда передается для дополнительных полей.

В итоге вам будет приходить доп. поле Пол, а значение поля будет то, которое вы запомните на шаге 2

У вас могут возникнуть трудности, если вы хотите передать значения для типа поля Несколько вариантов из множества.
Потому как в некоторых сервисах рассылок есть такой тип поля, а у нас в сервисе он создается с нескольких полей со значениями 0 и 1.
Если вам нужно передать В ОДНО дополнительное поле в сервисе рассылок СПИСОК значений, то попробуйте использовать такую конструкцию:

{"Gucci": "%customs.brand.Gucci%", "Prada": "%customs.brand.Prada%", "Adidas": "%customs.brand.Adidas%"}

Где Gucci, Prada, Adidas - те значения, которые нужно передать в сервис рассылок в поле Любимый бренд
А "customs.brand.Gucci" - то название поля, которое прописано в верстке
На вкладке Лиды в данном случае будет приходить brand.Gucci = 0 или 1, в зависимости от наличия галочки у этого варианта выбора.
У разных сервисов может быть разный синтаксис для передачи данных в дополнительные поля.

Посмотрите, как выглядит запрос с помощью API для передачи дополнительных полей в ваш сервис или же напишите нам в поддержку, если возникли проблемы с этим.
Вам была полезна эта статья?