Настройка интеграции с Google Forms
  • 17 Jan 2024
  • 3 минуты
  • Темная тема
    Светлая тема
  • формат pdf

Настройка интеграции с Google Forms

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

Article Summary

Иногда требуется проводить для клиентов специальные опросы или тестирования. С помощью Google Forms можно настроить передачу ответов клиентов в Mindbox.

Как настроить передачу ответов в дополнительное поле клиента

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


Настройка интеграции в Mindbox

  1. Cоздайте новую точку интеграции. В целях безопасности для Google-форм лучше создавать отдельный эндпоинт.
    Снимок экрана 2023-05-01 в 00.56.04.png

Точка интеграции должна быть с типом «Другое». При сохранении системного имени точки интеграции точка контакта будет создана автоматически с таким же названием.

  1. Создайте дополнительное поле для ответов клиентов.
    Важно: сделать поле публичным, чтобы редактировать его операцией без передачи секретного ключа.
    Снимок экрана 2022-08-15 в 18.19.47.png
    Обратите внимание, что тип поля может быть любым. Если вопрос в форме имеет ограниченный список ответов, то чаще всего удобнее использовать тип "Перечисление".
  2. Создайте операцию для передачи данных. Снимок экрана 2022-01-13 в 16.46.51.png

Настройка интеграции Google формы

  1. Создайте форму опроса.
  2. Создайте два файла в редакторе скриптов, в которые нужно скопировать и сохранить код:
  1. Добавьте скрипт файл с названием «код.gs» и скопируйте в него основной код.

  2. Добавьте HTML-файл с названием «sidebar.html» и скопируйте в него верстку формы. Снимок экрана 2022-01-13 в 16.07.18.png

  3. Добавьте название проекта в верху страницы, например “Интеграция с MB”.

  4. Сохраните оба файла.

  5. Перезагрузите страницу с Google-формой. Через пару секунд после перезагрузки появится значок аддона (расширения).

  6. Нажмите на него — и выберите «Интеграция с MB».
    Снимок экрана 2021-12-23 в 17.45.00.png

  7. Затем выберите “Настройка интеграции”. Появится сайдбар с настройками интеграции.

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

Настройка интеграции в сайдбаре формы

  1. Введите данные для подключения к Mindbox: название операции и эндпоинта.
    MINDBOX.png

Эндпоинт = системное имя точки интеграции из первого шага инструкции.

Снимок экрана 2023-05-01 в 00.59.16.png

  1. Выберите тип поля для каждого вопроса. Стандартные поля API Mindbox выбираются из списка. Если ответ нужно сохранить в дополнительное поле или как идентификатор, то выберите соответствующий пункт и заполните название поля.

Если дополнительное поле принимает множественные значения, поставьте галочку «Множественное».

Важно: вставить системное имя дополнительного поля, которое вводили при создании поля в Mindbox.

  1. Выберите тип «Тикет» для «технического» поля в форме, куда будет автоматически записываться тикет авторизации клиента после перехода на страницу опроса из рассылки.
    MINDBOX 2.png

  2. Когда все заполнено — нажимаем «Сохранить».

Ошибка PERMISSION_DENIED

Если после открытия попапа вместо вопросов появилась ошибка с текстом PERMISSION_DENIED, значит вы залогинены в нескольких Google-аккаунтах.
Чтобы аддон сработал, оставьте логин только в одном аккаунте, через который вы добавляете код формы. Можно выйти из остальных или использовать режим «инкогнито».

Как протестировать форму

Образец заполнения

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

  1. Нажмите "Создать образец заполнения" в верхнем правом меню.
    Снимок экрана 2022-04-21 в 11.44.19.png

  2. Введите любое слово в “техническое” поле для тикета (чтобы потом его найти в ссылке).
    Снимок экрана 2021-12-23 в 17.45.26.png

  3. Сформируйте ссылку на пример и скопируйте ссылку.
    Снимок экрана 2021-12-23 в 17.48.30.png

  4. Вставьте ссылку в рассылку в Mindbox и замените слово из “технического поля” на параметр шаблонизатора для подстановки тикета авторизации. Подробнее о тикете авторизации по ссылке.
    Снимок экрана 2021-12-23 в 17.49.36.png

В рассылке это будет выглядеть вот так:
Снимок экрана 2021-12-23 в 17.51.28.png

  1. Отправьте себе письмо и перейдите по ссылке опроса.
  2. Пройдите опрос, заполнив форму.
  3. Ответ должен через пару минут появиться у вашего тестового клиента в дополнительном поле в Mindbox.

Настроить передачу ответов в дополнительное поле действия клиента

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


Для настройки такой интеграции дополнительно понадобится:

В Mindbox:

  1. Создать шаблон действия для выдачи в шаге операции по инструкции.
    Снимок экрана 2022-04-22 в 21.23.04.png

  2. Создать дополнительное поле к действию клиента.

  3. Затем добавить в операцию для передачи данных из Google формы дополнительный шаг "выдать действие + имя шаблона действия".
    Снимок экрана 2022-04-22 в 21.23.31.png

В Google форме:

  1. Выбрать тип "Доп.поле к действию" для вопроса в форме.
    Снимок экрана 2022-04-22 в 21.00.30.png
Если у вас возникли сложности на любом шаге настройки – напишите в нашу поддержку.

Чат с поддержкой есть справа внизу.

Как проводить эксперименты на сайте с помощью инструмента Google Optimize