Как передавать данные о подписке в Mindbox?


Есть 3 основных варианта передачи данных с форм в Mindbox:

1) Передача Действия в карточку клиента в Mindbox на просмотр или клик по форме
- используется для форм, которые показываются по сегменту

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

- настраивается по этой инструкции
2) Дополнение данных клиента после заполнения ним опроса, дополнительных данных
- используется для форм, где НЕ собираются контактные данные (email, номер телефона)

- настраивается по этой инструкции
3) Создание новой карточки клиента в Mindbox после заполнения формы на сайте
- используется для всех форм подписки, регистрации

- настраивается одним из нижеуказанных в этой статье способов

ЭТАПЫ НАСТРОЙКИ ИНТЕГРАЦИИ ДЛЯ ПЕРЕДАЧИ КОНТАКТОВ
1) Создайте Операцию в Mindbox

Перейдите в Кампании - Нужная кампания - Добавить операцию:
Запомните или скопируйте системное имя - вам нужно будет оно на следующих этапах настройки
2) Выберите тип интеграции для настройки - серверную или JS

Глобально между ними нет разницы: данные отправляются с одинаковой скоростью.
Но есть разница в нюансах настройки этих интеграций и в том, откуда отправляются данные - с фронтенда или бекенда.
Вариант 1.
Серверная интеграция с Mindbox
- выполняется на бекенде
- может как обновлять данные подписчика, так и создавать его
- имеет ограниченную структуру для передачи данных

Для настройки необходимо знать:
- ID операции в Mindbox
- Endpoint
- Ключ API от этой точки интеграции



Вариант 2.
JS-интеграция
- выполняется на фронтенде
- не может обновлять данные подписчика, только создавать его
- можно передавать абсолютно любые данные

Для настройки необходимо знать:
- ID операции в Mindbox
- Endpoint

3) Настройка серверной интеграции для формы (если выбрали этот вариант)

Откройте личный кабинет Popmechanic – Выберите форму, данные с которой нужно передавать
– Подведите курсор мыши к ней – Интеграции – Mindbox (серверная):
Разберем, что нужно заполнять в каждом из полей интеграции:
Где взять API-ключ точки интеграции?
Меню Интеграции - Интеграции - выбираете точку - Редактировать - Копируйте Секретный сервисный ключ (не правьте его!)
У вас может не быть доступа к этому разделу.
В таком случае обратитесь к ведущему менеджеру Mindbox, который сможет дать вам ключ или доступ
Сохраните интеграцию. Проверьте её, включив тестовый показ формы.
4) Настройка JS-интеграции для формы (если выбрали этот вариант)

Откройте личный кабинет Popmechanic – Выберите форму, данные с которой нужно передавать
– Подведите курсор мыши к ней – Интеграции – JS-код:
Где найти интеграцию JS-код для вызова операции
Вам нужно вставить код в окошко "Код при отправке контактов"
Откройте в соседней вкладке Операцию в Mindbox, которую вы создали на предыдущих шагах.
Нажмите – Посмотреть описание операции – Спецификация Javascript SDK (async):

Копируйте запрос с этого описания.
Где взять код для вставки в JS-интеграцию
Откройте в соседней вкладке Операцию в Mindbox, которую вы создали на предыдущих шагах.
Нажмите – Посмотреть описание операции – Спецификация Javascript SDK (async):

Копируйте запрос с этого описания.

Вставьте этот запрос в окошко "Код при отправке контактов" JS-интеграции в настройках формы Popmechanic.
Удалите из запроса лишние поля, обращая внимание на обязательность некоторых полей.

ЗАМЕНИТЕ В КОДЕ ЗНАЧЕНИЯ ПЕРЕМЕННЫМИ:

  • %phone% - телефон
  • %email% - email
  • %first_name% - имя
  • %last_name% - фамилия
  • %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
В коде можно также использовать переменные для передачи значений доп. полей Popmechanic формата %customs.gender%
Где gender - название переменной.
А customs. - всегда передается для дополнительных полей.

Детальнее о дополнительных полях
Как подставить данные в код
Сохраните интеграцию. Проверьте её, включив тестовый показ формы.

Вам была полезна эта статья?