Инструкция по интеграции UIS с Marquiz

Пройденные на сайте квизы от Marquiz можно загружать в UIS в виде заявок.

Виджет на сайте Marquiz

В UIS отображаются:

• текст квиза;
• контактные данные посетителя сайта (телефон и/или email);
• ФИО посетителя сайта;
• рекламный источник, с которого посетитель перешел на сайт.

Загрузка происходит в режиме реального времени.

Виджеты на сайте Marquiz с результатами квиза в мессенджер

В UIS отображаются:

• текст квиза;
• контактные данные посетителя сайта (телефон и/или email);
• название мессенджера;
• рекламный источник, с которого посетитель перешел на сайт.

Загрузка происходит в режиме реального времени.

Лендинг с квизом Marquiz

В UIS отображаются:

• текст квиза;
• контактные данные посетителя сайта (телефон и/или email);
• ФИО посетителя сайта;
• рекламный источник, с которого посетитель перешел на сайт (если лендинг заведен в личный кабинет UIS как отдельный сайт. Иначе данные передаются в преднастроенный рекламный источник).

Загрузка происходит в режиме реального времени.

Чтобы подключить интеграцию, вам понадобится помощь вашего менеджера UIS для выполнения части настроек в кабинете UIS, а другой части — в кабинете Marquiz.

Для загрузки квизов с лендинга Marquiz:

1. Подключение опции API

Чтобы интеграция работала, требуется подключить опцию «Загрузка коммуникаций из внешних систем». В правом верхнем углу переходим в «Администратор — Аккаунт».

В меню слева переходим в раздел «Тарифы и опции». В правом столбце сначала нажимаем «Все опции» и находим нужную для подключению опцию.

2. Генерация ключа API

Чтобы отправлять запросы для загрузки данных UIS, требуется сформировать ключ API. В правом верхнем углу переходим в «Администратор — Управление пользователями».

Далее либо добавляем нового пользователя, либо переходим в редактирование текущего нажатием на название пользователя.

В настройках пользователя внизу ставим галочки: DataAPI, Использовать ключ API. Переводим чек-бокс в статус «Вкл», копируем сгенерированный ключ API и сохраняем настройки пользователя.

Сгенерированный ключ нужно будет передать вашему менеджеру UIS.

3. Добавления IP-адреса в список разрешенных

В целях безопасности для отправления запросов на загрузку данных в личный кабинет UIS требуется указывать список IP-адресов, с которых будут поступать запросы. В правом верхнем углу переходим в «Администратор — Аккаунт».

В меню слева переходим в раздел «Правила и настройки безопасности», далее жмем на вкладку «API». После этого нажимаем кнопку «Добавить», вводим IP-адрес: 10.0.0.0/8 и нажимаем на значок дискеты.

4. Создание рекламного источника

В личном кабинете UIS требуется создать рекламный источник. В левом меню переходим в раздел «Аналитика — Рекламные кампании» и нажимаем кнопку «Добавить рекламную кампанию».

В Шаг 1 выбираем «Самостоятельная настройка». В Шаг 2 указываем название кампании и нажимаем кнопку «Создать кампанию».

Название рекламной кампании требуется передать вашему менеджеру UIS.

1. Настройка формы квиза

Чтобы в кабинет UIS корректно загружались данные, в личном кабинете Marquiz нужно настроить передачу номера телефона посетителя сайта в формате 7 ХХХ ХХХ ХХ ХХ.

При настройке формы квиза укажите обязательный сбор телефона посетителя сайта.

А также выберите маску для телефона.

Из списка готовых.

Или задайте свою маску.

2. Настройка веб-хука

Когда ваш менеджер предоставит адрес, на который нужно отправлять веб-хук, в личном кабинете Marquiz перейдите в раздел «Интеграции — Webhooks» и вставьте адрес.

3. Вставка кода отслеживания UIS для лендинга Marquiz

Если у вас квиз расположен на отдельном лендинге site.mrqz.ru, то на него требуется добавить код отслеживания UIS.

В личном кабинете Marquiz слева перейдите в раздел «Интеграции», выберите «Свой код» и вставьте код отслеживания UIS.

В личном кабинете UIS слева перейдите в раздел «Сайты» и нажмите кнопку «Добавить сайт». Укажите адрес сайта и номер телефона, нажмите кнопку «Добавить сайт».

Настройка завершена.