Rejestracja w programie lojalnościowym

Funkcja rejestracji i logowania się w programie lojalnościowym pozwala użytkownikom wyszukać programu lojalnościowego i dołączyć do niego lub zalogować się na nie za pomocą Portfela Google. Użytkownicy są przekierowywani na Twoją witrynę dostosowaną do komórek, na której wypełnili a następnie dodać kartę do Portfela Google.

Ten przewodnik zawiera omówienie wymaganych etapów implementacji aby włączyć tę funkcję w swoim programie lojalnościowym.

Omówienie

Aby rozpocząć, sprawdź, czy masz już skonfigurowany projekt i czy masz dostęp do Google Wallet API.

Aby wdrożyć funkcję rejestracji i logowania, musisz wykonać te 4 kroki dla programu lojalnościowego:

1. Skonfiguruj zajęcia testowe w Portfelu Google, aby przetestować procesy rejestracji i logowania.
2. Twórz strony rejestracji lub logowania korzystające z Portfela Google SharedDataType.
3. Wdróż odsyłanie karty lojalnościowej do Portfela Google po rejestracji lub zalogowaniu.
4. Poproś o weryfikację i aktywację.

Konfigurowanie zajęć testowych w Portfelu Google

Określ adresy URL rejestracji i logowania, logo programu oraz wybrane pola użytkownika. Następnie: użyj zagnieżdżonych pól discoverableProgram w tabeli loyaltyclass, aby ustawić odpowiednich wartości.

Ustaw wartości w polu discoverableProgram, aby utworzyć wersję roboczą klucza program lojalnościowy z włączoną obsługą rejestracji lub logowania się. Aby mieć pewność, że jest ona widoczna dla testerów, sprawdź, czy testerzy mają dostęp do Twojej Konsoli usług Google Pay i Portfela Google. Aby dowiedzieć się, jak udostępnić dostępu do Konsoli usług Google Pay i Portfela Google z innymi osobami, zobacz Więcej informacji o stronie Użytkownicy

Aby dokończyć weryfikację działania implementacji w trakcie jej tworzenia skontaktuj się z nami za pomocą widżetu kontaktu w Konsoli usług Google Pay i Portfela Google. W domu w konsoli wybierz Google Wallet API w temacie, a następnie Logowanie/rejestracja w programie lojalnościowym do podtematu.

Tworzenie stron rejestracji i logowania korzystających z danych użytkownika Portfela Google

Gdy użytkownik zaloguje się w programie lojalnościowym lub zarejestruje się w nim, są przekierowani na odpowiednią stronę w witrynie, aby dokończyć rejestracji lub logowania się. Jeśli użytkownik zdecyduje się się zarejestrować, prosi użytkownika o zgodę na udostępnienie Ci jego danych.

Musisz podać jedną lub obie strony, na których użytkownicy będą mogli wykonać te czynności.

1. Adres URL logowania, pod którym użytkownik może zalogować się na istniejące konto.
2. Adres URL rejestracji, pod którym użytkownik może utworzyć nowe konto.

Strony logowania i rejestracji muszą spełniać następujące wymagania:

• Dostosowanie do urządzeń mobilnych.
• Ogranicz liczbę wymaganych pól podczas rejestracji.
• Użytkownicy mogą logować się lub rejestrować na jednej stronie.
• Użyj szyfrowania HTTPS z ważnym certyfikatem, aby mieć pewność, że dane użytkownika są bezpiecznie przesyłane.
• Zadbaj o dostępność stron logowania i rejestracji przez co najmniej 99,9% czasu.

Oprócz spełnienia powyższych wymagań zalecamy też zezwolenie użytkownikom zarejestrować się w programie lojalnościowym bez wypełniania żadnego formularza ani akceptacja warunków korzystania z usługi.

• Korzystając z danych użytkownika z SharedDataType, możesz utworzyć konto i od razu odrzucić kartę lojalnościową.
• Następnie możesz wysłać użytkownikowi e-maila z hasłem jednorazowym lub linkiem aby skonfigurować swoje hasło i opcjonalne szczegóły konta.
• Zmniejsza to ryzyko rezygnacji użytkownika z procesu rejestracji. Każdy dodatkowy krok może doprowadzić do rezygnacji.

Wyświetlając stronę logowania lub rejestracji, Portfel Google utworzy komponent WebView Androida i do podanych przez Ciebie danych wysyłane jest żądanie POST. Adres URL. Dane użytkownika są przekazywane w parametrze SharedDataType zawarte w żądaniu POST za pomocą funkcji application/x-www-form-urlencoded to typ treści Kodowanie UTF-8. Wartość atrybutu SharedDataType jest obiektem JSON zakodowanym w formacie Base64.

Uwaga: ciąg znaków JSON jest najpierw kodowany w standardzie UTF-8, a następnie zakodowane przy użyciu android.util.Base64 z opcjami NO_WRAP i URL_SAFE. Odpowiada to RFC 3548 (sekcja 4).

Zależnie od działania wybranego przez użytkownika i wybranych pól do żądania użytkownika, obiekt JSON może zawierać poniższe pola.

Pole	Rejestracja
e-mail	✓
firstName	✓
lastName	✓
addressLine [1–3]	✓
city	✓
stan	✓
kod pocztowy	✓
country	✓
telefon	✓

Uwaga: żadne z pól nie zawiera zawsze zawiera treści, a witryna musi umożliwiać użytkownikowi przejdź dalej, jeśli brakuje co najmniej 1 pola.

Uwaga: jeśli poprosisz o pole od użytkownika, użyj tych danych do wstępnego wypełnienia formularza.

Poniżej znajdziesz zdekodowany przykładowy obiekt JSON zawarte w dokumencie SharedDataType.

Zasób

{
  "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"
}

Wdrożenie natychmiastowego odsyłania karty lojalnościowej do Portfela Google

Po uwierzytelnieniu (zalogowaniu się) lub po utworzeniu konta (rejestracji) strona natychmiast odesłać kartę lojalnościową użytkownika do Portfela Google.

Uwaga: nie wdrażaj przycisku Google Wallet API Użytkownicy powinni zostać przeniesieni z powrotem do Portfela Google bez dodatkowej interakcji ze strony użytkownika.

Aby odesłać kartę lojalnościową do Portfela Google, przekieruj użytkownika na który ma taką strukturę.

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

Uwaga: pamiętaj o Na końcu dodaj znak „/” w adresie URL przed tokenem JWT.

Uwaga: tokeny JWT nie są zaszyfrowane. Uwzględnij tylko dane w precyzyjnym linku, które można udostępniać jako zwykły tekst.

Bezpieczna długość adresu URL to 2000 znaków. Linki powinny nie przekraczają tego limitu. Obiekty zakodowane w tokenach JWT powinny być małe i zawierać tylko charakterystycznych dla danego użytkownika. Postaraj się zachować większość danych w klasie obiektu, przed użyciem tokena JWT. W przypadku większych obiektów, które nie mieszczą się w limicie, weź pod uwagę najpierw tworzymy obiekt w Interfejs Google Wallet API i wysyłając tylko identyfikator obiektu w tokenie JWT.

Typowy przepływ komunikacji

Przebieg komunikacji użytkownika kończącego rejestrację lub logowania się został przedstawiony na ten obraz. Wszystkie działania między Twoim serwerem to Ty ponosisz odpowiedzialność za ich wdrożenie.

Poproś o weryfikację i aktywację

Po zakończeniu prac programistycznych i przetestowaniu procesów rejestracji/logowania prześlij prośbę przez Skontaktuj się z zespołem pomocy Konsoli Google Pay i Portfela Google widżet.

Po pełnym sprawdzeniu implementacji potwierdziliśmy jej prawidłowe działanie w połączeniu z aplikacją Portfel Google, funkcja rejestracji/logowania się w programie lojalnościowym będzie już publicznie dostępne w Twoim programie lojalnościowym. Dzięki temu każdy użytkownik będzie mógł zobaczyć programu i korzystania z tej funkcji.

Aby zapewnić optymalną wygodę użytkowników, będziemy regularnie sprawdzać rejestrację lub logowanie Odbędzie się ich wdrożenie, aby zapewnić stałą zgodność z wymaganiami tej funkcji. Otrzymasz powiadomienie w przypadku rozbieżności oraz funkcji logowania/rejestracji może być wyłączona do czasu rozwiązania problemu.

Najczęstsze pytania

• Czy obrazy w moim programie lojalnościowym muszą spełniać jakieś wymagania?
  • Tak, Twoje zdjęcia powinny być przechowywane w HTTPS lokalizacji ponieważ nie będą widoczne w Portfelu Google.
• Czy są dostępne narzędzia, które ułatwiają wdrażanie i debugowanie tokenów JWT?
  • Tak, platformy takie jak www.jwt.io umożliwia dekodowanie i debugować tokeny w trakcie programowania. Pozwala to zweryfikować przesyłanych treści. Google nie ma powiązania z innymi firmami i nie konkretnie polecić którąkolwiek z tych firm zewnętrznych.
• Jak zapewniamy poprawną obsługę danych SharedDataType zakodowanych w standardzie Base64?
  • Sprawdź, czy w całym procesie używasz kodowania UTF-8. Ciąg JSON jest najpierw kodowane w formacie UTF-8, a następnie android.util.Base64 z opcjami NO_WRAP i URL_SAFE. Odpowiada to RFC 3548 (sekcja 4).