Weryfikacja adresu e-commerce

Cel

Ten dokument opisuje metody łączenia Autouzupełniania miejsc, interfejsu AddressValidation API 1 i Map w procesie płatności w e-commerce w celu rejestrowania adresów o wysokiej jakości.

Wymagania wstępne

Google zaleca zapoznanie się z tymi informacjami:

  • Autouzupełnianie miejsc w dokumentacji dla programistów kodu JavaScript.
    • Poznaj z technicznego punktu widzenia, jak działa autouzupełnianie miejsc i jakie są opcje jego implementacji.
  • Przewodnik po implementacji autouzupełniania w miejscu.
    • Przykłady sprawdzonych metod implementacji autouzupełniania miejsc w przypadku płatności e-commerce.
  • Dokumentacja usługi Address Validation API, ze szczególnym uwzględnieniem tworzenia logiki walidacji.
    • Dowiedz się, jak z technicznego punktu widzenia działa interfejs API weryfikacji adresów, i zapoznaj się z sygnałami, które określają jakość adresu.

Co to jest weryfikacja adresu?

Interfejs Address Validation API to usługa, która akceptuje adres. identyfikuje i weryfikuje elementy 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 potrzebna jest weryfikacja 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 adresu dostarcza informacji o ogólnej jakości adresu, wprowadza poprawki, takie jak standaryzacja i poprawki pisowni, oraz ulepsza metadane, np. podając wskaźnik adresu zamieszkania lub adresu firmowego (dostępne w wybranych regionach).

Omówienie implementacji

W tej sekcji opisujemy zalecany proces wprowadzania 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

Wdrożyć Autouzupełnianie miejsc za pomocą interfejsu JavaScript API w pierwszym wierszu formularza adresu.

Autouzupełnianie miejsc wyświetla klientom sugestie podczas wpisywania przez nich adresu. Gdy interfejs JavaScript API jest wdrożony, gdy użytkownicy zaczną pisać, w polu formularza adresu pojawi się menu z wynikami z usługi Autouzupełniania, które aktualizują się po każdym naciśnięciu klawisza. Gdy użytkownik wprowadzi wystarczającą ilość informacji, aby znaleźć adres, może go wybrać z menu. To działanie automatycznie wypełnia pola formularza danymi adresu.

Dzięki funkcji Autouzupełnianie miejsc możesz udostępnić użytkownikowi 2 style wprowadzania danych: wyświetlanie wszystkich pól adresu lub wyświetlanie pojedynczego pola do wprowadzania danych. To pojedyncze pole danych umożliwia użytkownikowi rozpoczęcie wyszukiwania w miarę wpisywania, zamiast wpisywania poszczególnych elementów adresu osobno. Gdy autouzupełnianie wypełni adres, przepływ pracy rozszerzy pola formularza o dane adresu, co pozwoli klientowi sprawdzić i wprowadzić zmiany, np. dodać numer mieszkania.

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 do weryfikacji adresów

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. Po kliknięciu przez użytkownika przycisku Dalej lub Dalej w formularzu adresu wywołaj interfejs API weryfikacji adresu. 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

W dalszej części tego dokumentu omawiamy scenariusze akceptacji adresów.

Krok 3. Podaj potwierdzenie wizualne

Po wpisaniu adresu wyświetl użytkownikowi wizualne potwierdzenie lokalizacji dostawy 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.

Interfejs Maps JavaScript API udostępnia interaktywną mapę do wyświetlania lokalizacji użytkownika. Maps Static API umożliwia umieszczanie obrazów na stronie internetowej lub w późniejszym czasie w e-mailu.

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

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

  • Rozwiązanie: adres jest niskiej jakości. Powinieneś poprosić o dodatkowe informacje.
  • Potwierdź – adres jest wysokiej jakości, ale różni się od adresu podawanego na wejściu. 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

W tej sekcji dowiesz się, jak poprawić dane adresowe. 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ź interfejsu Address Validation API wskazuje nieprawidłowy adres, przekieruj klienta do formularza wprowadzania adresu, aby sprawdzić wprowadzone dane. Gdy adres zostanie poprawiony, usługa powinna ponownie przesłać go do interfejsu AddressValidationAPI, aby sprawdzić, czy wprowadzone poprawki są poprawne.

Możesz też wyróżnić konkretne błędy w adresie, używając 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 zwracanych przez interfejs Address Validation API, które wskazują, że adres powinien zostać potwierdzony, znajdziesz w dokumentacji Potwierdzanie adresu w sekcji Tworzenie logiki weryfikacji.

System często wymaga od użytkownika potwierdzenia adresu. Na przykład klient źle wpisuje nazwę miasta, która zostanie następnie poprawiona przez interfejs API do sprawdzania poprawności adresów. Należy potwierdzić tę poprawkę u klienta. Dzieje się tak, ponieważ zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić pierwotnie wpisane informacje.

Użyj modalnego ekranu pośredniego, aby wyświetlić informacje klientowi i zapewnić mu 3 opcje dalszego działania:

  1. Potwierdź adres zwrócony przez interfejs API, a proces płatności będzie kontynuowany z użyciem poprawionego adresu.
  2. Wybierz adres w pierwotnej formie, ignorując poprawki z interfejsu Address Validation API. Proces płatności może przebiegać normalnie, a zamówienie może zostać oznaczone do sprawdzenia przed wysyłką (jeśli pozwala na to Twój proces).
  3. Klient anuluje lub zamyka okno modalne, co powoduje powrót do etapu wprowadzania adresu w procesie płatności, gdzie może ponownie wpisać adres od początku, rozpoczynając proces od nowa.

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

Akceptuj

Z tej sekcji dowiesz się, jak zaakceptować adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Validation API, które wskazują, że adres jest wysokiej jakości i należy go zaakceptować, znajdziesz w sekcji Akceptowanie adresu w dokumentacji 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życie danych adresu zwróconych przez interfejs API weryfikacji adresu w porównaniu z danymi zamówienia, ponieważ mogą one zawierać drobne poprawki i uzupełnienia, takie jak:

  • Użycie wielkich liter
  • korekty formatowania,
    • Street to St
    • prawidłowe uporządkowanie elementów adresu;
  • ZIP+4 w Stanach Zjednoczonych.

Uwagi o wdrażaniu

Podczas tworzenia logiki akceptacji adresu upewnij się, że implementacja nie blokuje możliwości dokonania płatności przez klientów z powodu wpisania nieprawidłowego adresu. Stwórz logikę w taki sposób, aby zapobiec możliwości nieskończonej pętli, jeśli interfejs API wielokrotnie wskazuje, że wpis jest nieprawidłowy.

Google zaleca, by zapewnić klientom maksymalnie 2 szanse na wpisanie adresu. Przy drugiej próbie jej wprowadzenie, nawet jeśli nie jest on zweryfikowany. Przy drugiej próbie chcemy umożliwić kontynuowanie niezależnie od weryfikacji.

2 sugerowane metody akceptowania drugiej metody:

  • Wymuszenie kontynuacji: wyświetlanie klientowi modala z informacją, że adres nie jest prawidłowy, ale umożliwienie kontynuowania procesu 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ł nieprawidłowe adresy, tak aby przedstawiciel obsługi klienta mógł je sprawdzić, zanim zamówienie zostanie wysłane. Ten dodatkowy środek pozwala wychwycić ewentualne błędy.

Budowa nowego budynku to dobry przykład, dlaczego warto stosować tę kontrolę. Między momentem zakończenia 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 na stronę płatności z wpisanym adresem, nawet jeśli nie zostanie on zaakceptowany.

Po zakończeniu sesji płatności możesz opcjonalnie użyć metody provideValidationFeedback, aby wysłać do Google opinię na temat konkretnej próby walidacji adresu.

Podsumowanie

Ten dokument zawiera omówienie procesu płatności z wykorzystaniem Autouzupełniania, weryfikacji adresu i wizualnej weryfikacji na Mapach Google. Ten dokument może posłużyć jako punkt wyjścia do zaprojektowania implementacji zgodnie z zalecanymi metodami wprowadzania adresów.

Następne kroki

Pobierz biały papier dotyczący poprawy procesu płatności, dostawy i operacji dzięki wiarygodnym adresom i obejrzyj webinar dotyczący poprawy procesu płatności, dostawy i operacji dzięki weryfikacji adresów .

Sugerowane materiały do dalszego zapoznania się z tematem:

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®. ↩