Если вы настроите регистрацию и аутентификацию в программе лояльности, то пользователи смогут находить и добавлять ваши новые или уже существующие карты постоянного клиента в Google Pay. Чтобы завершить аутентификацию или регистрацию, пользователи будут перенаправляться на мобильную версию вашего сайта.
В этом руководстве описан процесс настройки программ лояльности и карт постоянного клиента.
Обзор
Сначала необходимо создать проект и получить доступ к Google Pay API for Passes. Подробнее о том, как это сделать…
Выполните четыре шага, чтобы подключить функцию регистрации и аутентификации клиентов в своей программе лояльности.
- Настройте в Google Pay тестовую среду для проверки функций регистрации и аутентификации.
- Создайте страницы регистрации и аутентификации, которые будут обрабатывать данные пользователей приложения Google Pay.
- Настройте функцию добавления карты постоянного клиента в приложение Google Pay после регистрации или аутентификации в программе лояльности.
- Запросите проверку и активацию.
Как настроить тестовую среду в Google Pay
Определите URL-адреса страниц регистрации и аутентификации, логотип программы лояльности и пользовательские поля. Затем укажите соответствующие значения полей discoverableProgram
в классе loyaltyclass
.
Укажите значения в discoverableProgram
. Так вы создадите предварительную версию программы лояльности с функцией регистрации и аутентификации. Убедитесь, что у тестировщиков есть доступ к ней и к Business Console. Подробнее о том, как предоставить другим пользователям доступ к Business Console, написано на этой странице.
Чтобы проверить, правильно ли реализованы функции во время разработки, обратитесь в нашу службу поддержки. Для этого используйте специальный виджет в Business Console, где в качестве темы выберите Карты, а в качестве подтемы – Регистрация в программе лояльности или вход.
Как создать страницы регистрации и аутентификации для обработки данных пользователей Google Pay
Как только пользователи нажмут на ссылку или кнопку входа или регистрации в программе лояльности, они будут перенаправлены на специальную страницу вашего сайта. При регистрации пользователи должны будут подтвердить, что согласны предоставить вам свои персональные данные.
Для того чтобы пользователи могли выполнить эти действия, необходимо создать хотя бы одну из этих двух страниц:
- URL для входа пользователя в существующий аккаунт.
- URL регистрации для создания аккаунта.
Создавая страницы аутентификации и регистрации, соблюдайте следующие требования:
- оптимизируйте страницы для мобильных устройств;
- сведите к минимуму количество полей, которые нужно заполнить для регистрации;
- используйте для процесса регистрации или аутентификации не более одной страницы;
- используйте шифрование
HTTPS
с действительным сертификатом для безопасной передачи пользовательских данных; - обеспечьте бесперебойную работу страниц входа и регистрации в 99,9 % случаев.
Для облегчения процесса регистрации в программе удалите заполняемые формы, чтобы пользователям нужно было только согласиться с Условиями использования на странице вашего сайта.
- Используя данные, полученные от пользователя, вы можете создать аккаунт и сразу же добавить его карту постоянного клиента.
- После этого можно отправить пользователям по электронной почте одноразовый пароль или ссылку для настройки их паролей или дополнительных данных аккаунта.
- Простота всех процессов уменьшит вероятность того, что пользователи прервут процесс регистрации, поскольку каждое дополнительное действие снижает их заинтересованность.
При отображении страниц аутентификации или регистрации при помощи Android WebView приложение Google Pay направит запрос POST
на предоставленный вами URL. Данные пользователя указываются в параметре userProfile
, который включен в запрос POST
как контент типа application/x-www-form-urlencoded с кодировкой UTF-8
. Значение параметра userProfile
представляет собой объект JSON с кодировкой Base64.
В зависимости от выбора пользователя и запрашиваемых вами данных объект JSON может содержать указанные ниже поля.
Поле | Регистрация | Аутентификация |
---|---|---|
✓ | ✓ | |
firstName | ✓ | |
lastName | ✓ | |
addressLine [1–3] | ✓ | |
city | ✓ | |
state | ✓ | |
zipcode | ✓ | |
country | ✓ | |
phone | ✓ |
Ниже показан образец расшифрованного объекта JSON, который содержится в userProfile
.
Ресурс
{ "firstName": "Jane", "lastName": "Doe", "addressLine1": "1600 Amphitheatre Pkwy", "addressLine2": "Apt 123", "addressLine3": "Attn:Jane", "city": "Mountain View", "state": "CA", "zipcode": "94043", "country": "US", "email": "jane.doe@example.com", "phone": "555-555-5555" }
Как подключить функцию моментального добавления карты постоянного клиента в приложение Google Pay
После аутентификации (входа) или создания аккаунта (регистрации) карта постоянного клиента должна быть немедленно добавлена с вашей страницы в приложение Google Pay.
Можно добавить карту постоянного клиента в приложение Google Pay, перенаправив ее по указанной ниже ссылке. Если вы ещё не знакомы с процессом создания веб-токена JSON (JWT) для объекта LoyaltyObject
, который представляет вашу карту постоянного клиента, ознакомьтесь с разделом Создание токена JWT, который представляет объект.
https://pay.google.com/gp/v/save/{jwt_generated}
Безопасная длина URL – 2000 символов. Не следует превышать этот лимит. Объекты в токенах JWT должны содержать только важные данные. Постарайтесь сохранить большую часть данных в классе, создав его раньше JWT. Используйте Google Pay API for Passes, если нужно сформировать крупный объект, и отправьте в JWT только его идентификатор.
Стандартный процесс взаимодействия
Процесс взаимодействия пользователя и систем для завершения регистрации или аутентификации показан на рисунке ниже. Вам необходимо обеспечить работу всех процессов, связанных с сервером.
![Регистрация и аутентификация](https://developers-dot-devsite-v2-prod.appspot.com/static/pay/passes/images/EnrollmentSigninFlows.png?authuser=5&hl=ru)
Как запросить проверку и активацию
После того как вы закончите разработку и тестирование процессов регистрации и входа, отправьте запрос через виджет для связи со службой поддержки Business Console.
После окончательного утверждения настроенных функций для приложения Google Pay клиенты смогут проходить регистрацию и аутентификацию в вашей программе лояльности. Любой пользователь сможет увидеть ваше предложение и воспользоваться им.
Для обеспечения оптимальной работы сервиса подключенные функции будут регулярно проверяться на соответствие предъявляемым требованиям. В случае выявления несоответствий вам направят уведомление. При этом функции могут быть отключены до устранения проблемы.
Часто задаваемые вопросы
- Существуют ли какие-нибудь требования к изображениям, используемым в программе лояльности?
- Да, ваши изображения должны храниться на
HTTPS
-ресурсе. В противном случае они не будут видны в приложении Google Pay.
- Да, ваши изображения должны храниться на
- Есть ли какие-нибудь инструменты для упрощения создания и отладки JWT?
- Да, вы можете декодировать и отлаживать токены в процессе разработки, используя такие платформы, как www.jwt.io. Однако имейте в виду, что компания Google не дает конкретных рекомендаций по работе с третьими лицами и не поддерживает с ними каких-либо отношений.
- Как правильно работать с пользовательскими данными, закодированными с помощью Base64?
- Используйте кодировку UTF-8 на всех этапах работы с данными. Строка JSON сначала кодируется по стандарту UTF-8, а затем при помощи android.util.Base64 с опциями NO_WRAP и URL_SAFE согласно процедуре, описанной в разделе 4 документа "RFC 3548".
Образец процесса регистрации
![Регистрации в программе лояльности](https://developers-dot-devsite-v2-prod.appspot.com/static/pay/passes/images/loyalty-enrollment-flow.jpg?authuser=5&hl=ru)