Adressbestätigung für E-Commerce-Kasse

Ziel

In diesem Dokument werden Methoden zum Kombinieren von Place Autocomplete, der Address Validation API¹ und Google Maps in einem E‑Commerce-Zahlungsvorgang beschrieben, um Adressen in hoher Qualität zu erfassen.

Vorbereitung

Google empfiehlt, dass Sie mit den folgenden Themen vertraut sind:

Place Autocomplete JavaScript developer documentation.
- Technische Informationen zur Funktionsweise von Place Autocomplete und zu den Implementierungsoptionen
Anleitung zur Implementierung des Zahlungsvorgangs für Place Autocomplete.
- Beispiele für Best Practices für die Implementierung von Place Autocomplete in einem E‑Commerce-Zahlungsvorgang
Address Validation API product documentation, mit Schwerpunkt auf Validierungslogik erstellen.
- Technische Informationen zur Funktionsweise der Address Validation API und zu den Signalen, die die Adressqualität bestimmen

Was ist Adressbestätigung?

Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert. Adresskomponenten werden identifiziert und validiert. Außerdem wird die Adresse für den Postversand standardisiert und die genauesten Längen- und Breitengradkoordinaten dafür ermittelt. Optional können Sie für Adressen in den USA und Puerto Rico das Coding Accuracy Support System (CASS™) aktivieren.

Warum ist die Adressbestätigung beim Zahlungsvorgang erforderlich?

Genaue Adressen während des Bestellvorgangs erfassen:
Dies ist ein wichtiger Schritt, um erfolgreiche Lieferungen zu fördern, die pünktliche Auftragsausführung zu verbessern und kostspielige Gebühren für die Adresskorrektur zu senken.

Kunden dabei helfen, die Adresse schnell und genau einzugeben
Place Autocomplete beschleunigt die Adresseingabe und reduziert Eingabefehler, sodass Kunden den Zahlungsvorgang problemlos durchlaufen können. Address Validation gibt Feedback zur allgemeinen Adressqualität, nimmt Korrekturen vor, z. B. Standardisierung und Rechtschreibfehler, und verbessert Metadaten, z. B. durch Angabe eines Indikators für Privat- oder Geschäftsadresse (in ausgewählten Regionen verfügbar).

Implementierungsübersicht

In diesem Abschnitt wird der empfohlene Workflow für die Adresseingabe für E‑Commerce-Zahlungsvorgänge beschrieben. Der Prozess besteht aus drei Schritten:

Adresse zuerst mit Place Autocomplete erfassen
Eingegebene Adresse mit der Address Validation API bestätigen
Standort der eingegebenen Adresse auf einer Karte anzeigen, um Kunden mehr Vertrauen in die Lieferung zu geben

Im nächsten Schritt werden wir uns jeden Schritt einzeln ansehen.

Schritt 1: Ablauf der Adresseingabe – Place Autocomplete-Dienst verwenden

Implementieren Sie Place Autocomplete mit der JavaScript API in der ersten Zeile des Adresseingabeformulars.

Place Autocomplete bietet dem Kunden Vorschläge, während er seine Adressdetails eingibt. Wenn die JavaScript API verwendet wird, wird unter dem Feld für die Adresseingabe ein Drop-down-Menü angezeigt, sobald Nutzer mit der Eingabe beginnen. Die Ergebnisse des Autocomplete-Dienstes werden bei jeder Eingabe aktualisiert. 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.

Sie können dem Nutzer mit Place Autocomplete zwei Formulareingabestile zur Verfügung stellen: entweder eine Anzeige mit allen Adressfeldern oder eine Anzeige mit einem einzelnen Eingabefeld. Bei 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 überprüfen und bearbeiten kann, z. B. eine Wohnungs- oder Einheitsnummer hinzufügen.

Hier ein Beispiel, 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 beim Zahlungsvorgang 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 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 in einen Zahlungsvorgang:

In diesem Dokument werden später Szenarien für die Adressannahme behandelt.

Schritt 3: Visuelle Bestätigung bereitstellen

Blenden Sie nach der Adresseingabe eine visuelle Bestätigung des Lieferortes ein, indem Sie ihn auf einer Karte anzeigen. 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 Zahlungsvorgangs angezeigt oder in der E‑Mail mit der Transaktionsbestätigung gesendet werden. Für beide Anwendungsfälle können die folgenden APIs verwendet werden.

Die Maps JavaScript API bietet eine interaktive Karte zur Anzeige des Standorts des Nutzers.	Mit der Maps Static API können Bilder in die Webseite oder später in eine E‑Mail eingebettet werden.

Detaillierte Informationen – Szenarien für die Adressannahme

Antworten der Address Validation API lassen sich in drei Hauptszenarien unterteilen:

Problembehebung—Die Adresse ist von geringer Qualität. Sie sollten nach weiteren Informationen fragen.
Bestätigen : Die Adresse ist von hoher Qualität, wurde aber gegenüber der eingegebenen Adresse geändert. Sie sollten um Bestätigung bitten.
Akzeptieren : Die Adresse ist von hoher Qualität. Sie können die angegebene Adresse akzeptieren.

Dieses Konzept wird im Abschnitt Validierungslogik erstellen der Address Validation API-Dokumentation behandelt. In diesem Abschnitt werden die einzelnen Szenarien erläutert.

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 unter Validierungslogik erstellen im Abschnitt Adresse korrigieren.

Wenn die Antwort der Address Validation API eine ungültige Adresse angibt, leiten Sie den Kunden zum Adresseingabeformular 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 der Adresszeile 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 muss, finden Sie in der Dokumentation unter Validierungslogik erstellen im Abschnitt Adresse bestätigen.

Oft ist es sinnvoll, einen Nutzer aufzufordern, eine Adresse zu bestätigen. Beispiel: Ein Kunde gibt den Namen der Stadt falsch ein, was dann von der Address Validation API korrigiert wird. Sie sollten diese Korrektur vom Kunden bestätigen lassen. Das liegt daran, dass die von der API vorgenommenen Änderungen die ursprüngliche Eingabe grundlegend verändern können.

Verwenden Sie ein modales Interstitial, um dem Kunden die Informationen anzuzeigen. Es gibt drei Möglichkeiten, fortzufahren:

Die vom API zurückgegebene Adresse wird bestätigt und der Zahlungsvorgang wird mit der korrigierten Adresse fortgesetzt.
Die Adresse wird wie ursprünglich eingegeben ausgewählt und die Korrektur der Address Validation API wird ignoriert. Der Zahlungsvorgang kann wie gewohnt fortgesetzt werden und die Bestellung kann zur Überprüfung vor dem Versand gekennzeichnet werden, sofern Ihr Prozess dies zulässt.
Der Kunde bricht das modale Fenster ab oder verlässt es und kehrt zur Adresseingabephase des Zahlungsvorgangs zurück. Dort kann er die Adresse noch einmal eingeben und den Vorgang neu starten.

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 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 Validierungslogik erstellen im Abschnitt Adresse akzeptieren.

In diesem Szenario sollte der Zahlungsvorgang mit der nächsten Phase fortgesetzt werden, wahrscheinlich der Zahlungserfassung, ohne dass der Kunde in Bezug auf die Adressqualität aufgefordert wird. Die API hat bestätigt, dass die vom Kunden eingegebene Adresse von guter Qualität und lieferbar ist.

Wir empfehlen, die von der Address Validation API zurückgegebenen Adressdaten mit der Bestellung abzugleichen, da sie möglicherweise kleinere Korrekturen und Ergänzungen enthalten, z. B.:

Großschreibung
Formatierungskorrekturen, z. B.
- Straße zu Str.
- Korrekte Reihenfolge der Adresskomponenten
ZIP+4 in den USA.

Hinweise zur Implementierung

Achten Sie beim Erstellen der Logik für die Adressannahme darauf, dass Kunden nicht daran gehindert werden, den Zahlungsvorgang abzuschließen, weil sie eine ungültige Adresse eingegeben haben. Erstellen Sie die Logik so, dass eine Endlosschleife verhindert wird, wenn die API wiederholt angibt, dass die Eingabe 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 Kunde unabhängig von der Validierung fortfahren können.

Zwei empfohlene Methoden, um den zweiten Versuch zu akzeptieren:

Erzwingen:Blenden Sie dem Kunden ein modales Fenster ein, in dem erklärt wird, dass die Adresse nicht validiert wird. Er kann aber mit der eingegebenen Adresse fortfahren.
Stille Akzeptanz:Akzeptieren Sie den zweiten Versuch automatisch ohne Bestätigungsschritt, auch wenn die Adresse nicht vollständig validiert wird.

Konfigurieren Sie Ihr System nach Möglichkeit so, dass Adressen, die nicht validiert werden, gekennzeichnet werden, damit ein Kundenservicemitarbeiter sie vor dem Versand der Bestellung überprüfen kann. Diese zusätzliche Maßnahme sorgt dafür, dass Fehler erkannt werden.

Der Neubau eines Gebäudes ist ein gutes Beispiel dafür, warum diese Überprüfung empfohlen wird. Es kann eine Lücke zwischen dem Abschluss des Neubaus und dem Zeitpunkt geben, an dem die Adresse des Gebäudes in den Datenbanken für Postadressen erfasst wird. Kunden sollten die Möglichkeit haben, den Zahlungsvorgang mit ihrer eingegebenen Adresse zu erzwingen, auch wenn sie nicht validiert wird.

Nach Abschluss einer Zahlungssitzung können Sie optional die provideValidationFeedback Methode verwenden, um Google Feedback zu einem bestimmten Versuch der Adressbestätigung zu senden.

Fazit

In diesem Dokument wurde ein Überblick über einen Zahlungsvorgang gegeben, bei dem die automatische Vervollständigung, die Adressbestätigung und die visuelle Bestätigung auf einer Google-Karte implementiert werden. Verwenden Sie dieses Dokument als Ausgangspunkt für die Entwicklung Ihrer Implementierung und folgen Sie dabei den empfohlenen Abläufen für die Adresseingabe.

Nächste Schritte

Empfohlene Artikel:

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®. ↩