Ziel
In diesem Dokument werden Methoden beschrieben, mit denen Sie „Places Autocomplete“, die Address Validation API1 und Google Maps in einem E-Commerce-Bezahlvorgang kombinieren können, um Adressen mit hoher Qualität zu erfassen.
Vorbereitung
Google empfiehlt, mit Folgendem vertraut zu sein:
- Place Autocomplete für JavaScript-Entwicklerdokumentation
- Informationen zur Funktionsweise von Place Autocomplete und zu den Implementierungsoptionen
- Leitfaden zur Implementierung des Checkout-Systems für „Place Autocomplete“.
- Beispiele für Best Practices für die Implementierung von Place Autocomplete an einem E-Commerce-Checkout.
- Produktdokumentation der Address Validation API, insbesondere Validierungslogik erstellen
- Hier erfahren Sie, wie die Address Validation API funktioniert und welche Signale die Qualität von Adressen bestimmen.
Was ist die Adressüberprüfung?
Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert. Es identifiziert Adresskomponenten und validiert sie. Außerdem wird die Postadresse standardisiert und die besten bekannten Breiten- und Längengrade dafür ermittelt. Optional können Sie für Adressen in den USA und Puerto Rico das Coding Accuracy Support System (CASS™) aktivieren.Warum muss an der Kasse die Adresse bestätigt werden?
Während des Bestellvorgangs korrekte Adressen erfassen:
Das ist ein wichtiger Schritt, um erfolgreiche Lieferungen zu ermöglichen, die pünktliche Auftragsausführung zu erhöhen und teure Kosten für Adresskorrekturen zu vermeiden.
Kund*innen dabei helfen, die Adresse schnell und genau einzugeben:
Place Autocomplete beschleunigt die Adresseingabe und reduziert Eingabefehler, sodass Kunden den Bezahlvorgang leichter abschließen können. Address Validation gibt Feedback zur Qualität der Adresse insgesamt, führt Korrekturen wie Standardisierung und Rechtschreibfehler durch und verbessert Metadaten, z. B. durch Angabe eines Indikators für eine Privat- oder Geschäftsadresse (verfügbar in ausgewählten Regionen).
Implementierungsübersicht
In diesem Abschnitt wird der empfohlene Workflow für die Adresseingabe bei E-Commerce-Käufen beschrieben. Der Prozess umfasst drei Schritte:
- Verwenden Sie Place Autocomplete, um die Adresse anfänglich zu erfassen.
- Verwenden Sie die Address Validation API, um die eingegebene Adresse zu bestätigen.
- Der Standort der eingegebenen Adresse wird auf einer Karte angezeigt, um Kunden die Zustellung zu erleichtern.
Im Folgenden gehen wir auf die einzelnen Schritte ein.
Schritt 1: Adresseingabe – mit dem „Place Autocomplete“-Dienst
Implementieren Sie Place Autocomplete mithilfe der JavaScript API in der ersten Zeile des Adresserfassungsformulars.
„Place Autocomplete“ unterbreitet dem Kunden während der Eingabe seiner Adresse Vorschläge. Wenn die Funktion mit der JavaScript API implementiert ist, wird beim Tippen ein Drop-down-Menü unter dem Eingabefeld für die Adresse angezeigt. Es enthält Ergebnisse des Autocomplete-Dienstes, die sich bei jedem Tastenanschlag aktualisieren. Sobald der Nutzer genügend Informationen eingegeben hat, um die Adresse zu finden, wählt er sie im Drop-down-Menü aus. Dadurch werden die Formularfelder automatisch mit den Adressdaten ausgefüllt.
Mit Place Autocomplete können Sie Nutzern zwei Eingabestile für Formulare zur Verfügung stellen: entweder eine Anzeige mit allen Adressfeldern oder eine Anzeige mit einem einzigen Eingabefeld. In diesem einzigen Eingabefeld wird der Nutzer aufgefordert, während der Eingabe zu suchen, anstatt die Adresskomponenten einzeln einzugeben. Sobald die Adresse durch die automatische Vervollständigung ausgefüllt wurde, werden die Formularfelder im Workflow um die Adressdaten erweitert. Der Kunde kann die Adresse prüfen und bearbeiten, z. B. eine Wohnungs- oder Einheitsnummer hinzufügen.
Hier ist ein Beispiel dafür, wie dieser Ablauf mit einem einzigen Eingabefeld aussehen könnte:
Schritt 2: Adressen mit der Address Validation API validieren
Nachdem der Nutzer die Adresse eingegeben hat, empfiehlt Google, an der Kasse die Address Validation API aufzurufen, um zu prüfen, ob die Adresse gültig und vollständig ist. Lösen Sie einen Aufruf an die Address Validation API aus, wenn der Nutzer im Adressformular auf die Schaltfläche „Weiter“ oder „Weiter“ klickt. Diese Schaltfläche führt oft zur Zahlungsseite.
Google empfiehlt, die Address Validation API für jede Transaktion 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
Blenden Sie nach der Adresseingabe eine visuelle Bestätigung des Lieferorts ein, indem Sie ihn auf einer Karte anzeigen. Dadurch erhält der Kunde die zusätzliche Gewissheit, dass die Adresse korrekt ist, und Liefer- oder Abholfehler werden reduziert.
Die Karte kann während des Bezahlvorgangs angezeigt oder in der Bestätigungs-E-Mail für die Transaktion gesendet werden. Beide Anwendungsfälle lassen sich mit den folgenden APIs umsetzen.
Die Maps JavaScript API bietet eine interaktive Karte, auf der der Nutzerstandort angezeigt wird. | Mit der Maps Static API können Bilder in die Webseite oder zu einem späteren Zeitpunkt in eine E-Mail eingebettet werden. |
---|---|
Vertiefung: Akzeptanzszenarien ansprechen
Antworten der Address Validation API können in drei Hauptszenarien kategorisiert werden:
- Problem beheben: Die Adresse hat eine niedrige Qualität. Sie sollten um weitere Informationen bitten.
- 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 akzeptieren.
Dieses Konzept wird in den API-Dokumenten für die Address Validation im Abschnitt Validation Logic erstellen behandelt. In diesem Abschnitt werden die einzelnen Szenarien erläutert.
Korrigieren
In diesem Abschnitt erfahren Sie, wie Sie eine Adresseingabe korrigieren. Informationen zu bestimmten Signalen, die die Address Validation API zurückgibt, um auf eine Adresse von niedriger Qualität hinzuweisen, findest du in der Dokumentation zum Erstellen deiner Validierungslogik unter Adresse korrigieren.
Wenn die Antwort der Address Validation API eine ungültige Adresse enthält, leite den Kunden zum Formular zur Adresseingabe weiter, damit er die eingegebenen Daten prüfen kann. Sobald die Adresse korrigiert wurde, sollte Ihr Dienst die Adresse noch einmal an die Address Validation API senden, um sicherzustellen, dass die vorgenommenen Korrekturen gültig sind.
Sie können auch bestimmte Fehler in der Adresszeile hervorheben, indem Sie die Signale verwenden, die auf addressComponents
-Ebene zurückgegeben werden. Ein Beispiel dafür sehen Sie im Screenshot rechts.
Bestätigen
In diesem Abschnitt erfahren Sie, wie Sie eine Adresse bestätigen. Informationen zu bestimmten Signalen, die die Address Validation API zurückgibt, um anzugeben, dass eine Adresse bestätigt werden sollte, finden Sie in der Dokumentation zum Erstellen Ihrer Validierungslogik unter Adresse bestätigen.
Ihr System sollte Nutzer häufig auffordern, eine Adresse zu bestätigen. Wenn ein Kunde beispielsweise den Namen der Stadt falsch schreibt, wird dieser von der Address Validation API korrigiert. Du solltest diese Lösung mit dem Kunden bestätigen. Das liegt daran, dass die von der API vorgenommenen Änderungen das ursprünglich eingegebene Material grundlegend verändern können.
Verwenden Sie ein modales Interstitial, um dem Kunden die Informationen anzuzeigen. Er hat dann drei Möglichkeiten, fortzufahren:
- Bestätigen Sie die von der API zurückgegebene Adresse. Der Bezahlvorgang wird dann mit 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 Bestellung kann vor dem Versand zur weiteren Überprüfung gekennzeichnet werden, sofern dies in Ihrem Prozess zulässig ist.
- Der Kunde bricht den Vorgang ab oder verlässt das Dialogfenster und kehrt zur Adresseingabephase des Bezahlvorgangs zurück. Dort kann er die Adresse noch einmal eingeben und den Vorgang von vorn beginnen.
Ein Beispiel dafür sehen Sie im Screenshot rechts.
Akzeptieren
In diesem Abschnitt wird beschrieben, wie Sie eine Adresse akzeptieren. Informationen zu bestimmten Signalen, die die Address Validation API zurückgibt, um anzugeben, dass eine Adresse von guter Qualität ist und akzeptiert werden sollte, findest du unter Adresse akzeptieren in der Dokumentation zum Erstellen deiner Validierungslogik.
In diesem Szenario sollte der Bezahlvorgang mit der nächsten Phase fortgesetzt werden, wahrscheinlich der Zahlungsaufnahme, ohne dass der Kunde bezüglich der Qualität der Adresse aufgefordert wird. Die API hat bestätigt, dass die vom Kunden eingegebene Adresse von guter Qualität ist und zugestellt werden kann.
Wir empfehlen, die zurückgegebenen Adressdaten aus der Address Validation API mit der Bestellung abzugleichen, da diese möglicherweise kleinere Korrekturen und Ergänzungen enthalten, z. B.:
- Großschreibung
- Formatkorrekturen, z. B.
- Straße zu St
- Korrekte Reihenfolge der Adresskomponenten
- ZIP+4 in den USA.
Hinweise zur Implementierung
Achten Sie beim Erstellen der Logik für die Adresszulassung darauf, dass Kunden nicht aufgrund der Eingabe einer ungültigen Adresse daran gehindert werden, den Bezahlvorgang abzuschließen. Die Logik so gestalten, dass ein Endlos-Loop verhindert wird, wenn die API wiederholt angibt, dass der Eintrag ungültig ist.
Google empfiehlt, dass Sie Kunden zwei Möglichkeiten bieten, ihre Adresse einzugeben, und beim zweiten Versuch die Eingabe akzeptieren, auch wenn sie nicht validiert wird. Beim zweiten Versuch soll der Nutzer unabhängig von der Validierung fortfahren können.
Es gibt zwei Methoden, um den zweiten Versuch zu akzeptieren:
- Force-proceed (Weiter mit Zwang): Dem Kunden wird ein modales Fenster angezeigt, in dem erklärt wird, dass die Adresse nicht gültig ist. Er kann jedoch mit der eingegebenen Adresse fortfahren.
- Stille Annahme:Der zweite Versuch wird automatisch und ohne Bestätigungsschritt angenommen, auch wenn die Adresse nicht vollständig validiert wird.
Wenn möglich, solltest du dein System so konzipieren, dass nicht validierte Adressen markiert werden, damit ein Kundenservicemitarbeiter sie prüfen kann, bevor die Bestellung versendet wird. Diese zusätzliche Maßnahme stellt sicher, dass Sie Fehler vermeiden.
Die Neukonstruktion von Gebäuden veranschaulicht gut, warum diese Prüfung empfohlen wird. Es kann eine gewisse Zeit vergehen, bis die Adresse eines neu errichteten Gebäudes in die Postadressendatenbanken aufgenommen wird. Kunden sollten die Möglichkeit haben, mit der eingegebenen Adresse zur Zahlungsseite zu gelangen, auch wenn sie nicht bestätigt wird.
Nach Abschluss einer Bezahlsitzung können Sie optional die Methode provideValidationFeedback
verwenden, um Google Feedback zu einem bestimmten Adressvalidierungsversuch zu senden.
Fazit
Dieses Dokument bietet einen Überblick über den Bezahlvorgang, bei dem die automatische Vervollständigung, die Adressvalidierung und die visuelle Bestätigung auf einer Google Maps-Karte implementiert werden. Verwenden Sie dieses Dokument als Ausgangspunkt für den Entwurf Ihrer Implementierung. Halten Sie sich dabei an die empfohlenen Abläufe zur Adresseingabe.
Nächste Schritte
Laden Sie das Whitepaper Mit gültigen Adressen den Bezahlvorgang und die Lieferung optimieren herunter und sehen Sie sich das Webinar Mit der Adressenüberprüfung den Bezahlvorgang und die Lieferung optimieren an.
Empfohlene weiterführende 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 | Solutions Engineer
-
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®. ↩