Как создать и настроить точку интеграции
  • 09 Feb 2022
  • 3 минуты
  • Темная тема
    Светлая тема
  • формат pdf

Как создать и настроить точку интеграции

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

Для того, чтобы начать пользоваться системой Mindbox, необходимо настроить обмен данными между Mindbox и внешней системой (сайтом, мобильным приложением, кассой и тд). Такой обмен данными называется интеграцией. Нужно создать способ идентификации каждой системы клиента (сайт, приложение и тд) в Mindbox, чтобы передавать данные. Такой уникальный способ называется точкой интеграции.

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

Если нужно интегрировать сайт, два лендинга на разных доменах, мобильное приложение и кассы в оффлайн магазинах, понадобится 5 точек интеграции.
Для каждой точки интеграции можно определить точку контакта , правила подтверждения контактов, настроить доступ к аккаунту пользователя, указать сайты, на которых установлен js-трекер Mindbox.

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

Снимок экрана 2021-11-18 в 18.36.50.png

Рассмотрим подробнее каждый блок настроек:

Снимок экрана 2021-11-18 в 18.42.27.png

Снимок экрана 2021-11-18 в 18.42.39.png

Идентификатор точки интеграции (текст "Введите идентифиактор точки интеграции") — системное имя, которое используется при вызове операций.

Для каждой точки интеграции менеджер Mindbox заводит ряд операций (регистрация на сайте, оформление заказа и тд). При совершении действия клиентом происходит вызов соответствующей операции. Например, клиент оформляет заказ → вызывается операция «Оформление заказа» → действие попадает в систему и присваивается клиенту.

Про точку интеграции:

а. Имя — название точки интеграции в удобном вам виде. Например: «Лендинг на домен.ру». Не является системным идентификатором точки. Используется в информационных целях.
b. Тип приложения — для корректной работы точки интеграции укажите тип приложения, который будет с ней использоваться.
c. Секретный сервисный ключ — обеспечивает безопасность передачи данных. Для генерации нажмите на ссылку «Сгенерировать».
В случае, если секретный сервисный ключ от одной из точек интеграции будет скомпрометирован, остальные точки интеграции не пострадают благодаря уникальности сервисных ключей для каждой из них.

Настройки атрибуции

a. Точка контакта — по ней отслеживается откуда пришел пользователь и где совершает действия. Точка контакта должна быть уникальной для каждой точки интеграции.
b. Флаг «Это тестовая точка интеграции» . Если настройка включена, все клиенты, созданные через эту точку интеграции, помечаются как тестовые.

Настройки подтверждения контактов — необходимы только для проектов с личным кабинетом на стороне Mindbox.
Укажите какие контакты должны давать возможность регистрации, авторизации и восстановления пароля. Контакт, отмеченный как дающий доступ к аккаунту, имеет особый статус в системе. Невозможна повторная регистрация клиента с таким контактом. Разные клиенты, имеющие доступ к аккаунту, не могут быть объединены.

Настройки точки доступа к аккаунту — необходимы в большинстве случаев только для проектов с личным кабинетом на стороне Mindbox.
Если нужно проверять, что email принадлежит подписчику и он согласен на рассылку, используйте отдельный механизм подтверждения подписки (double opt-in ).

Зачем может потребоваться подтверждение контактов?

Возьмем случай использования программы лояльности Mindbox. Можно разрешить тратить баллы только тем клиентам, у которых подтвержден телефон и/или email. Подтверждение подписки в этом случае не подходит, так как пользователь может отписаться от рассылок, но продолжать пользоваться программой лояльности.

Сайты с Javascript SDK — указываются адреса сайтов без протокола, на которых установлен js-трекер Mindbox. Информация о действиях клиентов будет собираться исключительно из указанных сайтов. Блок доступен только для типа приложения «Сайт».

Частые ошибки:— Домен уже используется в других проектах. Выберите в каких точках интеграции вы хотите указать домен. Один домен можно указать только в одной точке интеграции для всех проектов Mindbox. Еще один вариант — это передавать идентификатор точки интеграции в коде отслеживания .

  • Код отслеживания не собирает информацию с поддоменов сайта site.ru. Например, www.site.ru или m.site.ru. Для решения проблемы в настройках включите флаг «Включая поддомены», либо укажите все необходимые поддомены в настройках.

  • Домен указан с протоколом, например, http:// или https://. Используйте формат site.ru или www.site.ru. Если домен вашего сайта именно site.ru, без www, важно прописать его в настройках точки интеграции без www — просто site.ru. В противном случае в консоли возникнет ошибка вида «Requests from „http://site.ru“ are not allowed. Add your domain in integration settings».

Примеры использования точек интеграции и их настроек в рамках одной системы:

  • У вас есть только 1 сайт. Создаем 1 точку интеграции.
  • У вас есть сайт и лендинг. Вы хотите собирать базу емейлов, но при этом понимать, с какого сайта они пришли. Для этого создаете две точки интеграции, одну для лендинга, другую для сайта. Для каждой точки интеграции указываете свою точку контакта (точки контакта не должны совпадать!). Когда вы захотите найти людей, которые пришли через лендинг, достаточно будет отфильтровать клиентов по точке контакта.

Выбор точки интеграции при работе в системе Mindbox связан также с импортом клиентов/заказов и зависит от источника данных.

Например, если вы загружаете клиентов, которые зарегистрировались на сайте, выбираем точку интеграции сайт (обычно указывается название сайта).

В любых непонятных и сомнительных ситуациях обращайтесь к своему менеджеру.