В данном разделе вы узнаете:

  • Как подключить или отключить Mindbox на вашем сайте.
  • Как передать кастомные параметры и события в Mindbox.

Mindbox - платформа автоматизации прямых коммуникаций с клиентами: email, push, sms, мессенджеры. DigitalDataManager позволяет отправлять данные о поведении ваших пользователей в Mindbox.

Навигация по странице


Введение


С помощью DigitalDataManager можно полностью интегрировать Mindbox с вашим сайтом.

Чтобы настроить интеграцию с Mindbox:

  1. Авторизуйтесь на сайте ddmanager.ru и перейдите к панели управления интеграциями
  2. Войдите на вкладку “Интеграции” и кликните по блоку с логотипом Mindbox.
  3. В открывшейся панели - настройте интеграцию.
    Подробнее о настройках вы можете прочитать ниже.

Mindbox API V2 больше не поддерживается разработчиками. Ниже идет описание настройки интеграции сайта с Mindbox API V3.

Условия для подключения


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

  • Запросить у менеджера Mindbox ТЗ на интеграцию
  • Запросите у менеджера системное поле endpointId. Менеджер mindbox может сказать, что это поле не нужно или устарело. Что делать в этом случае описано в

Идентификатор точки доступа


Идентификатор точки доступа - это системное поле endpointId в сниппете инициализации. Его можно узнать у представителей Mindbox.
Справка Mindbox по вызову основного трекера

Если в вашем ТЗ отсутствует поле endpointId, то библиотека mindbox определяет точку доступа по домену автоматически. В этом случае оставьте поле пустым.

Переменные пользователя


Переменные пользователя - это набор характеристик, которые описывают пользователя: имя, фамилия, телефон, адрес электронной почты и так далее. В ТЗ от mindbox в объекте data.customer описаны названия переменных, которые нужны для интеграции, например: lastName, firstName, mobilePhone

В данной настройке вам нужно в левой части указать имя переменной из ТЗ Mindbox, в правой - имя переменной в digitalData.

Переменные заказа


В разработке…

Переменные товара


Переменные товара - это набор характеристик, которые описывают товары на сайте: цена, название, размер, цвет и так далее. По умолчанию DigitalDataManager передает: идентификатор товаров, цена, количество единиц, добавленных в корзину.

В случае, если необходимо передать дополнительные параметры вам нужно сделать настройку соответствия: слева - имя переменной Mindbox, справа - имя переменной digitalData.

Так как объект ‘product’ встречается во многих местах объекта ‘digitalData’: digitalData.product, digitalData.cart.lineItems[], digitalData.transaction.lineItems[] и других, в настройке используйте только имя переменной без полного пути до нее. DigitalDataManager сам поймет в какой ситуацию из какого места брать информацию о товаре.

Мэппинг операций


Любая информация попадает в Mindbox в виде событий. К сожалению, в системе Mindbox нет зарезервированных имен для определенных событий, поэтому необходимо настроить правила соответствия, например: операция mindbox ‘EnterSite’ соответствует событию ‘Logged In’.

Список названий необходимых операций есть в ТЗ Mindbox.

Идентификаторы потребителя


В зависимости от особенностей ТЗ от Mindbox у каждого посетителя сайта может быть один или несколько идентификаторов. Идентификаторы потребителя можно найти в ТЗ mindbox:

mindbox('async', {
  operation: '<Название операции>',
  data: {
    customer: {
      ids: {
      	<Идентификатор>: '<Значение идентификатора>',
      },
      ...
    },
    ...
  }
);

. Имя ключа необходимо указать в настройках интеграции. В соответствующем поле укажите из какой переменной digitalData необходимо забрать идентификатор. В большинстве случаев - это будет digitalData.user.userId.

Идентификаторы товара


В разработке…

Идентификаторы SKU товара


В разработке…

Идентификаторы товарной категории


В разработке…

Идентификаторы зон


В разработке…