Cel
W tym dokumencie opisujemy metody łączenia funkcji autouzupełniania miejsc i adresów. interfejsu API weryfikacji1 i Map w procesie płatności e-commerce w celu: rejestrowanie adresów wysokiej jakości.
Wymagania wstępne
Google zaleca zapoznanie się z tymi materiałami:
- Autouzupełnianie JavaScriptu
dokumentację.
- Omówienie działania autouzupełniania miejsc z technicznego punktu widzenia oraz jak działają opcje implementacji.
- Przewodnik po implementacji płatności dla Miejsc
Autouzupełnianie.
- Przykłady sprawdzonych metod implementacji autouzupełniania miejsc na stronie procesu e-commerce.
- Interfejs API do weryfikacji adresów usługa
dokumentacja,
Skup się na tworzeniu walidacji
.
- Omówienie interfejsu Address Validation API z technicznego punktu widzenia i sprawdzać sygnały, które decydują o jakości adresów.
Na czym polega weryfikacja adresu?
Interfejs Address Validation API to usługa, która akceptuje adresy. Identyfikuje i weryfikuje składniki adresu. a także ustandaryzuje adresu pocztowego i znajdź dla niego najbardziej 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 wsparcia dokładności kodowania (Coding Dokładność Support System, CASSTM).Dlaczego podczas płatności wymagane jest potwierdzenie adresu?
Zbieraj poprawne adresy podczas składania zamówienia:
To ważny krok na drodze do skutecznej dostawy, zwiększenia terminowości
i pozwala uniknąć kosztownych opłat za korektę adresu.
Pokaż klientom, jak szybko i poprawnie wpisywać adres:
Autouzupełnianie pozwala przyspieszyć wprowadzanie adresów i zmniejszyć liczbę błędów podczas wprowadzania, dzięki czemu
aby klienci mogli łatwo przejść przez proces płatności. Weryfikacja adresu wysyła opinię
na ogólną jakość adresu i wprowadzenie poprawek, takich jak
błędów ortograficznych i wzbogacać metadane, np. o miejsce zamieszkania lub
wskaźnik komercyjny (dostępny w wybranych
regionów.
Omówienie implementacji
W tej sekcji opisujemy zalecany proces wprowadzania adresu w przypadku e-commerce. transakcji. 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świetlaj na mapie lokalizację podanego adresu, aby umożliwić dostawę i zadbać o wrażenia klientów.
Następnie omówimy każdy z nich z osobna.
Krok 1. Proces podawania adresu – korzystając z usługi autouzupełniania miejsc
Wdrożenie funkcji Place Autouzupełnianie używając interfejsu JavaScript API w pierwszym wierszu formularza wpisywania adresu.
Autouzupełnianie miejsc wyświetla sugestie podczas wpisywania dane adresowe. W przypadku implementacji za pomocą interfejsu JavaScript API w miarę używania aplikacji przez użytkowników w polu wpisywania adresu pojawi się menu z wynikami od usługi autouzupełniania, które aktualizują się po każdym naciśnięciu klawisza. Gdy użytkownik podał wystarczającą ilość informacji, aby znaleźć adres, wybiera go z listy . To działanie automatycznie wypełnia pola formularza adresem. i skalowalnych danych.
Dzięki funkcji autouzupełniania miejsca możesz udostępnić użytkownikowi dwa style wpisów w formularzu: ekran ze wszystkimi polami adresu lub z jednym elementem do wprowadzania danych . To pojedyncze pole do wprowadzania danych zachęca użytkownika do rozpoczęcia wyszukiwania zamiast wpisywać poszczególne elementy adresu. Po autouzupełnianiu wypełni adres, przepływ pracy uzupełni pola formularza o adres danych, dzięki czemu klient może sprawdzić i wprowadzić zmiany, np. dodać numer mieszkania lub lokalu.
Oto przykład, jak może wyglądać ten przepływ przy użyciu jednego pola do wprowadzania danych:
Krok 2. Użyj interfejsu Address Validation API, aby zweryfikować adresy
Gdy użytkownik wpisze adres, Google zaleca wywołanie metody Address Weryfikacja Interfejs API w momencie płatności, aby potwierdzić, że adres jest prawidłowy i kompletny. Wywołaj polecenie interfejsu API weryfikacji adresów po kliknięciu przez użytkownika przycisku Dalej lub Dalej za pomocą formularza adresowego. Ten przycisk często prowadzi do strony płatności.
Google zaleca wywoływanie interfejsu Address Validation API w przypadku każdej transakcji.
Poniższy diagram przepływu ilustruje przykład całej integracji Interfejs API do weryfikacji adresu w procesie płatności:
Scenariusze rozmów omawiamy w dalszej części tego dokumentu.
Krok 3. Prześlij wizualne potwierdzenie
Po podaniu adresu przekaż użytkownikowi wizualne potwierdzenie dostarczenia lokalizację, wyświetlając ją na mapie. Dzięki temu klient może daje pewność, że adres jest prawidłowy, co zmniejsza liczbę przesyłek i odbiorów błędów.
Mapa może być wyświetlana podczas procesu płatności lub może zostać wysłana w ramach transakcji e-maila z potwierdzeniem. Oba te przypadki użycia można realizować za pomocą tych interfejsów API.
Maps JavaScript API udostępnia interaktywną mapę do wyświetlania lokalizacji użytkownika. | Maps Static API pozwala umieścić zdjęcie na stronie internetowej lub później w e-mailu. |
---|---|
![]() |
![]() |
Szczegółowa analiza – scenariusze dotyczące akceptacji rozwiązań
Odpowiedzi interfejsu Address Validation API można podzielić na 3 główne scenariusze:
- Napraw – adres jest niskiej jakości. Powinna pojawić się prośba o podanie dodatkowych informacji.
- Potwierdź – adres jest wysokiej jakości, ale nie niż w przypadku wprowadzania adresu. Możesz zapytać o z potwierdzeniem.
- Akceptuj – adres jest wysokiej jakości. Dostępne opcje zaakceptuj podany adres.
Ta koncepcja jest omówiona w artykule Tworzenie walidacji logika w dokumentacji interfejsu Address Validation API, a każdy scenariusz omówimy w w tej sekcji.
Napraw
Z tej sekcji dowiesz się, jak poprawić adres. Aby uzyskać szczegółowe informacje na temat wskazuje, że interfejs Address Validation API zwraca wartość, wskazując niską jakość Więcej informacji można znaleźć w sekcji Naprawianie adres w dokumentacji dotyczącej tworzenia logiki walidacji.
Jeśli odpowiedź z interfejsu Address Validation API wskazuje na nieprawidłowy adres, Przekieruj klienta do formularza podawania adresu, aby sprawdzić wpisane dane. Po poprawieniu adresu usługa powinna ponownie zostać wysłana na adres Interfejs API walidacji zapewniający prawidłowe poprawki.
Możesz też wyróżniać konkretne błędy w wierszach adresu za pomocą sygnałów
zwracany na poziomie addressComponents
. Przykładem tego jest
zrzut ekranu po prawej stronie.
Potwierdź
W tej sekcji dowiesz się, jak potwierdzić adres. Aby uzyskać szczegółowe informacje na temat wskazuje, że interfejs Address Validation API zwraca adres, aby wskazać, że adres potwierdzone, patrz Potwierdzanie adres w dokumentacji tworzenia logiki walidacji.
System często wymaga od użytkownika potwierdzenia adresu. Przykład: klient błędnie wpisuje nazwę miasta, która zostanie poprawiona, Interfejs API weryfikacji. Skontaktuj się z klientem, aby potwierdzić tę poprawkę. Dzieje się tak, ponieważ zmiany wprowadzone przez interfejs API mogą zasadniczo zmienić Dołączył użytkownik.
Użyj pełnoekranowego okna modalnego, aby wyświetlić informacje klientowi, co pozwoli aby kontynuować, masz 3 opcje:
- Potwierdź adres zwrócony przez interfejs API i proces płatności będzie kontynuowany pod poprawionym adresem.
- Wybierz pierwotnie wpisany adres, ignorując poprawkę Interfejs API weryfikacji adresu. Proces płatności przebiega bez zmian, a zamówienie może zostać oznaczone do sprawdzenia przed wysyłką, jeśli Twój proces dopuszcza.
- Klient odwoływał się lub wycofywał, zwracając etapu wprowadzania adresu, na którym mogą ponownie wprowadzić kod adresu, zaczynając od początku.
Przykład widać na zrzucie ekranu po prawej stronie.
Akceptuj
W tej sekcji dowiesz się, jak zaakceptować adres. Aby uzyskać szczegółowe informacje na temat wskazuje, że adres interfejsu Address Validation API jest zwracany, aby wskazać, że adres jest prawidłowy jakości i powinny być akceptowane, przejdź do sekcji Akceptacja adres w dokumentacji dotyczącej tworzenia logiki walidacji.
W tym scenariuszu proces płatności powinien przejść do następnego etapu, płatności, bez zachęcania klienta do dbania o jakość. Interfejs API potwierdził, że adres wpisany przez klienta jest dobrej jakości. i łatwe do dostarczenia.
Zalecamy użycie danych adresowych zwróconych z interfejsu Address Validation API ze względu na możliwość wprowadzenia drobnych poprawek i uzupełnień, na przykład:
- Użycie wielkich liter
- korekty formatowania,
- Ulica i ul
- Właściwa kolejność komponentów adresu
- ZIP+4 w Stanach Zjednoczonych.
Uwagi o wdrażaniu
Podczas tworzenia logiki akceptowania adresów upewnij się, że implementacja nie zablokować klientom możliwość realizacji transakcji z powodu wpisania nieprawidłowego adresu. Budowanie logikę w sposób, który zapobiega zapętleniu nieskończonej wartości, jeśli interfejs API wskazuje, że wpis jest nieprawidłowy.
Google zaleca zapewnienie klientom maksymalnie 2 szansy na podanie a przy drugiej próbie zaakceptować jego adres, nawet jeśli nie weryfikacji. Przy drugiej próbie chcemy umożliwić kontynuowanie niezależnie weryfikacji danych.
2 sugerowane metody akceptowania drugiej metody:
- Wymuś przejście: pokaż klientowi okno modalne z wyjaśnieniem, że adres nie jest weryfikuje go, ale zostawia opcję kontynuowania adresu.
- Cicha akceptacja: automatycznie zaakceptuj drugą próbę bez nawet wtedy, gdy adres nie jest w pełni zweryfikowany.
O ile to możliwe, zaprojektuj system w taki sposób, aby zgłaszał niezweryfikowane adresy, aby przedstawiciel działu obsługi klienta może je sprawdzić przed wysłaniem zamówienia. Ten aby wychwycić ewentualne błędy.
Nowa konstrukcja budynku dobrze ilustruje powód, dla którego zalecane. Między momentem budowy nowego budynku mogą występować przerwy a kiedy adres tego budynku zostanie uzupełniony w adresie pocztowym baz danych. Klienci powinni mieć możliwość wymuszenia przejścia przez stronie płatności za pomocą wpisanego adresu, nawet jeśli adres nie jest zweryfikowany.
Po zakończeniu sesji płatności możesz użyć polecenia
provideValidationFeedback
.
Podsumowanie
W tym dokumencie omówiono proces realizacji płatności, Autouzupełnianie, weryfikacja adresu i wizualne potwierdzenie w Mapach Google. Używaj ten dokument będzie punktem wyjścia do projektowania implementacji. zalecane przepływy wprowadzania adresów.
Następne kroki
Pobierz dokument Usprawnij proces płatności, dostawy i operacji dzięki niezawodnym adresom Dokument i przejdź do sekcji Usprawnianie procesu płatności, dostawy i operacji za pomocą Adresu Weryfikacja Webinar.
Sugerujemy dodatkowe artykuły:
- Dokumentacja autouzupełniania miejsc
- Dokumentacja interfejsu Address Validation API
- Raportowanie w 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ń
-
Niewyłączny licencjobiorca amerykańskiego urzędu pocztowego. Następujące znaki towarowe należą do amerykańskiej poczty Postal Service® i są używane za zgodą: CASSTM, USPS®, DPV®. ↩