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 techniczne aspekty działania autouzupełniania miejsc i opcje 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 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; Standardyzuje też adres do wysyłki i znajduje dla niego najdokładniejsze współrzędne szerokości i długości geograficznej. Opcjonalnie możesz włączyć System obsługi dokładności kodowania (CASS™) w przypadku adresów w Stanach Zjednoczonych i Portoryko.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 termin realizacji 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 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 osobno.
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łnianie adresu użytkownik może korzystać z 2 stylów wprowadzania danych: wyświetlania wszystkich pól adresu lub wyświetlania pojedynczego pola danych. To pojedyncze pole danych promptuje użytkownika do rozpoczęcia 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 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 adresów.
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ć 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.
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ółowe omówienie – scenariusze dotyczące 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 zawiera zmiany w porównaniu z adresem podanym we wpisie. 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, używając 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ó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 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żesz 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 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świetlanie klientowi modala z informacją, że adres nie jest prawidłowy, ale umożliwienie kontynuowania procesu 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 zakończenia budowy nowego budynku do momentu wypeł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. 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ł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 się z tematem:
- 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®. ↩