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 adresów o wysokiej jakości.

Wymagania wstępne

Google zaleca zapoznanie się z tymi informacjami:

  • Dokumentacja dla programistów interfejsu Place Autocomplete 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 w procesie płatności w sklepie internetowym.
  • Dokumentacja produktu Address Validation API, ze szczególnym uwzględnieniem tworzenia 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 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™.

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

Zbieraj dokładne adresy podczas procesu składania zamówienia:
Jest to ważny krok w promowaniu udanych dostaw, zwiększaniu terminowości realizacji zamówień i ograniczaniu kosztownych opłat za 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 przepływ pracy związany z wpisywaniem adresu podczas płatności w sklepie internetowym. Proces ten składa się z 3 etapów:

  1. Użyj funkcji automatycznego uzupełniania miejsca, aby na początku przechwycić adres.
  2. Użyj interfejsu API walidacji adresów, aby potwierdzić wprowadzony adres.
  3. Wyświetl lokalizację wprowadzonego adresu na mapie, aby dać klientom pewność co do dostawy.

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

Krok 1: Przepływ wprowadzania adresu — korzystanie z usługi automatycznego uzupełniania miejsca

Wdrożenie funkcji Umieść automatyczne uzupełnianie za pomocą interfejsu API JavaScript w pierwszym wierszu formularza wprowadzania adresu.

Funkcja automatycznego uzupełniania danych adresowych wyświetla klientowi sugestie w miarę wprowadzania przez niego danych adresowych. Po wdrożeniu za pomocą interfejsu API JavaScript, gdy użytkownik zaczyna wpisywać tekst, pod polem formularza wprowadzania adresu pojawia się lista rozwijana zawierająca wyniki usługi Autocomplete, aktualizowane po każdym naciśnięciu klawisza. Gdy użytkownik wprowadzi już wystarczającą ilość informacji, aby znaleźć adres, wybiera go z listy rozwijanej. Ta akcja automatycznie wypełnia pola formularza danymi adresowymi.

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 wpisywania tekstu, 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 przepływ przy użyciu pojedynczego pola wprowadzania danych:

obraz

Krok 2. Użyj interfejsu Address Validation API do weryfikacji adresów

Po wprowadzeniu adresu przez użytkownika Google zaleca wywołanie interfejsu API weryfikacji adresów podczas realizacji transakcji w celu potwierdzenia, że adres jest prawidłowy i kompletny. Wywołaj wywołanie interfejsu API weryfikacji adresów po kliknięciu przez użytkownika przycisku Dalej lub Kontynuuj w formularzu adresu. Ten przycisk często prowadzi do strony płatności.

Google zaleca wywoływanie interfejsu API walidacji adresów przy każdej transakcji.

Poniższy schemat blokowy ilustruje przykład kompleksowej integracji interfejsu API weryfikacji adresów w ramach realizacji transakcji:

obraz

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

Krok 3: Zapewnij wizualne potwierdzenie

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.

Głębokie nurkowanie – omówienie scenariuszy akceptacji

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.
  • Zaakceptuj – adres jest wysokiej jakości. Możesz zaakceptować podany adres.

Ten temat jest 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, które interfejs Address Validation API zwraca, aby wskazać adres o niskiej jakości, 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 wpisywania adresu, aby mógł sprawdzić wprowadzone 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 zwracanych przez interfejs Address Validation API, które wskazują, że adres powinien zostać potwierdzony, 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 pisowni nazwy miasta, który zostanie poprawiony przez interfejs Address Validation API. Powinieneś/powinnaś potwierdzić tę poprawkę z klientem. Dzieje się tak, ponieważ zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić pierwotnie wprowadzone dane.

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 formie, w jakiej został pierwotnie wpisany, ignorując poprawkę z interfejsu Address Validation API. Proces płatności może przebiegać normalnie, a zamówienie może zostać oznaczone do dalszej weryfikacji przed wysyłką, jeśli to umożliwia Twój proces.
  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 dobrej jakości 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 Stanach Zjednoczonych.

Uwagi o wdrażaniu

Podczas tworzenia logiki akceptowania 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, a przy drugiej próbie zaakceptować 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.

Dobrym przykładem, który pokazuje, dlaczego zalecamy ten test, jest budowa nowego budynku. 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®. ↩