Ziel
In diesem Dokument werden Methoden zum Kombinieren von „Place Autocomplete“, „Address“ Validation API1 und Maps an einem E-Commerce-Bezahlvorgang zum Zweck der hochwertige Adressen erfassen.
Vorbereitung
Google empfiehlt, mit Folgendem vertraut zu sein:
- Place Autocomplete-JavaScript-Entwickler
Dokumentation.
- Aus technischer Sicht verstehen, wie Place Autocomplete funktioniert und dessen Implementierungsoptionen.
- Leitfaden zur Implementierung von Google Checkout für den Ort
Automatische Vervollständigung.
- Beispiele für Best Practices für die Place Autocomplete-Implementierung auf einem E-Commerce-Bezahlvorgang.
- Address Validation API-Produkt
Dokumentation,
mit dem Fokus auf Ihre Validierung
Logik.
- Aus technischer Sicht verstehen, wie die Address Validation API funktioniert und die Signale prüfen, die die Qualität der Adresse bestimmen.
Was ist die Adressüberprüfung?
Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert. Damit werden Adresskomponenten identifiziert und validiert. Außerdem standardisiert sie Adresse für die Postanschrift und ermittelt die bekanntesten Breiten- und Längengrade dafür. Für Adressen in den USA und Puerto Rico können Sie optional das Coding Accuracy Support System (CASSTM).Warum muss an der Kasse die Adresse bestätigt werden?
Korrekte Adressen während des Bestellvorgangs erfassen:
Dies ist ein wichtiger Schritt zur Förderung erfolgreicher Lieferungen, da dies die Pünktlichkeit erhöht.
und senkt kostspielige Kosten für die Adresskorrektur.
Bringen Sie Kunden dazu, die Adresse schnell und genau einzugeben:
Place Autocomplete beschleunigt die Adresseingabe und reduziert Eingabefehler.
einfach den Bezahlvorgang durchlaufen. Address Validation gibt Feedback
an der Gesamtqualität der Adresse
und Korrekturen wie Standardisierung und
sowie zur Verbesserung der Metadaten, indem etwa die Angabe von Wohn- oder
Handelsindikator (verfügbar in ausgewählten
Regionen
Implementierungsübersicht
In diesem Abschnitt wird der empfohlene Workflow zur Adresseingabe für E-Commerce beschrieben. den Bezahlvorgang. Der Prozess umfasst drei Schritte:
- Verwenden Sie Place Autocomplete, um die Adresse anfangs zu erfassen.
- Verwenden Sie die Address Validation API, um die eingegebene Adresse zu bestätigen.
- Standort der eingegebenen Adresse auf einer Karte anzeigen, um die Lieferung zu ermöglichen das Vertrauen der Kundschaft zu gewinnen.
Als Nächstes gehen wir auf jeden Schritt einzeln ein.
Schritt 1: Adresseingabe – mit dem „Place Autocomplete“-Dienst
Place implementieren Automatische Vervollständigung Verwenden Sie die JavaScript API in der ersten Zeile des Adresseingabeformulars.
Place Autocomplete macht dem Kunden während der Eingabe Adressdetails. Bei der Implementierung mithilfe der JavaScript API, sobald Nutzer wird unter dem Formularfeld für die Adresseingabe ein Drop-down-Menü mit den Ergebnissen aus dem Autocomplete-Dienst, der mit jedem Tastendruck aktualisiert wird. Sobald die Nutzenden genügend Informationen eingegeben hat, um die Adresse zu finden, aus. Bei dieser Aktion wird die Adresse automatisch in die Formularfelder eingefügt. Daten.
Mit Place Autocomplete können Sie dem Nutzer zwei Stile für Formulareingaben zur Verfügung stellen: entweder eine Anzeige mit allen Adressfeldern oder eine Anzeige mit einer einzigen Eingabe ein. Dieses einzelne Eingabefeld fordert den Nutzer auf, schon während der Eingabe mit der Suche zu beginnen. anstatt Adresskomponenten einzeln einzugeben. Nach der automatischen Vervollständigung die Adresse ausfüllt, erweitert der Workflow die Formularfelder mit der Adresse sodass die Kundin oder der Kunde die Daten überprüfen und bearbeiten kann, z. B. ein die Nummer der Wohnung oder Einheit.
Hier ist ein Beispiel dafür, wie dieser Ablauf mit einem einzigen Eingabefeld aussehen könnte:
Schritt 2: Address Validation API zum Validieren von Adressen verwenden
Nachdem der Nutzer die Adresse eingegeben hat, empfiehlt Google, dass Sie die Adresse Validierung API an der Kasse bestätigen, dass die Adresse gültig und vollständig ist. Anruf an die Address Validation API, sobald der Nutzer das Adressformular an. Diese Schaltfläche führt häufig zur Zahlungsseite.
Google empfiehlt, für jede Transaktion die Address Validation API aufzurufen.
Das folgende Flussdiagramm zeigt ein Beispiel für eine End-to-End-Integration der Address Validation API innerhalb eines Bezahlvorgangs:
In diesem Dokument werden später Szenarien für die Adressakzeptanz erläutert.
Schritt 3: Visuelle Bestätigung bereitstellen
Liefern Sie dem Nutzer nach der Adresseingabe eine visuelle Bestätigung der Lieferung. indem Sie ihn auf einer Karte anzeigen. Dies bietet dem Kunden zusätzliche die Gewissheit, dass die Adresse korrekt ist, und dadurch die Anzahl der Liefer- bzw. Abholzeiten reduziert wird Störungen.
Die Karte kann während des Bezahlvorgangs angezeigt oder während der Transaktion gesendet werden Bestätigungs-E-Mail. Beide Anwendungsfälle können mithilfe des folgenden APIs.
Die Maps JavaScript API bietet eine interaktive Karte zur Anzeige des Nutzerstandorts. | Mit der Maps Static API können Bilder in die Webseite oder später in eine E-Mail eingebettet werden. |
---|---|
![]() |
![]() |
Vertiefung: Akzeptanzszenarien ansprechen
Antworten der Address Validation API können in drei Hauptszenarien kategorisiert werden:
- Problem: Die Adresse hat eine niedrige Qualität. Sie sollten nach weiteren Informationen fragen.
- Bestätigen: Die Adresse ist hochwertig, hat aber die sich von der Eingabeadresse ändern. Sie können bestätigen.
- Akzeptieren: Die Adresse ist hochwertig. Sie können angegebene Adresse akzeptieren.
Dieses Konzept wird im Abschnitt Validierung erstellen Logik der Address Validation API-Dokumentation. Wir werden jedes Szenario in diesem Abschnitt.
Korrigieren
In diesem Abschnitt erfahren Sie, wie Sie eine Adresseingabe korrigieren. Informationen zu bestimmten signalisiert, dass die Address Validation API eine niedrige Qualität zurückgibt finden Sie unter Probleme mit Adresse in der Dokumentation zum Erstellen einer Validierungslogik.
Wenn die Antwort der Address Validation API eine ungültige Adresse enthält, den Kunden zum Formular zur Adresseingabe weiterleiten, um seine eingegebenen Daten zu prüfen. Sobald die Adresse korrigiert wurde, sollte Ihr Dienst eine neue Nachricht an die Adresse senden Validation API überprüfen, um sicherzustellen, dass die vorgenommenen Korrekturen gültig sind.
Sie können auch bestimmte Fehler in der Adresszeile hervorheben, indem Sie die Signale
wird auf addressComponents
-Ebene zurückgegeben. Ein Beispiel hierfür finden Sie
Screenshot auf der rechten Seite.
Bestätigen
In diesem Abschnitt erfahren Sie, wie Sie eine Adresse bestätigen. Informationen zu bestimmten signalisiert, dass die Address Validation API eine Adresse zurückgibt, bestätigt haben, finden Sie unter Adresse in der Dokumentation zum Erstellen einer Validierungslogik.
Häufig wird der Nutzer vom System aufgefordert, eine Adresse zu bestätigen. Beispiel: Wenn die Kundin oder der Kunde den Namen der Stadt falsch geschrieben hat, was dann durch die Adresse korrigiert wird. Validation API Sprechen Sie mit dem Kunden über diese Lösung. Das liegt daran, Die von der API vorgenommenen Änderungen könnten das ursprüngliche eingegeben.
Verwenden Sie ein Interstitial-Modaldialogfeld, um dem Kunden die Informationen anzuzeigen, drei Optionen für die weitere Vorgehensweise:
- Prüfen Sie die von der API zurückgegebene Adresse und den Bezahlvorgang wird unter Verwendung der korrigierten Adresse fortgesetzt.
- Wählen Sie die ursprünglich eingegebene Adresse aus und ignorieren Sie die Korrektur der Address Validation API. Der Bezahlvorgang kann wie gewohnt fortgesetzt werden und die kann die Bestellung vor dem Versand für eine nachgelagerte Überprüfung gekennzeichnet werden, wenn Ihr Prozess ermöglicht.
- Der Kunde bricht den Vorgang ab oder verlässt den Dialog und kehrt zur in der Phase der Adresseingabe die Adresse von Grund auf neu erstellen.
Ein Beispiel hierfür ist der Screenshot auf der rechten Seite.
Akzeptieren
In diesem Abschnitt wird beschrieben, wie Sie eine Adresse akzeptieren. Informationen zu bestimmten signalisiert, dass die Address Validation API eine fehlerfreie Adresse zurückgibt und akzeptiert werden sollten, siehe Adresse in der Dokumentation zum Erstellen einer Validierungslogik.
In diesem Szenario sollte der Bezahlvorgang in die nächste Phase übergehen, Zahlungsaufnahmen ohne Aufforderungen an den Kunden bezüglich der Adressqualität. Die API hat bestätigt, dass die vom Kunden eingegebene Adresse eine gute Qualität hat. Liefergegenstand.
Wir empfehlen, die zurückgegebenen Adressdaten der Address Validation API zu verwenden gegen die Verfügung verstoßen, da diese kleinere Korrekturen und Ergänzungen enthalten könnte, wie zum Beispiel:
- Großschreibung
- Formatierungskorrekturen, z. B.
<ph type="x-smartling-placeholder">
- </ph>
- Straße nach St
- Korrekte Reihenfolge der Adresskomponenten
- ZIP+4 in den USA.
Hinweise zur Implementierung
Achten Sie beim Erstellen der Logik für die Annahme von Adressen darauf, dass Ihre Implementierung keine Kunden aufgrund einer ungültigen Adresse am Bezahlvorgang zu hindern. Bauen dass eine Endlosschleife verhindert wird, wenn die API wiederholt anzeigt, dass ihr Eintrag ungültig ist.
Google empfiehlt, dass Sie Ihren Kunden maximal zwei Möglichkeiten bieten, und beim zweiten Versuch die Eingabe akzeptieren, auch wenn Validierung. Beim zweiten Versuch besteht das Ziel darin, weitermachen zu lassen, unabhängig von Validierung.
Es gibt zwei Methoden, um den zweiten Versuch zu akzeptieren:
- Fortfahren erzwingen:Zeige dem Kunden ein modales Fenster, in dem erklärt wird, dass die Adresse nicht stimmt. die Validierung durchgeführt wird, aber die Option zulassen, mit der eingegebenen Adresse fortzufahren.
- Lautlose Annahme:Der zweite Versuch wird automatisch angenommen, ohne dass selbst wenn die Adresse nicht vollständig validiert wird.
Gestalten Sie Ihr System nach Möglichkeit so, dass nicht validierte Adressen markiert werden, damit ein kann der Kundenservicemitarbeiter diese überprüfen, bevor die Bestellung versendet wird. Dieses zusätzliche Maßnahmen sorgen dafür, dass Sie Fehler vermeiden.
Die Neukonstruktion von Gebäuden veranschaulicht gut, warum diese Prüfung wird empfohlen. Beim Bau eines Neubaus kann es zu Abweichungen kommen. und wenn die Adresse dieses Gebäudes in die Postanschrift eingetragen wurde, Datenbanken. Kunden sollten die Möglichkeit haben, das Fortfahren mit der Zahlungsseite mit der eingegebenen Adresse anzuzeigen, auch wenn diese nicht validiert wird.
Sobald eine Bezahlsitzung abgeschlossen ist, können Sie optional die
provideValidationFeedback
, um Feedback zu einem bestimmten Adressbestätigungsversuch an Google zu senden.
Fazit
Dieses Dokument bietet einen Überblick über den Bezahlvorgang, Automatische Vervollständigung, Address Validation und visuelle Bestätigung auf einer Google Maps-Karte. Verwenden Sie dieses Dokument als Ausgangspunkt für den Entwurf Ihrer Implementierung. Beachten Sie dabei die empfohlenen Abläufen zur Adresseingabe.
Nächste Schritte
Laden Sie den Bericht Bezahlvorgang, Lieferung und Abläufe mit zuverlässigen Adressen verbessern Whitepaper und sehen Sie sich die Seite Bezahlvorgang, Lieferung und Abläufe mit Address verbessern Validierung Webinar.
Weitere Informationen:
- Place Autocomplete – Dokumentation
- Dokumentation zur Address Validation API
- Google Maps Platform Reporting (derzeit nur in englischer Sprache verfügbar)
Beitragende
Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Lösungsingenieur
-
Nicht exklusiver Lizenznehmer des United States Postal Service. Die folgenden Marken sind Eigentum des United States Postal Service® und werden mit dessen Erlaubnis verwendet: CASSTM, USPS®, DPV®. ↩