Регистрация в программе лояльности пользователей

Функция регистрации и входа в программу лояльности позволяет пользователям искать вашу программу лояльности и присоединяться к своей учетной записи или входить в нее из Google Кошелька. Пользователи будут перенаправлены на ваш веб-сайт, удобный для мобильных устройств, для завершения процесса, после чего они смогут добавить свою карту в Google Кошелек.

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

Обзор

Для начала убедитесь, что вы ранее настроили свой проект и имеете доступ к API Google Кошелька.

Вам необходимо выполнить следующие четыре шага, чтобы реализовать функцию регистрации и входа в вашу программу лояльности:

1. Настройте тестовый класс в Google Кошельке для тестирования процессов регистрации и входа в систему.
2. Разработайте страницы регистрации/входа, использующие Google Wallet SharedDataType .
3. Реализуйте возврат карты лояльности в Google Кошелек после регистрации/входа в систему.
4. Запросить проверку и активацию.

Настройте тестовый курс в Google Кошельке.

Определите URL-адреса регистрации и входа, логотип вашей программы и выбранные пользовательские поля. Затем используйте вложенные поля discoverableProgram в loyaltyclass , чтобы установить соответствующие значения.

Задайте значения в discoverableProgram , чтобы создать черновую версию вашей программы лояльности с поддержкой регистрации/входа. Чтобы это было видно тестировщикам, убедитесь, что у тестировщиков есть доступ к вашему Google Pay и консоли Кошелька. Подробную информацию о том, как предоставить доступ к Google Pay и консоли Кошелька другим людям, можно найти на странице «Информация о пользователях» .

Чтобы завершить проверку функциональности вашей реализации в процессе разработки, свяжитесь с нами с помощью виджета поддержки контактов в консоли Google Pay и Wallet. В консоли выберите Google Wallet API в теме и выберите «Вход/регистрация по программе лояльности» в подтеме.

Разработайте страницы регистрации и входа в систему, использующие данные пользователя Google Кошелька.

Когда пользователь решает войти в систему или зарегистрироваться в вашей программе лояльности, он перенаправляется на специальную страницу вашего веб-сайта, чтобы завершить процесс регистрации или входа в систему. Если пользователь решит зарегистрироваться, Google Кошелек запросит у него разрешение на передачу вам своих пользовательских данных.

Вам необходимо предоставить одну из двух страниц или обе, которые позволяют пользователям выполнять эти действия.

1. URL-адрес для входа, по которому пользователь может войти в существующую учетную запись.
2. URL-адрес регистрации, по которому пользователь может создать новую учетную запись.

Страницы входа и регистрации должны соответствовать следующим требованиям:

• Обеспечьте удобный пользовательский интерфейс для мобильных устройств.
• Минимизируйте количество обязательных полей в процессе регистрации.
• Разрешите пользователю завершить вход или регистрацию на одной странице.
• Используйте шифрование HTTPS с действительным сертификатом, чтобы обеспечить безопасную передачу пользовательских данных.
• Обеспечьте бесперебойную работу страниц входа и регистрации в течение не менее 99,9 % времени.

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

• Используя пользовательские данные, предоставленные в SharedDataType , вы можете создать учетную запись и немедленно вернуть свою карту лояльности.
• Впоследствии вы можете отправить пользователю по электронной почте одноразовый пароль или ссылку для настройки пароля и дополнительных данных учетной записи.
• Это снижает вероятность того, что пользователи откажутся от процесса регистрации, поскольку каждый дополнительный шаг может привести к дополнительному отказу.

При отображении страницы входа или регистрации Google Кошелек создаст Android WebView и на указанный вами URL-адрес будет отправлен запрос POST . Пользовательские данные предоставляются в параметре SharedDataType , который включается в запрос POST с использованием типа контента application/x-www-form-urlencoded и кодировки UTF-8 . Значение параметра SharedDataType — это объект JSON в кодировке Base64.

Примечание. Строка JSON сначала кодируется в UTF-8, а затем кодируется с использованием android.util.Base64 с параметрами NO_WRAP и URL_SAFE. Это соответствует разделу 4 RFC 3548 .

В зависимости от действия, выбранного пользователем, и полей, которые вы указали для запроса у пользователя, объект JSON может содержать следующие поля.

Поле	Регистрация	Войти
электронная почта	✓	✓
имя	✓
фамилия	✓
адресная строка [1-3]	✓
город	✓
состояние	✓
почтовый индекс	✓
страна	✓
телефон	✓

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

Примечание. Если вы запрашиваете поле у ​​пользователя, убедитесь, что эти данные используются для предварительного заполнения формы.

Ниже приведен декодированный образец объекта JSON, содержащийся в SharedDataType .

Ресурс

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "[e-mail]",
  "phone": "555-555-5555"
}

Реализуйте немедленный возврат карты постоянного клиента в Google Кошелек.

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

Примечание. Не используйте кнопку API Google Кошелька, поскольку пользователи должны возвращаться в Google Кошелек без дополнительного взаимодействия с пользователем.

Вы можете вернуть карту постоянного клиента в Google Кошелек, перенаправив на ссылку, которая соответствует приведенной ниже структуре.

https://pay.google.com/gp/v/save/{jwt_generated}

Примечание. Обязательно добавьте в URL-адрес завершающий символ «/» перед JWT.

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

Безопасная длина URL-адреса составляет 2000 символов. Ваши ссылки должны оставаться ниже этого предела. Объекты, закодированные в JWT, должны быть небольшими и содержать только данные, специфичные для пользователя. Постарайтесь сохранить большую часть данных в классе объекта, создав его перед созданием JWT. Для более крупных объектов, которые не соответствуют этому пределу, рассмотрите возможность сначала создать объект в API Google Кошелька и отправить только идентификатор объекта в JWT.

Типичный поток общения

Поток общения для пользователя, завершающего регистрацию или вход, показан на следующем изображении. Все действия между «Вашим Сервером» являются вашей ответственностью за реализацию.

Запросить проверку и активацию

После завершения разработки и тестирования процессов регистрации и входа в систему отправьте запрос через виджет поддержки контактов Google Pay и консоли Wallet .

После полной проверки вашей реализации, которая подтвердит правильность функционирования в сочетании с приложением Google Кошелек, функция регистрации/входа в систему лояльности будет публично запущена для вашей программы лояльности. Это позволит любому пользователю увидеть программу и использовать эту функциональность.

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

Часто задаваемые вопросы

• Есть ли какие-либо требования к изображениям, используемым в моей программе лояльности?
  • Да, ваши изображения должны размещаться по протоколу HTTPS , иначе они не будут видны в Google Кошельке.
• Существуют ли какие-либо инструменты, упрощающие реализацию и отладку JWT?
  • Да, такие платформы, как www.jwt.io , позволяют вам декодировать и отлаживать ваши токены в процессе разработки, что позволяет вам проверять отправляемый вами контент. Обратите внимание, что Google не имеет никакого отношения к таким третьим сторонам и не рекомендует их конкретно.
• Как правильно обрабатывать данные SharedDataType в кодировке Base64?
  • Убедитесь, что вы используете кодировку UTF-8 на протяжении всего процесса. Строка JSON сначала кодируется в UTF-8, а затем кодируется с использованием android.util.Base64 с параметрами NO_WRAP и URL_SAFE. Это соответствует разделу 4 RFC 3548 .