Weryfikacja adresu e-commerce

Cel

W tym dokumencie opisujemy metody łączenia Autouzupełniania miejsc, interfejsu Address Validation API1 i Map w procesie płatności w e-commerce w celu uzyskiwania wysokiej jakości adresów.

Wymagania wstępne

Google zaleca zapoznanie się z tymi informacjami:

  • Dokumentacja dla programistów dotycząca usługi Autouzupełnianie miejsc w JavaScript.
    • Dowiedz się z technicznego punktu widzenia, jak działa autouzupełnianie miejsc i jakie są opcje jego wdrożenia.
  • Przewodnik po implementacji płatności w przypadku autouzupełniania miejsc.
    • Przykłady sprawdzonych metod wdrażania autouzupełniania miejsc na stronie płatności w sklepie internetowym.
  • Dokumentacja produktu Address Validation API, w której znajdziesz informacje o tworzeniu logiki weryfikacji.
    • Poznaj od strony technicznej działanie interfejsu Address Validation API i sprawdź sygnały, które określają jakość adresu.

Na czym polega weryfikacja adresu?

Address Validation API to usługa, która akceptuje adres. Identyfikuje komponenty adresu i je weryfikuje. Standaryzuje też adres na potrzeby wysyłki pocztą i znajduje dla niego najlepsze znane współrzędne długości i szerokości geograficznej. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system CASS™.

Dlaczego podczas płatności muszę potwierdzić adres?

Zbieraj dokładne adresy podczas procesu składania zamówienia:
Jest to ważny krok, który zwiększa skuteczność dostaw, terminowość realizacji zamówień i zmniejsza koszty związane z korektą adresu.

Pomóż klientom szybko i dokładnie wpisać adres:
Autouzupełnianie miejsca przyspiesza wpisywanie adresu i zmniejsza liczbę błędów, dzięki czemu klienci mogą łatwo przejść przez proces płatności. Weryfikacja adresu przekazuje informacje zwrotne na temat 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 prywatnego lub komercyjnego (dostępne w wybranych regionach).

Omówienie wdrożenia

W tej sekcji opisujemy zalecany proces wpisywania adresu podczas płatności w sklepie internetowym. Proces ten składa się z 3 etapów:

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

Następnie szczegółowo omówimy każdy krok.

Krok 1. Wprowadzanie adresu – korzystanie z usługi Autouzupełnianie miejsc

Wdróż automatyczne uzupełnianie miejsca za pomocą interfejsu JavaScript API w pierwszym wierszu formularza wpisywania adresu.

Autouzupełnianie miejsca podaje klientowi sugestie podczas wpisywania szczegółów adresu. Gdy użytkownicy zaczną wpisywać tekst, pod polem formularza adresu pojawi się menu z wynikami z usługi Autocomplete, które będą się aktualizować po każdym naciśnięciu klawisza. Gdy użytkownik wpisze wystarczającą ilość informacji, aby znaleźć adres, wybiera go z menu. Spowoduje to automatyczne wypełnienie pól formularza danymi adresu.

Użytkownikowi możesz udostępnić 2 style wpisywania w formularzu za pomocą autouzupełniania miejsc: wyświetlanie wszystkich pól adresu lub wyświetlanie jednego pola wejściowego. To pojedyncze pole do wpisywania danych zachęca użytkownika do rozpoczęcia wyszukiwania w trakcie pisania, zamiast wpisywania poszczególnych elementów adresu. Gdy autouzupełnianie wypełni adres, przepływ pracy rozszerzy pola formularza o dane adresu, umożliwiając klientowi sprawdzenie i wprowadzenie zmian, np. dodanie numeru mieszkania lub lokalu.

Oto przykład, jak może wyglądać ten proces z użyciem jednego pola wejściowego:

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 podczas płatności, aby potwierdzić, że adres jest prawidłowy i kompletny. Wywołaj interfejs 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 interfejsu Address Validation API w przypadku każdej transakcji.

Na diagramie poniżej przedstawiono przykład kompleksowej integracji interfejsu Address Validation API w procesie płatności:

obraz

Scenariusze akceptacji adresu omówimy w dalszej części tego dokumentu.

Krok 3. Prześlij potwierdzenie wizualne

Po wpisaniu adresu wyświetl użytkownikowi wizualne potwierdzenie miejsca dostawy na mapie. Daje to klientowi dodatkową pewność, że adres jest prawidłowy, i zmniejsza liczbę nieudanych dostaw lub odbiorów.

Mapa może być wyświetlana podczas procesu płatności lub wysyłana w e-mailu z potwierdzeniem transakcji. Oba te przypadki użycia można zrealizować za pomocą tych interfejsów API:

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

Szczegółowe informacje o scenariuszach akceptacji adresu

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

  • Popraw – adres jest niskiej jakości. Poproś o więcej informacji.
  • Potwierdź – adres jest wysokiej jakości, ale różni się od adresu wejściowego. Możesz poprosić o potwierdzenie.
  • Accept (Zaakceptuj) – adres jest wysokiej jakości. Możesz zaakceptować podany adres.

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

Napraw

obraz

W tej sekcji dowiesz się, jak poprawić wpisany adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Validation API, które wskazują na niską jakość adresu, znajdziesz w sekcji Poprawianie adresu w dokumentacji dotyczącej tworzenia logiki weryfikacji.

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

Możesz też wyróżnić konkretne błędy w wierszu adresu, korzystając z 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 interfejs Address Validation API zwraca, aby wskazać, że adres powinien zostać potwierdzony, znajdziesz w sekcji Potwierdzanie adresu w dokumentacji dotyczącej tworzenia logiki weryfikacji.

Często system będzie prosić użytkownika o potwierdzenie adresu. Na przykład klient może popełnić błąd w pisowni nazwy miasta, który zostanie poprawiony przez interfejs Address Validation API. Powinieneś/powinnaś potwierdzić z klientem, że problem został rozwiązany. Dzieje się tak, ponieważ zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić to, co zostało pierwotnie wpisane.

Użyj okna modalnego z reklamą pełnoekranową, aby wyświetlić informacje klientowi, umożliwiając mu wybór 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 formie, ignorując poprawkę z interfejsu Address Validation API. Proces płatności może przebiegać normalnie, a zamówienie może zostać oznaczone do dalszego sprawdzenia przed wysyłką, jeśli Twój proces na to pozwala.
  3. Klient anuluje lub zamyka okno, wracając do etapu wprowadzania adresu w procesie płatności, gdzie może ponownie wpisać adres od zera, rozpoczynając proces od nowa.

Przykład tego rodzaju treści można zobaczyć na zrzucie ekranu po prawej stronie.

Zaakceptuj

W tej sekcji dowiesz się, jak zaakceptować adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Validation API, które wskazują, że adres jest dobrej jakości i powinien zostać zaakceptowany, znajdziesz w sekcji Akceptowanie adresu w dokumentacji Tworzenie logiki weryfikacji.

W takim przypadku 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 prawidłowy i można na niego dostarczyć przesyłkę.

Zalecamy porównanie danych adresu zwróconych przez interfejs Address Validation API z zamówieniem, ponieważ mogą one zawierać drobne poprawki i dodatki, takie jak:

  • Użycie wielkich liter
  • Korekty formatowania, np.
    • Street to St
    • Prawidłowa kolejność elementów adresu
  • ZIP+4 w USA.

Uwagi o wdrażaniu

Podczas tworzenia logiki akceptacji adresu upewnij się, że wdrożenie nie blokuje klientom możliwości dokonania 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 umożliwić klientom dwukrotne wpisanie adresu. Przy drugiej próbie zaakceptuj wpis, nawet jeśli nie zostanie on zweryfikowany. W drugiej próbie celem jest umożliwienie użytkownikowi przejścia dalej niezależnie od wyniku weryfikacji.

Dwa sugerowane sposoby zaakceptowania drugiej próby:

  • Wymuś kontynuację: wyświetl klientowi okno z informacją, że adres nie jest prawidłowy, ale zezwól na kontynuowanie z wpisanym adresem.
  • Ciche akceptowanie: automatyczne akceptowanie drugiej próby bez etapu potwierdzenia, nawet jeśli adres nie zostanie w pełni zweryfikowany.

Jeśli to możliwe, zaprojektuj system tak, aby oznaczał adresy, które nie zostały zweryfikowane, aby pracownik obsługi klienta mógł je sprawdzić przed wysłaniem zamówienia. Ten dodatkowy krok pozwoli Ci wychwycić wszelkie błędy.

Budowa nowego budynku to dobry przykład, dlaczego zalecamy ten test. Między ukończeniem budowy nowego budynku a pojawieniem się jego adresu w bazach danych adresów pocztowych może upłynąć trochę czasu. Klienci powinni mieć możliwość przejścia do strony płatności z wpisanym adresem, nawet jeśli nie zostanie on zweryfikowany.

Po zakończeniu sesji płatności możesz użyć metody provideValidationFeedback do wysłania do Google opinii o konkretnej próbie weryfikacji adresu.

Podsumowanie

W tym dokumencie przedstawiliśmy przegląd procesu płatności z implementacją funkcji autouzupełniania, weryfikacji adresu i wizualnego potwierdzenia na mapie Google. Skorzystaj z tego dokumentu jako punktu wyjścia do zaprojektowania wdrożenia, postępując zgodnie z zalecanymi ścieżkami wprowadzania adresu.

Następne kroki

Pobierz białą księgę na temat usprawniania procesu płatności, dostawy i działań dzięki wiarygodnym adresom i obejrzyj webinar na temat usprawniania procesu płatności, dostawy i działań dzięki weryfikacji adresu .

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. Poniższe znaki towarowe są własnością United States Postal Service® i są używane za zgodą tej firmy: CASS™, USPS®, DPV®. ↩