Weryfikacja adresu e-commerce

Cel

W tym dokumencie opisujemy metody łączenia w procesie płatności e-commerce autouzupełniania miejsc, interfejsu AddressValidation API1 i Map Google, które pozwalają uzyskiwać adresy o wysokiej jakości.

Wymagania wstępne

Google zaleca znajomość następujących zagadnień:

Na czym polega weryfikacja adresu?

Interfejs Address Verification API to usługa, która akceptuje adres. Określa i weryfikuje komponenty adresu. Standaryzuje też adres do wysyłki i znajduje najbardziej znane dla niego 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 wymagana jest weryfikacja adresu?

Zbieraj dokładne adresy podczas składania zamówienia:
Jest to ważny krok na drodze do tego, by zadbać o dostawy, zwiększyć terminową realizację zamówień i obniżyć koszty związane z korygowaniem adresu.

Pomóż klientom szybko i poprawnie wpisać adres:
Autouzupełnianie przyspiesza wpisywanie adresu i zmniejsza liczbę błędów podczas wpisywania, dzięki czemu klienci mogą łatwo przejść przez proces płatności. Weryfikacja adresu zapewnia opinię o ogólnej jakości adresu, wprowadza poprawki takie jak standaryzacja i błędy w pisowni, a także ulepsza metadane, np. podając wskaźnik zamieszkania lub komercyjnego (dostępny w wybranych regionach).

Przegląd implementacji

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

  1. Użyj autouzupełniania miejsca, aby początkowo zarejestrować adres.
  2. Użyj interfejsu Address Review API, aby potwierdzić wpisany adres.
  3. Wyświetlaj lokalizację wpisanego adresu na mapie, aby klienci mogli mieć pewność, że dostawa będzie bezpieczna.

Następnie omówimy każdy etap oddzielnie.

Krok 1. Proces wpisywania adresu – korzystanie z usługi autouzupełniania miejsc

Zaimplementuj autouzupełnianie miejsca przy użyciu interfejsu JavaScript API w pierwszym wierszu formularza podawania adresu.

Autouzupełnianie miejsc wyświetla sugestie klientom, gdy wpisują swoje dane adresowe. W przypadku wdrożenia za pomocą interfejsu JavaScript API, gdy użytkownicy zaczynają pisać, pod polem formularza do wpisania adresu pojawia się menu z wynikami z usługi autouzupełniania, które są aktualizowane po każdym naciśnięciu klawisza. Gdy użytkownik wpisze wystarczającą ilość informacji, aby znaleźć adres, może go wybrać w menu. To działanie spowoduje automatyczne wypełnienie pól formularza danymi adresowymi.

Dzięki autouzupełnianiu miejsc możesz zapewnić użytkownikowi dwa style wpisywania formularza: wyświetlacz ze wszystkimi polami adresowymi lub wyświetlacz z jednym polem do wprowadzania danych. Pojedyncze pole do wprowadzania tekstu powoduje, że użytkownik powinien rozpocząć wyszukiwanie już podczas pisania, zamiast wpisywać poszczególne składniki adresu. Gdy autouzupełnianie uzupełni adres, pola formularza będą mogły zawierać dane adresowe, co pozwoli klientowi sprawdzić i wprowadzić zmiany, np. dodać numer mieszkania lub lokalu.

Oto przykład, jak może wyglądać ten wzorzec z użyciem pojedynczego pola do wprowadzania danych:

obraz

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

Gdy użytkownik wpisze adres, Google zaleca wywołanie podczas płatności interfejsu Address Validation API, aby potwierdzić, że adres jest prawidłowy i kompletny. Wywoływanie wywołania interfejsu Address Verification API, gdy użytkownik kliknie przycisk Dalej lub Dalej w formularzu adresu. Zwykle prowadzi on do strony płatności.

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

Poniższy schemat procesu ilustruje przykładową, kompleksową integrację interfejsu Address Review API w procesie płatności:

obraz

W tym dokumencie omówiono scenariusze akceptowania adresów w dalszej części.

Krok 3. Prześlij wizualne potwierdzenie

Po podaniu adresu dostarcz użytkownikowi wizualne potwierdzenie miejsca dostawy przez wyświetlenie go na mapie. Zapewnia to klientowi dodatkową pewność, że adres jest prawidłowy, co zmniejsza liczbę nieudanych dostaw lub odbioru.

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

Interfejs Maps JavaScript API udostępnia interaktywną mapę, która wyświetla lokalizację użytkownika. Interfejs Maps Static API pozwala umieścić zdjęcie na stronie internetowej lub na późniejszym etapie w e-mailu.

Zaawansowane informacje – scenariusze akceptacji

Odpowiedzi interfejsu Billing API do weryfikacji można podzielić na 3 główne scenariusze:

  • Rozwiąż problem – adres jest niskiej jakości. Powinien pojawić się prośba o podanie dodatkowych informacji.
  • Potwierdź – adres jest wysokiej jakości, ale zmienił się w stosunku do adresu wejściowego. Możesz zobaczyć prośbę o potwierdzenie.
  • Akceptuj – adres jest wysokiej jakości. Możesz zaakceptować podany adres.

Ta koncepcja jest omówiona w sekcji Tworzenie logiki weryfikacji w dokumentacji interfejsu Address Verificationation API. Każdy scenariusz omówimy w tej sekcji.

Napraw

obraz

W tej sekcji dowiesz się, jak poprawić wpisany adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Billingation API w celu wskazania adresu o niskiej jakości znajdziesz w sekcji Naprawianie adresu w dokumentacji tworzenia logiki weryfikacyjnej.

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

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

Potwierdź

obraz

W tej sekcji dowiesz się, jak potwierdzić adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Billingation API w celu wskazania, że adres powinien zostać potwierdzony, znajdziesz w sekcji Potwierdzanie adresu w dokumentacji tworzenia logiki weryfikacyjnej.

System często prosi użytkownika o potwierdzenie adresu. Na przykład użytkownik błędnie wpisał nazwę miasta, co pozwoliłoby jej poprawić 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ć wprowadzone przez Ciebie treści.

Wyświetl informacje klientowi w reklamie pełnoekranowej. Dostępne są 3 opcje:

  1. Potwierdź adres zwrócony przez interfejs API, a proces płatności będzie kontynuowany, używając poprawnego adresu.
  2. Wybierz pierwotnie wpisany adres, ignorując poprawkę z interfejsu Address Verificationation API. Proces płatności może być kontynuowany w zwykły sposób, a jeśli jest to możliwe, zamówienie może zostać oznaczone do sprawdzenia przed wysyłką.
  3. Klient anuluje działanie lub wycofuje się z okna i przechodzi na etap podawania adresu podczas procesu płatności, gdzie może ponownie wpisać go od zera, zaczynając od początku.

Przykład można zobaczyć na zrzucie ekranu po prawej stronie.

Akceptuj

Ta sekcja pokazuje, jak zaakceptować adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Verificationation API, które wskazują, że adres ma dobrą jakość i powinien zostać zaakceptowany, znajdziesz w sekcji Akceptowanie adresu w dokumentacji tworzenia logiki weryfikacyjnej.

W tym scenariuszu proces płatności powinien przejść do następnego etapu, czyli prawdopodobnie przechwytywania płatności, bez żadnych pytań o jakość odpowiedzi. Interfejs API potwierdził, że adres wpisany przez klienta jest dobrej jakości i można go dostarczyć.

Zalecamy, aby zamiast zamówienia używać zwracanych danych adresowych z interfejsu Address Verification API, ponieważ mogą one zawierać drobne poprawki i uzupełnienia, na przykład:

  • Użycie wielkich liter
  • korekty formatowania, na przykład:
    • Ulica do ul.
    • Prawidłowa kolejność elementów adresu.
  • ZIP+4 w USA.

Uwagi o wdrażaniu

Tworząc logikę akceptowania adresów, upewnij się, że implementacja nie blokuje klientom możliwości płatności z powodu wprowadzenia nieprawidłowego adresu. Utwórz logikę w taki sposób, aby nie dopuścić do pętli nieskończonej, jeśli interfejs API wielokrotnie wskaże, że ich wpis jest nieprawidłowy.

Google zaleca, aby umożliwić klientom maksymalnie 2 próby wpisania adresu. Przy drugiej próbie trzeba zaakceptować ich wpis nawet wtedy, gdy nie uda się go zweryfikować. Przy drugim podejściu celem jest umożliwienie im kontynuowania bez względu na weryfikację.

2 sugerowane metody akceptowania drugiej próby:

  • Wymuszona procedura:pokaż klientowi okno modalne z wyjaśnieniem, że adres nie jest weryfikowany, ale zezwól na kontynuowanie pracy z wpisanym adresem.
  • Akceptowanie dyskretne: automatycznie akceptuj drugą próbę bez potwierdzania, nawet jeśli adres nie zostanie w pełni zweryfikowany.

Jeśli to możliwe, zaprojektuj swój system tak, aby oznaczał adresy, które nie przejdą weryfikacji, tak by przedstawiciel działu obsługi klienta mógł je sprawdzić przed wysłaniem zamówienia. Ten dodatkowy środek zapobiegawczy wychwytuje wszystkie błędy.

Budowa nowego budynku pozwala dobrze zrozumieć, dlaczego to rozwiązanie jest zalecane. Może upłynąć trochę czasu między zakończeniem budowy nowego budynku a dodaniem jego adresu w bazach danych pocztowych. Klienci powinni mieć możliwość wymuszenia przejścia na stronie płatności z wpisanym adresem, nawet jeśli ten 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 określonej próbie weryfikacji adresu.

Podsumowanie

Ten dokument zawiera omówienie procesu płatności z implementacją autouzupełniania, weryfikacji adresu i wizualnego potwierdzenia w Mapach Google. Wykorzystaj ten dokument jako punkt wyjścia podczas projektowania implementacji zgodnie z zalecanymi instrukcjami wpisywania adresu.

Dalsze kroki

Pobierz dokument Usprawnij proces płatności, dostawy i operacji dzięki wiarygodnym adresom i obejrzyj webinar o udoskonalaniu procesu płatności, dostawy i działań za pomocą weryfikacji adresów .

Sugerowana dalsza analiza:

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ńskiej poczty pocztowej. Następujące znaki towarowe należą do firmy United States Postal Service® i są używane za jej zgodą: CASSTM, USPS®, DPV®. ↩