Ziel
In diesem Dokument werden Methoden zum Kombinieren von Place Autocomplete, Address Validation API1 und Maps in einem E-Commerce-Checkout beschrieben, um hochwertige Adressen zu erfassen.
Vorbereitung
Google empfiehlt, sich mit Folgendem vertraut zu machen:
- Place Autocomplete-JavaScript-Entwicklerdokumentation
- Hier erfahren Sie aus technischer Sicht, wie Place Autocomplete funktioniert und welche Implementierungsoptionen es gibt.
- Implementierungsleitfaden für die Kaufabwicklung für Place Autocomplete
- Beispiele für Best Practices für die Implementierung von Place Autocomplete beim E-Commerce-Zahlungsvorgang.
- Address Validation API Produktdokumentation mit Schwerpunkt auf Validierungslogik erstellen.
- Hier erfahren Sie aus technischer Sicht, wie die Address Validation API funktioniert, und können sich die Signale ansehen, die die Adressqualität bestimmen.
Was ist die Adressvalidierung?
Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert. Es identifiziert Adresskomponenten und validiert sie. Außerdem wird die Adresse für den Postversand standardisiert und die genauesten Breiten- und Längengradkoordinaten für sie ermittelt. Optional können Sie für Adressen in den USA und Puerto Rico das Coding Accuracy Support System (CASS™) aktivieren.Warum ist eine Adressbestätigung an der Kasse erforderlich?
Genaue Adressen während des Bestellvorgangs erfassen
:Dieser Schritt ist wichtig, um erfolgreiche Lieferungen zu ermöglichen, die pünktliche Ausführung zu verbessern und kostspielige Gebühren für Adresskorrekturen zu reduzieren.
Kunden dabei helfen, die Adresse schnell und korrekt einzugeben:
Mit der automatischen Vervollständigung von Adressen wird die Adresseingabe beschleunigt und Eingabefehler werden reduziert. So können Kunden den Bezahlvorgang problemlos durchlaufen. Address Validation gibt Feedback zur allgemeinen Adressqualität, nimmt Korrekturen wie Standardisierung und Rechtschreibfehler vor und erweitert Metadaten, z. B. durch Angabe eines Indikators für Wohn- oder Geschäftsadressen (verfügbar in ausgewählten Regionen).
Implementierungsübersicht
In diesem Abschnitt wird der empfohlene Workflow für die Eingabe von Adressen an der Kasse im E-Commerce beschrieben. Der Prozess besteht aus drei Schritten:
- Verwenden Sie Place Autocomplete, um die Adresse zu erfassen.
- Mit der Address Validation API können Sie die eingegebene Adresse bestätigen.
- Lassen Sie den Standort der eingegebenen Adresse auf einer Karte anzeigen, damit Kunden sicher sein können, dass die Lieferung ankommt.
Als Nächstes gehen wir auf die einzelnen Schritte ein.
Schritt 1: Adresseneingabe – mit dem Place Autocomplete-Dienst
Implementieren Sie Place Autocomplete mit der JavaScript API in der ersten Zeile des Adressformulars.
Die automatische Ortsvervollständigung bietet dem Kunden Vorschläge, während er seine Adressdetails eingibt. Wenn die JavaScript API verwendet wird, wird beim Tippen unter dem Adresseneingabeformular ein Drop-down-Menü mit Ergebnissen des Autocomplete-Dienstes angezeigt, das bei jeder Eingabe aktualisiert wird. Sobald der Nutzer genügend Informationen eingegeben hat, um die Adresse zu finden, wählt er sie aus dem Drop-down-Menü aus. Dadurch werden die Formularfelder automatisch mit den Adressdaten ausgefüllt.
Mit Place Autocomplete können Sie dem Nutzer zwei Arten der Formulareingabe anbieten: entweder eine Anzeige mit allen Adressfeldern oder eine Anzeige mit einem einzelnen Eingabefeld. In diesem einzelnen Eingabefeld wird der Nutzer aufgefordert, mit der Suche zu beginnen, während er tippt, anstatt Adresskomponenten einzeln einzugeben. Sobald die Adresse automatisch vervollständigt wurde, werden die Formularfelder mit den Adressdaten erweitert, sodass der Kunde sie prüfen und bearbeiten kann, z. B. durch Hinzufügen einer Apartment- oder Wohneinheitnummer.
Hier ist ein Beispiel dafür, wie dieser Ablauf mit einem einzelnen Eingabefeld aussehen könnte:
Schritt 2: Adressen mit der Address Validation API validieren
Nachdem der Nutzer die Adresse eingegeben hat, empfiehlt Google, die Address Validation API an der Kasse aufzurufen, um zu bestätigen, dass die Adresse gültig und vollständig ist. Lösen Sie einen Aufruf der Address Validation API aus, wenn der Nutzer im Adressformular auf die Schaltfläche „Weiter“ oder „Fortfahren“ klickt. Diese Schaltfläche führt häufig zur Zahlungsseite.
Google empfiehlt, die Address Validation API für jede Transaktion aufzurufen.
Das folgende Flussdiagramm veranschaulicht ein Beispiel für eine End-to-End-Integration der Address Validation API in einen Zahlungsvorgang:
In diesem Dokument werden später Szenarien für die Annahme von Adressen behandelt.
Schritt 3: Visuelle Bestätigung vorlegen
Blenden Sie nach der Adresseingabe eine visuelle Bestätigung des Lieferortes auf einer Karte ein. So wird dem Kunden noch einmal versichert, dass die Adresse stimmt, und es kommt zu weniger Fehlern bei der Lieferung oder Abholung.
Die Karte kann während des Bezahlvorgangs angezeigt oder in der E‑Mail mit der Transaktionsbestätigung gesendet werden. Beide Anwendungsfälle können mit den folgenden APIs umgesetzt werden.
Die Maps JavaScript API bietet eine interaktive Karte zum Anzeigen des Nutzerstandorts. | Mit der Maps Static API können Bilder in die Webseite oder später in eine E‑Mail eingebettet werden. |
---|---|
![]() |
![]() |
Detaillierte Informationen – Akzeptanzszenarien für Adressen
Antworten der Address Validation API lassen sich in drei Hauptszenarien einteilen:
- Beheben: Die Adresse ist von geringer Qualität. Sie sollten nach weiteren Informationen fragen.
- Bestätigen: Die Adresse ist von hoher Qualität, weicht aber von der eingegebenen Adresse ab. Möglicherweise werden Sie um eine Bestätigung gebeten.
- Akzeptieren: Die Adresse ist von hoher Qualität. Sie können die angegebene Adresse übernehmen.
Dieses Konzept wird im Abschnitt Validierungslogik erstellen der Address Validation API-Dokumentation behandelt. Wir werden die einzelnen Szenarien in diesem Abschnitt erläutern.
Problembehebung
In diesem Abschnitt wird beschrieben, wie Sie eine Adresseingabe korrigieren. Informationen zu bestimmten Signalen, die von der Address Validation API zurückgegeben werden, um eine Adresse von geringer Qualität anzugeben, finden Sie in der Dokumentation zum Erstellen Ihrer Validierungslogik unter Adresse korrigieren.
Wenn die Antwort der Address Validation API eine ungültige Adresse angibt, leiten Sie den Kunden zum Formular für die Adresseingabe weiter, damit er seine eingegebenen Daten überprüfen kann. Sobald die Adresse korrigiert wurde, sollte Ihr Dienst sie noch einmal an die Address Validation API senden, um sicherzustellen, dass die vorgenommenen Korrekturen gültig sind.
Sie können auch bestimmte Fehler in Adresszeilen hervorheben, indem Sie die Signale verwenden, die auf der Ebene addressComponents
zurückgegeben werden. Ein Beispiel dafür sehen Sie im Screenshot rechts.
Bestätigen
In diesem Abschnitt wird beschrieben, wie Sie eine Adresse bestätigen. Informationen zu bestimmten Signalen, die von der Address Validation API zurückgegeben werden, um anzugeben, dass eine Adresse bestätigt werden sollte, finden Sie in der Dokumentation unter Adresse bestätigen im Abschnitt „Validierungslogik erstellen“.
Häufig werden Nutzer in Ihrem System aufgefordert, eine Adresse zu bestätigen. Ein Kunde gibt beispielsweise den Namen der Stadt falsch ein. Die Address Validation API korrigiert den Namen. Sie sollten diese Lösung mit dem Kunden bestätigen. Das liegt daran, dass die von der API vorgenommenen Änderungen die ursprüngliche Eingabe grundlegend verändern können.
Verwenden Sie ein Interstitial-Modal, um dem Kunden die Informationen zu präsentieren. Er hat dann drei Möglichkeiten, fortzufahren:
- Die von der API zurückgegebene Adresse wird bestätigt und der Check-out-Vorgang wird mit der korrigierten Adresse fortgesetzt.
- Wählen Sie die Adresse aus, wie sie ursprünglich eingegeben wurde, und ignorieren Sie die Korrektur durch die Address Validation API. Der Check-out-Vorgang kann wie gewohnt fortgesetzt werden. Die Bestellung kann vor dem Versand zur weiteren Überprüfung gekennzeichnet werden, sofern dies in Ihrem Prozess möglich ist.
- Der Kunde bricht das Modal ab und kehrt zur Adresseneingabe des Bezahlvorgangs zurück. Dort kann er die Adresse noch einmal eingeben und den Vorgang neu starten.
Ein Beispiel hierfür sehen Sie im Screenshot rechts.
Akzeptieren
In diesem Abschnitt wird beschrieben, wie Sie eine Adresse akzeptieren. Informationen zu bestimmten Signalen, die von der Address Validation API zurückgegeben werden, um anzugeben, dass eine Adresse von guter Qualität ist und akzeptiert werden sollte, finden Sie in der Dokumentation unter Accept an address (Eine Adresse akzeptieren).
In diesem Fall sollte der Bezahlvorgang mit dem nächsten Schritt fortgesetzt werden, wahrscheinlich mit der Zahlungserfassung, ohne dass der Kunde bezüglich der Adressqualität aufgefordert wird. Die API hat bestätigt, dass die vom Kunden eingegebene Adresse eine gute Qualität hat und lieferbar ist.
Wir empfehlen, die zurückgegebenen Adressdaten aus der Address Validation API für die Bestellung zu verwenden, da sie geringfügige Korrekturen und Ergänzungen enthalten können, z. B.:
- Großschreibung
- Korrekturen der Formatierung, z. B.
- Straße zu St
- Korrekte Reihenfolge der Adresskomponenten
- ZIP+4 in den USA.
Hinweise zur Implementierung
Achten Sie beim Erstellen Ihrer Logik für die Adressannahme darauf, dass Kunden nicht daran gehindert werden, den Bezahlvorgang abzuschließen, weil sie eine ungültige Adresse eingegeben haben. Konstruieren Sie die Logik so, dass die Möglichkeit einer Endlosschleife verhindert wird, wenn die API wiederholt angibt, dass der Eintrag ungültig ist.
Google empfiehlt, Kunden bis zu zwei Versuche zu geben, ihre Adresse einzugeben. Beim zweiten Versuch sollten Sie die Eingabe akzeptieren, auch wenn sie nicht validiert wird. Beim zweiten Versuch soll der Nutzer unabhängig von der Validierung fortfahren können.
Hier sind zwei Vorschläge, wie Sie den zweiten Versuch akzeptieren können:
- Erzwingen:Zeigen Sie dem Kunden ein Modal an, in dem erklärt wird, dass die Adresse nicht validiert wird, aber die Option zum Fortfahren mit der eingegebenen Adresse verfügbar ist.
- Stille Annahme:Der zweite Versuch wird automatisch akzeptiert, ohne dass ein Bestätigungsschritt erforderlich ist, auch wenn die Adresse nicht vollständig validiert wird.
Wenn möglich, sollte Ihr System Adressen, die nicht validiert werden können, kennzeichnen, damit ein Kundenservicemitarbeiter sie vor dem Versand der Bestellung überprüfen kann. So können Sie Fehler erkennen.
Der Neubau eines Gebäudes ist ein gutes Beispiel dafür, warum diese Prüfung empfohlen wird. Es kann eine Weile dauern, bis die Adresse eines neu gebauten Gebäudes in den Datenbanken für Postadressen eingetragen wird. Kunden sollten die Möglichkeit haben, die Zahlungsseite mit ihrer eingegebenen Adresse aufzurufen, auch wenn diese nicht validiert wird.
Nachdem eine Checkout-Sitzung abgeschlossen wurde, können Sie optional die Methode provideValidationFeedback
verwenden, um Google Feedback zu einem bestimmten Versuch zur Adressvalidierung zu senden.
Fazit
In diesem Dokument wurde ein Überblick über einen Checkout-Ablauf gegeben, in dem die Funktionen „Autovervollständigen“, „Adressbestätigung“ und „Visuelle Bestätigung auf einer Google-Karte“ implementiert sind. Verwenden Sie dieses Dokument als Ausgangspunkt für die Gestaltung Ihrer Implementierung und folgen Sie dabei den empfohlenen Abläufen für die Eingabe von Adressen.
Nächste Schritte
Laden Sie das Whitepaper zum Optimieren von Bezahlvorgang, Lieferung und Betrieb mit gültigen Adressen herunter und sehen Sie sich das Webinar zum Optimieren von Bezahlvorgang, Lieferung und Betrieb mit Address Validation an.
Empfohlene Artikel:
- 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 | Solutions Engineer
-
Nicht exklusiver Lizenznehmer von United States Postal Service. Die folgenden Marken sind eingetragene Marken von United States Postal Service® und werden mit dessen Zustimmung verwendet: CASS™, USPS®, DPV®. ↩