Cel
Ten dokument opisuje metody łączenia Autouzupełniania miejsc, interfejsu AddressValidationAPI1 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 techniczne aspekty działania autouzupełniania miejsc i opcji jego implementacji.
- Przewodnik po implementacji autouzupełniania w miejscu.
- Przykłady sprawdzonych metod implementacji autouzupełniania miejsc w procesie płatności w witrynie e-commerce
- Dokumentacja interfejsu 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 decydują o jakości adresu.
Co to jest weryfikacja adresu?
Interfejs Address Validation API to usługa, która akceptuje adres. identyfikuje i weryfikuje elementy adresu; Standardyzuje też adres do wysyłki i znajduje dla niego najlepsze 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 obsługi dokładności kodowania (CASS™).Dlaczego podczas płatności potrzebna jest weryfikacja adresu?
Zbieranie dokładnych adresów podczas procesu zamawiania:
To ważny krok, który zwiększa szanse na udaną dostawę, poprawia terminową realizację zamówień i zmniejsza kosztowne opłaty za korektę adresu.
Pomóż klientom szybko i prawidłowo wpisywać adres:
Autouzupełnianie adresu przyspiesza wpisywanie adresu i zmniejsza liczbę błędów podczas wprowadzania danych, dzięki czemu klienci mogą łatwo przejść przez proces 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:
- Użyj autouzupełniania miejsc, aby początkowo zarejestrować adres.
- Użyj interfejsu Address Validation API, aby potwierdzić wpisany adres.
- wyświetlać na mapie lokalizację wpisanego adresu, aby zapewnić klientom pewność dostawy;
Następnie omówimy każdy z tych kroków z osobna.
Krok 1. Proces wprowadzania adresu – korzystanie 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, wybierze go z menu. To działanie automatycznie wypełnia pola formularza danymi adresu.
Dzięki funkcji autouzupełniania adresu 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 tekstu, zamiast wpisywania poszczególnych elementów adresu osobno. Gdy autouzupełnianie wypełni adres, przepływ pracy rozszerzy pola formularza o dane adresowe, co pozwoli klientowi przejrzeć i wprowadzić poprawki, np. dodać numer mieszkania.
Oto przykład tego, jak może wyglądać ten proces, gdy używasz pojedynczego pola wejściowego:
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.
Ten schemat przepływu danych przedstawia przykład pełnej integracji interfejsu Address Validation API w procesie płatności:
W dalszej części tego dokumentu omawiamy scenariusze akceptacji adresu.
Krok 3. Podaj potwierdzenie wizualne
Po wpisaniu adresu wyświetl użytkownikowi wizualne potwierdzenie lokalizacji dostawy, pokazując ją na mapie. Daje to klientowi dodatkową pewność, że adres jest prawidłowy, i zmniejsza liczbę niepowodzeń dostawy lub odbioru.
Mapę można wyświetlić w trakcie 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.
Interfejs Maps JavaScript API udostępnia interaktywną mapę z lokalizacją użytkownika. | Maps Static API umożliwia umieszczanie obrazów na stronie internetowej lub w późniejszym czasie w e-mailu. |
---|---|
![]() |
![]() |
Szczegółowe omówienie – scenariusze akceptacji adresu
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że pojawić się prośba o potwierdzenie.
- Zaakceptuj – adres jest wysokiej jakości. Możesz zaakceptować podany adres.
Ta koncepcja jest opisana w sekcji Tworzenie logiki weryfikacji w dokumentacji interfejsu Address Validation API. W tej sekcji omówimy poszczególne scenariusze.
Napraw
Z tej sekcji dowiesz się, jak poprawić adres. Informacje o konkretnych sygnałach zwracanych przez interfejs Address Validation API, które wskazują na niską jakość adresu, znajdziesz w dokumentacji Popraw adres w sekcji Tworzenie logiki 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ą prawidłowe.
Możesz też wyróżnić konkretne błędy w adresie, korzystając z sygnałów zwracanych na poziomie addressComponents
. Przykład takiej sytuacji przedstawia zrzut ekranu po prawej stronie.
Potwierdź
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.
Często system będzie chciał poprosić użytkownika o potwierdzenie adresu. Na przykład klient źle wpisuje nazwę miasta, którą interfejs API sprawdzania adresów poprawia. Potwierdź tę poprawkę u klienta. Dzieje się tak, ponieważ zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić pierwotnie wprowadzone dane.
Użyj modala z przerywką, aby wyświetlić informacje klientowi, oferując mu 3 opcje:
- Potwierdź adres zwrócony przez interfejs API, a proces płatności będzie kontynuowany z wykorzystaniem poprawionego adresu.
- 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 dalszej weryfikacji przed wysyłką (jeśli pozwala na to Twój proces).
- 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 takiej sytuacji można zobaczyć 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 scenariuszu proces płatności powinien przejść do następnego etapu, którym jest prawdopodobnie pobranie płatności, bez żadnych próśb do klienta dotyczących jakości adresu. Interfejs API potwierdził, że adres wpisany przez klienta jest dobrej jakości 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;
- Kod pocztowy 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, aby dać klientom maksymalnie 2 możliwości wpisania adresu, a przy drugiej próbie zaakceptować wpis, nawet jeśli nie jest on prawidłowy. Druga próba ma na celu umożliwienie kontynuowania niezależnie od weryfikacji.
Oto 2 sposoby zaakceptowania drugiej próby:
- Wymuszenie kontynuacji: wyświetl klientowi okno modalne z informacją, że adres nie jest prawidłowy, ale zezwól na kontynuowanie z wpisanym adresem.
- Automatyczne zatwierdzenie: automatyczne zatwierdzenie drugiej próby bez 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 spełniają kryteriów, aby przedstawiciel obsługi klienta mógł je sprawdzić przed wysłaniem zamówienia. Dzięki temu możesz wykryć wszelkie błędy.
Budowa nowego budynku to dobry przykład, dlaczego warto stosować tę kontrolę. Od momentu ukończenia budowy nowego budynku do momentu uzupełnienia adresu tego budynku w bazach danych adresów pocztowych może upłynąć pewien czas. 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 funkcji Autouzupełniania, weryfikacji adresu i wizualnej weryfikacji na Mapach Google. Użyj tego dokumentu jako punktu wyjścia do zaprojektowania implementacji, korzystając z zalecanych procesów wprowadzania adresów.
Następne kroki
Pobierz białe papier dotyczące 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:
- Dokumentacja autouzupełniania miejsc
- Dokumentacja interfejsu Address Validation API
- Raporty Google Maps Platform
Współtwórcy
Henrik Valve | Inżynier ds. rozwiązań
Thomas Anglaret | Inżynier ds. rozwiązań
Sarthak Ganguly | Inżynier ds. rozwiązań
-
Użytkownik niewyłączny United States Postal Service. Następujące znaki towarowe są własnością United States Postal Service® i są używane za zgodą: CASS™, USPS®, DPV®. ↩