Weryfikacja adresu e-commerce

Cel

W tym dokumencie opisujemy metody łączenia funkcji autouzupełniania miejsc, interfejsu Address Validation API1 i Map podczas procesu płatności e-commerce w celu rejestrowania adresów o wysokiej jakości.

Wymagania wstępne

Google zaleca zapoznanie się z tymi materiałami:

  • Dokumentacja dla deweloperów JavaScriptu dotycząca autouzupełniania.
    • Poznaj z technicznego punktu widzenia, jak działa autouzupełnianie miejsc i jakie są opcje jego implementacji.
  • Przewodnik po implementacji płatności dotyczący autouzupełniania miejsc.
    • Przykłady sprawdzonych metod implementacji autouzupełniania miejsc w przypadku płatności e-commerce.
  • Address Validation API Dokumentacja produktu, ze szczególnym uwzględnieniem tworzenia własnego sposobu walidacji.
    • Poznaj z technicznego punktu widzenia, jak działa interfejs Address Validation API, i przejrzyj sygnały decydujące o jakości adresów.

Na czym polega weryfikacja adresu?

Interfejs Address Validation API to usługa, która akceptuje adresy. Identyfikuje i weryfikuje składniki adresu. a także ustandaryzuje adres pocztowy i znajduje dla niego najbardziej znane współrzędne szerokości i długości geograficznej. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system wsparcia dokładności kodowania (CASSTM).

Dlaczego podczas płatności wymagane jest potwierdzenie adresu?

Zadbaj o dokładne adresy podczas składania zamówienia:
Jest to ważny krok na drodze do promowania pomyślnej dostawy, zwiększenia terminowości realizacji zamówień i obniżenia kosztownych opłat za korektę adresów.

Pomagaj klientom szybko i poprawnie wpisywać adres:
Autouzupełnianie miejsc przyspiesza wpisywanie adresów i zmniejsza liczbę błędów podczas wprowadzania danych, umożliwiając klientom łatwe przejście procesu płatności. Weryfikacja adresów dostarcza informacji o ogólnej jakości adresu, wprowadza korekty, np. pomyłki w standardzie i pisowni, oraz ulepsza metadane, np. przez podanie informacji o miejscach zamieszkania lub firmie (dostępne w wybranych regionach).

Omówienie implementacji

W tej sekcji opisujemy zalecany proces podawania adresu w przypadku płatności e-commerce. Proces składa się z 3 etapów:

  1. Użyj autouzupełniania miejsc, aby początkowo zarejestrować adres.
  2. Użyj interfejsu Address Validation API, aby potwierdzić wpisany adres.
  3. Wyświetlaj lokalizację podanego adresu na mapie, aby zapewnić klientom pewność, że dostawa zostanie zrealizowana.

Następnie omówimy każdy z nich z osobna.

Krok 1. Proces podawania adresu – korzystając z usługi autouzupełniania miejsc

Zaimplementuj funkcję autouzupełniania miejsc, korzystając z interfejsu JavaScript API w pierwszym wierszu formularza wpisywania adresu.

Autouzupełnianie miejsc wyświetla sugestie podczas wpisywania danych adresowych. Gdy wdrożysz kod za pomocą interfejsu JavaScript API, w miarę jak użytkownicy zaczną pisać, pod polem formularza z adresem pojawi się menu z wynikami usługi autouzupełniania, które aktualizują się po każdym naciśnięciu klawisza. Gdy użytkownik poda informacje potrzebne do znalezienia adresu, wybierze go w menu. To działanie powoduje automatyczne wypełnianie pól formularza danymi adresowymi.

Funkcja autouzupełniania pozwala udostępnić użytkownikowi dwa style wpisu w formularzu: widok ze wszystkimi polami adresu lub wyświetlacz z jednym polem do wprowadzania danych. To jedno pole do wprowadzania danych prosi użytkownika o rozpoczęcie wyszukiwania podczas pisania zamiast wpisywania poszczególnych elementów adresu. Gdy autouzupełnianie uzupełni adres, przepływ pracy rozszerza pola formularza o dane adresowe, dzięki czemu klient może je sprawdzić i wprowadzić zmiany, np. dodać numer mieszkania lub lokalu.

Oto przykład, jak może wyglądać ten przepływ przy użyciu jednego pola do wprowadzania danych:

obraz

Krok 2. Użyj interfejsu Address Validation API, aby zweryfikować adresy

Gdy użytkownik wpisze adres, Google zaleca wywołanie interfejsu Address Validation API w momencie płatności, aby potwierdzić, że adres jest prawidłowy i kompletny. Wywołaj interfejs Address Validation API, gdy użytkownik kliknie w formularzu adresu przycisk Dalej lub Dalej. Ten przycisk często prowadzi do strony płatności.

Google zaleca wywoływanie interfejsu Address Validation API w przypadku każdej transakcji.

Poniższy diagram przepływu przedstawia przykład kompleksowej integracji interfejsu Address Validation API w ramach procesu płatności:

obraz

Scenariusze rozmów omawiamy w dalszej części tego dokumentu.

Krok 3. Prześlij wizualne potwierdzenie

Po podaniu adresu udostępnij użytkownikowi wizualne potwierdzenie lokalizacji dostawy, wyświetlając ją na mapie. Daje to klientowi dodatkową pewność, że adres jest prawidłowy, i zmniejsza liczbę niepowodzeń związanych z dostawą lub odbiorem.

Mapę można wyświetlić podczas procesu płatności lub wysłać w e-mailu z potwierdzeniem transakcji. Oba te przypadki użycia można realizować, korzystając z poniższych interfejsów API.

Maps JavaScript API udostępnia interaktywną mapę do wyświetlania lokalizacji użytkownika. Maps Static API pozwala umieścić zdjęcie na stronie internetowej lub później w e-mailu.

Szczegółowa analiza – scenariusze dotyczące akceptacji rozwiązań

Odpowiedzi interfejsu Address Validation API można podzielić na 3 główne scenariusze:

  • Napraw – adres jest niskiej jakości. Powinna pojawić się prośba o podanie dodatkowych informacji.
  • Potwierdź – adres ma wysoką jakość, ale został zmieniony z podanego adresu. Możesz zobaczyć prośbę o potwierdzenie.
  • Akceptuj – adres jest wysokiej jakości. Możesz zaakceptować podany adres.

Tę koncepcję opisujemy w sekcji Tworzenie logiki walidacji w dokumentacji interfejsu Address Validation API. W tej sekcji omówimy każdy scenariusz.

Napraw

obraz

Z tej sekcji dowiesz się, jak poprawić adres. Informacje o konkretnych sygnałach, które interfejs Address Validation API zwraca w związku z adresem niskiej jakości, znajdziesz w sekcji Naprawianie adresu w dokumentacji dotyczącej logiki tworzenia weryfikacji.

Jeśli odpowiedź z interfejsu Address Validation API wskazuje na nieprawidłowy adres, przekieruj klienta do formularza wpisywania adresu, aby sprawdzić wpisane dane. Po poprawieniu adresu usługa powinna zostać ponownie wysłana do interfejsu AddressValidation API, aby sprawdzić, czy wprowadzone poprawki są prawidłowe.

Możesz też wyróżniać konkretne błędy w wierszu adresu, korzystając z sygnałów zwracanych na poziomie addressComponents. Przykład widać na zrzucie ekranu po prawej stronie.

Potwierdź

obraz

W tej sekcji dowiesz się, jak potwierdzić adres. Informacje o konkretnych sygnałach, które interfejs Address Validation API zwraca w celu potwierdzenia adresu, znajdziesz w sekcji Potwierdzanie adresu w dokumentacji dotyczącej logiki tworzenia weryfikacji.

System często wymaga od użytkownika potwierdzenia adresu. Na przykład klient błędnie wpisuje nazwę miasta, która zostanie poprawiona przez interfejs Address Validation API. Skontaktuj się z klientem, aby potwierdzić tę poprawkę. Dzieje się tak, ponieważ zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić pierwotnie wpisane informacje.

Użyj pełnoekranowego okna modalnego, aby wyświetlić informacje klientowi, z 3 opcjami przejścia dalej:

  1. Potwierdź adres zwrócony przez interfejs API, a proces płatności będzie kontynuowany z użyciem poprawionego adresu.
  2. Wybierz pierwotnie wpisany adres, ignorując korektę z interfejsu Address Validation API. Proces płatności przebiega w zwykły sposób, a zamówienie może zostać oznaczone do sprawdzenia przed wysyłką, jeśli jest to możliwe.
  3. Klient anuluje proces płatności lub wycofuje się, wracając do etapu wpisywania adresu w procesie płatności, gdzie może ponownie wpisać adres od zera i zacząć cały proces od początku.

Przykład widać na zrzucie ekranu po prawej stronie.

Akceptuj

W tej sekcji dowiesz się, jak zaakceptować adres. Informacje o konkretnych sygnałach, które interfejs Address Validation API zwraca, wskazując, że adres ma dobrą jakość i należy go zaakceptować, znajdziesz w sekcji Akceptowanie adresu w dokumentacji dotyczącej tworzenia logiki weryfikacji.

W tym przypadku proces płatności powinien przejść do następnego etapu, czyli prawdopodobnie pozyskania płatności, bez pytań dotyczących jakości. Interfejs API potwierdził, że adres podany przez klienta ma dobrą jakość i można go dostarczyć.

Zalecamy używanie danych zwróconych z interfejsu Address Validation API w porównaniu z zamówieniem, ponieważ może ono zawierać drobne poprawki i uzupełnienia, takie jak:

  • Użycie wielkich liter
  • korekty formatowania, na przykład:
    • Ulica i ul
    • Właściwa kolejność komponentów adresu
  • ZIP+4 w Stanach Zjednoczonych.

Uwagi o wdrażaniu

Podczas tworzenia logiki akceptowania adresów upewnij się, że implementacja nie blokuje klientom możliwości płatności z powodu wprowadzenia nieprawidłowego adresu. Skonstruować logikę w taki sposób, aby nie dopuścić do zapętlenia w nieskończoność, jeśli interfejs API wielokrotnie wskazuje nieprawidłowy wpis.

Google zaleca, aby zapewnić klientom maksymalnie 2 szanse na wpisanie adresu. Przy drugiej próbie ich zaakceptowanie powinno być możliwe, nawet jeśli nie zostanie on zweryfikowany. Przy drugiej próbie chcemy umożliwić kontynuowanie niezależnie od weryfikacji.

2 sugerowane metody akceptowania drugiej metody:

  • Wymuś dalej: wyświetl klientowi okno modalne z wyjaśnieniem, że adres nie jest weryfikowany, ale zezwól na kontynuowanie z wpisanym adresem.
  • Akceptacja cicha: automatycznie akceptuj drugą próbę bez potwierdzenia, nawet jeśli adres nie został w pełni sprawdzony.

Jeśli to możliwe, zaprojektuj system tak, aby oznaczał adresy, które nie zostały zweryfikowane, tak aby przedstawiciel obsługi klienta mógł je sprawdzić, zanim zamówienie zostanie wysłane. Ten dodatkowy środek pozwala wychwycić ewentualne błędy.

Nowa konstrukcja budynku dobrze ilustruje, dlaczego zalecamy takie sprawdzenie. Między zakończeniem budowy nowego budynku a dodaniem adresu budynku w bazach danych pocztowych może upłynąć trochę czasu. Klienci powinni mieć możliwość wymuszenia przejścia przez stronę płatności z wpisanym adresem, nawet jeśli adres nie został zweryfikowany.

Po zakończeniu sesji płatności możesz opcjonalnie użyć metody provideValidationFeedback, aby przesłać do Google opinię o próbie weryfikacji konkretnego adresu.

Podsumowanie

Ten dokument zawiera omówienie procesu płatności, w którym zaimplementowano autouzupełnianie, weryfikację adresu i wizualne potwierdzenie w Mapach Google. Wykorzystaj ten dokument jako punkt wyjścia przy projektowaniu implementacji zgodnie z zalecanymi procedurami wprowadzania adresu.

Dalsze kroki

Pobierz dokument Usprawnianie procesu płatności, dostawy i operacji dzięki niezawodnym adresom i obejrzyj webinar Usprawnianie procesu płatności, dostawy i operacji dzięki weryfikacji adresów .

Sugerujemy dodatkowe artykuły:

Współtwórcy

Henrik Valve | Inżynier ds. rozwiązań
Thomas Anglaret | Inżynier ds. rozwiązań
Sarthak Ganguly | Inżynier ds. rozwiązań

  1. Niewyłączny licencjobiorca amerykańskiego urzędu pocztowego. Następujące znaki towarowe należą do amerykańskiej poczty Postal Service® i są używane za zgodą: CASSTM, USPS®, DPV®. ↩