Weryfikacja adresu e-commerce

Cel

Z tego dokumentu dowiesz się, jak łączyć autouzupełnianie miejsc, Address Validation API1 i Mapy w procesie płatności w e-commerce, aby uzyskiwać adresy wysokiej jakości.

Wymagania wstępne

Google zaleca zapoznanie się z tymi materiałami:

Na czym polega weryfikacja adresu?

Address Validation API to usługa, która przyjmuje adres. Identyfikuje komponenty adresu i weryfikuje je. Standaryzuje też adres na potrzeby wysyłki pocztą i znajduje dla niego najlepiej dopasowane współrzędne określające szerokość i długość geograficzną. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system CASS™ (Coding Accuracy Support System).

Dlaczego weryfikacja adresu jest potrzebna w procesie płatności?

Zbieraj dokładne adresy podczas procesu składania zamówienia:
jest to ważny krok, który zwiększa skuteczność dostaw, przyspiesza realizację zamówień i zmniejsza koszty związane z poprawianiem adresów.

Pomóż klientom szybko i dokładnie wpisać adres:
autouzupełnianie miejsc przyspiesza wpisywanie adresu i zmniejsza liczbę błędów, dzięki czemu klienci mogą łatwo przejść przez proces płatności. Weryfikacja adresów przekazuje informacje o ogólnej jakości adresu, wprowadza poprawki, takie jak standaryzacja i korekta błędów ortograficznych, oraz wzbogaca metadane, np. podając wskaźnik adresu domowego lub firmowego (dostępny w wybranych regionach).

Omówienie wdrożenia

W tej sekcji opisujemy zalecany proces wpisywania adresu w procesie płatności w e-commerce. Proces ten obejmuje 3 etapy:

  1. Użyj autouzupełniania miejsc, aby wstępnie uzyskać adres.
  2. Użyj Address Validation API, aby potwierdzić wpisany adres.
  3. Wyświetl lokalizację wpisanego adresu na mapie, aby zwiększyć zaufanie klientów do dostawy.

Teraz omówimy każdy etap osobno.

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

Zaimplementuj autouzupełnianie miejsc za pomocą interfejsu JavaScript API w pierwszym wierszu formularza wpisywania adresu.

Autouzupełnianie miejsc podaje sugestie klientowi podczas wpisywania szczegółów adresu. Gdy usługa jest zaimplementowana za pomocą interfejsu JavaScript API, po rozpoczęciu wpisywania przez użytkownika pod polem formularza wpisywania adresu pojawia się menu z wynikami 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, wybiera go z menu. Ta czynność automatycznie wypełnia pola formularza danymi adresu.

Możesz udostępnić użytkownikowi 2 style wpisywania w formularzu za pomocą Autouzupełniania miejsc: wyświetlanie wszystkich pól adresu lub wyświetlanie jednego pola do wprowadzania danych. To pojedyncze pole do wprowadzania danych zachęca użytkownika do rozpoczęcia wyszukiwania podczas wpisywania, zamiast wpisywania poszczególnych komponentów adresu. Gdy autouzupełnianie wypełni adres, proces rozszerzy pola formularza o dane adresu, umożliwiając klientowi sprawdzenie i edytowanie, np. dodanie numeru mieszkania lub lokalu.

Oto przykład, jak może wyglądać ten proces w przypadku użycia jednego pola do wprowadzania danych:

obraz

Krok 2. Użyj Address Validation API, aby sprawdzić poprawność adresów

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

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

Poniższy schemat blokowy przedstawia przykład pełnej integracji Address Validation API w procesie płatności:

obraz

W dalszej części tego dokumentu omówimy scenariusze akceptowania adresów.

Krok 3. 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ę nieudanych dostaw lub odbiorów.

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 zrealizować za pomocą tych interfejsów API.

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

Szczegółowe informacje – scenariusze akceptowania adresów

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

  • Popraw – adres jest niskiej jakości. Powinieneś/powinnaś poprosić o więcej informacji.
  • Potwierdź – adres jest wysokiej jakości, ale ma zmiany w stosunku do adresu wejściowego. Możesz poprosić o potwierdzenie.
  • Zaakceptuj – adres jest wysokiej jakości. Możesz zaakceptować podany adres.

Ten temat jest omówiony w sekcji Tworzenie logiki weryfikacji w dokumentacji Address Validation API. W tej sekcji omówimy każdy scenariusz.

Popraw

obraz

W tej sekcji dowiesz się, jak poprawić wpisany adres. Informacje o konkretnych sygnałach, które Address Validation API zwraca, aby wskazać adres niskiej jakości , znajdziesz w sekcji Poprawianie adresu w dokumentacji Tworzenie logiki weryfikacji.

Jeśli odpowiedź z Address Validation API wskazuje nieprawidłowy adres, przekieruj klienta do formularza wprowadzania adresu, aby sprawdził wpisane dane. Gdy adres zostanie poprawiony, usługa powinna ponownie wysłać go do Address Validation API, aby upewnić się, że wprowadzone poprawki są prawidłowe.

Możesz też wyróżnić konkretne błędy w wierszu adresu, używając sygnałów zwracanych na poziomie addressComponents. Przykład tego można zobaczyć na zrzucie ekranu po prawej stronie.

Potwierdź

obraz

W tej sekcji dowiesz się, jak potwierdzić adres. Informacje o konkretnych sygnałach, które Address Validation API zwraca, aby wskazać, że adres należy potwierdzić, znajdziesz w sekcji Potwierdzanie adresu w dokumentacji Tworzenie logiki weryfikacji.

Często system będzie prosić użytkownika o potwierdzenie adresu. Na przykład klient może popełnić błąd w nazwie miasta, który zostanie poprawiony przez Address Validation API. Powinieneś/powinnaś potwierdzić tę poprawkę u klienta. Wynika to z tego, że zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić to, co zostało pierwotnie wpisane.

Użyj modalnego okna z informacjami, aby wyświetlić informacje klientowi, umożliwiając mu wybranie jednej z 3 opcji:

  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 postaci, ignorując poprawkę z Address Validation API. Proces płatności może być kontynuowany normalnie, a zamówienie może zostać oznaczone do sprawdzenia przed wysyłką, jeśli Twój proces na to pozwala.
  3. Klient anuluje lub zamyka okno modalne, wracając do etapu wpisywania adresu w procesie płatności, gdzie może ponownie wpisać adres od początku, rozpoczynając proces od nowa.

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

Zaakceptuj

W tej sekcji dowiesz się, jak zaakceptować adres. Informacje o konkretnych sygnałach, które Address Validation API zwraca, aby wskazać, że adres jest dobrej jakości i należy go zaakceptować, znajdziesz w sekcji Akceptowanie adresu w dokumentacji Tworzenie logiki weryfikacji.

W tym scenariuszu proces płatności powinien przejść do następnego etapu, prawdopodobnie do pobrania płatności, bez wyświetlania klientowi żadnych komunikatów dotyczących jakości adresu. Interfejs API potwierdził, że adres wpisany przez klienta jest dobrej jakości i można go dostarczyć.

Zalecamy używanie danych adresu zwróconych przez Address Validation API w zamówieniu, ponieważ mogą one zawierać drobne poprawki i dodatki, takie jak:

  • użycie wielkich liter,
  • poprawki formatowania, np.
    • zamiana „Ulica” na „Ul.”,
    • poprawna kolejność komponentów adresu,
  • kod pocztowy 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 przejścia do procesu płatności z powodu wpisania nieprawidłowego adresu. Zbuduj logikę w taki sposób, aby zapobiec możliwości wystąpienia nieskończonej pętli, jeśli interfejs API wielokrotnie wskazuje, że wpis jest nieprawidłowy.

Google zaleca, aby dać klientom maksymalnie 2 szanse na wpisanie adresu, a przy drugiej próbie zaakceptować wpis, nawet jeśli nie przejdzie on weryfikacji. Przy drugiej próbie celem jest umożliwienie klientowi przejścia dalej niezależnie od weryfikacji.

2 sugerowane metody akceptowania drugiej próby:

  • Wymuszenie przejścia dalej: wyświetl klientowi okno modalne z informacją, że adres nie przechodzi weryfikacji, ale umożliwiające kontynuowanie z wpisanym adresem.
  • Cicha akceptacja: automatycznie zaakceptuj drugą próbę bez etapu potwierdzenia, nawet jeśli adres nie przejdzie pełnej weryfikacji.

Jeśli to możliwe, zaprojektuj system tak, aby oznaczał adresy, które nie przechodzą weryfikacji, aby pracownik obsługi klienta mógł je sprawdzić przed wysłaniem zamówienia. Ten dodatkowy środek zapewnia wykrycie wszelkich błędów.

Dobrym przykładem, dlaczego zalecamy to sprawdzenie, jest budowa nowego budynku. Może upłynąć trochę czasu między zakończeniem budowy nowego budynku a dodaniem jego adresu do baz danych adresów pocztowych. Klienci powinni mieć możliwość wymuszenia przejścia do strony płatności z wpisanym adresem, nawet jeśli nie przejdzie on weryfikacji.

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 weryfikacji adresu.

Podsumowanie

Z tego dokumentu dowiesz się, jak wygląda proces płatności, w którym zaimplementowano autouzupełnianie, weryfikację adresu i potwierdzenie wizualne na Mapach Google. Użyj tego dokumentu jako punktu początkowego do zaprojektowania implementacji, postępując zgodnie z zalecanymi procesami wpisywania adresu.

Następne kroki

Sugerowane dalsze lektury:

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 United States Postal Service. Następujące znaki towarowe należą do United States Postal Service® i są używane za zgodą: CASS™, USPS®, DPV®. ↩