Важно
При сборе данных через формы Google происходит трансграничная передача персональных данных.
В таких случаях перед использованием иностранных сервисов нужно предпринять обязательные шаги, в том числе уведомить Роскомнадзор о соответствующем намерении. При необходимости проконсультируйтесь с юристами или специалистами по защите данных.
Настройка интеграции с Google Forms
Иногда требуется проводить для клиентов специальные опросы или тестирования. С помощью Google Forms можно настроить передачу ответов клиентов в Mindbox.
Как настроить передачу ответов в дополнительное поле клиента
Задача: отправить клиентам рассылку со ссылкой на форму опроса и собрать данные о типе кожи в дополнительное поле клиента, чтобы сегментировать базу и персонализировать рекомендации косметических товаров в коммуникациях.
Настройка интеграции в Mindbox
1. Cоздайте новую точку интеграции. В целях безопасности для Google-форм лучше создавать отдельный эндпоинт.
Точка интеграции должна быть с типом «Другое». При сохранении системного имени точки интеграции точка контакта будет создана автоматически с таким же названием.
2. Создайте дополнительное поле для ответов клиентов.
Важно: сделать поле публичным, чтобы редактировать его операцией без передачи секретного ключа.
Обратите внимание, что тип поля может быть любым. Если вопрос в форме имеет ограниченный список ответов, то чаще всего удобнее использовать тип "Перечисление".
3. Создайте операцию для передачи данных. 
Настройка интеграции Google формы
1. Создайте форму опроса.
2. Создайте два файла в редакторе скриптов, в которые нужно скопировать и сохранить код:
3. Добавьте скрипт файл с названием «код.gs» и скопируйте в него основной код.
4. Добавьте HTML-файл с названием «sidebar.html» и скопируйте в него верстку формы. 
5. Добавьте название проекта в верху страницы, например “Интеграция с MB”.
6. Сохраните оба файла.
7. Перезагрузите страницу с Google-формой. Через пару секунд после перезагрузки появится значок аддона (расширения).
8. Нажмите на него — и выберите «Интеграция с MB».
9. Затем выберите “Настройка интеграции”. Появится сайдбар с настройками интеграции.
Вопросы формы подтянутся с небольшой задержкой — не пугайтесь.
Если что-то пойдет не так, и в консоли появятся ошибки — напишите в нашу поддержку.
Чат с поддержкой есть справа внизу.
Настройка интеграции в сайдбаре формы
1. Введите данные для подключения к Mindbox: системное имя операции и эндпоинта.
Эндпоинт = системное имя точки интеграции из первого шага инструкции.
2. Выберите тип поля для каждого вопроса. Стандартные поля API Mindbox выбираются из списка. Если ответ нужно сохранить в дополнительное поле или как идентификатор, то выберите соответствующий пункт и заполните название поля.
Если дополнительное поле принимает множественные значения, поставьте галочку «Множественное».
Важно: вставить системное имя дополнительного поля, которое вводили при создании поля в Mindbox.
3. Выберите тип «Тикет» для «технического» поля в форме, куда будет автоматически записываться тикет авторизации клиента после перехода на страницу опроса из рассылки.
4. Когда все заполнено — нажимаем «Сохранить».
Ошибка PERMISSION_DENIED
Если после открытия попапа вместо вопросов появилась ошибка с текстом PERMISSION_DENIED, значит вы залогинены в нескольких Google-аккаунтах.
Чтобы аддон сработал, оставьте логин только в одном аккаунте, через который вы добавляете код формы. Можно выйти из остальных или использовать режим «инкогнито».
Как протестировать форму
Образец заполнения
Чтобы при переходе на форму из рассылки Mindbox в нее автоматически подставлялись какие-то значения, нужно сформировать ссылку в образце заполнения.
Например, так вы можете сделать форму с подстановкой тикета авторизации.
1. Нажмите "Создать образец заполнения" в верхнем правом меню.
2. Введите любое слово в “техническое” поле для тикета, чтобы потом его найти в ссылке (вводите латиницей, чтобы символы не переводились в формат Юникод и их проще было найти).
3. Сформируйте ссылку на пример и скопируйте ссылку.
4. Вставьте ссылку в рассылку в Mindbox и замените слово из “технического поля” на параметр шаблонизатора для подстановки тикета авторизации. Подробнее о тикете авторизации по ссылке.
В рассылке это будет выглядеть вот так:
5. Отправьте себе письмо и перейдите по ссылке опроса.
6. Пройдите опрос, заполнив форму.
7. Ответ должен через пару минут появиться у вашего тестового клиента в дополнительном поле в Mindbox.
Настроить передачу ответов в дополнительное поле действия клиента
Задача: записать клиенту действия прохождения всех NPS опросов и сохранить ответы к каждому в дополнительном поле к действию клиента. После выдачи действия, исходя из значения дополнительного поля, запускать разные цепочки коммуникаций.
Для настройки такой интеграции дополнительно понадобится:
В Mindbox:
1. Создать шаблон действия для выдачи в шаге операции по инструкции.
2. Создать дополнительное поле к действию клиента.
3. Затем добавить в операцию для передачи данных из Google формы дополнительный шаг "выдать действие + имя шаблона действия".
В Google форме:
1. Выбрать тип "Доп.поле к действию" для вопроса в форме.
