Adressbestätigung für E-Commerce-Kasse

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, sich mit Folgendem vertraut zu machen:

Was ist die Adressbestätigung?

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 am besten bekannten Breiten-/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 die Bestätigung der Adresse an der Kasse erforderlich?

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.

Hilf Kunden, die Adresse schnell und korrekt einzugeben:
Die automatische Vervollständigung von Orten beschleunigt die Adresseingabe und reduziert Eingabefehler, sodass Kunden den Bezahlvorgang ganz einfach durchlaufen 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:

  1. Verwenden Sie Place Autocomplete, um die Adresse anfänglich zu erfassen.
  2. Verwenden Sie die Address Validation API, um die eingegebene Adresse zu bestätigen.
  3. 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: Ablauf der Adresseingabe – Place Autocomplete-Dienst verwenden

Implementieren Sie Place Autocomplete mithilfe der JavaScript API in der ersten Zeile des Adresserfassungsformulars.

Die automatische Ortsvervollständigung (Place Autocomplete) macht dem Kunden Vorschläge, während er seine Adressdetails eingibt. Wenn die Funktion mit der JavaScript API implementiert ist, wird beim Tippen ein Drop-down-Menü unter dem Adresseingabefeld 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 mit den Adressdaten erweitert. So kann der Kunde sie prüfen und bearbeiten, z. B. eine Wohnungs- oder Hausnummer hinzufügen.

Hier ein Beispiel für diesen Ablauf mit einem einzigen Eingabefeld:

Image

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 die End-to-End-Integration der Address Validation API in einem Bezahlvorgang:

Image

In diesem Dokument werden später Szenarien für die Annahme von Adressen beschrieben.

Schritt 3: Visuelle Bestätigung

Blenden Sie nach der Adresseingabe eine visuelle Bestätigung des Lieferorts 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 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, 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.

Detaillierte Informationen – Szenarien für die Akzeptanz von Adressen

Antworten der API zur Adressvalidierung lassen sich in drei Hauptszenarien unterteilen:

  • Korrigieren: Die Qualität der Adresse ist niedrig. 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

Image

In diesem Abschnitt erfahren Sie, wie Sie eine Adresse korrigieren. Informationen zu den spezifischen Signalen, die die Address Validation API zurückgibt, um eine Adresse mit 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 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

Image

In diesem Abschnitt wird beschrieben, 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.

Häufig soll ein Nutzer in Ihrem System aufgefordert werden, 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:

  1. Bestätigen Sie die von der API zurückgegebene Adresse. Der Bezahlvorgang wird dann mit der korrigierten Adresse fortgesetzt.
  2. Wählen Sie die Adresse so aus, wie sie ursprünglich eingegeben wurde, 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.
  3. Der Kunde schließt das Modalfenster oder bricht es ab und kehrt zur Adresseingabe im Bezahlvorgang zurück. Dort kann er die Adresse noch einmal eingeben und den Vorgang wiederholen.

Ein Beispiel dafür sehen Sie im Screenshot rechts.

Akzeptieren

In diesem Abschnitt wird beschrieben, wie Sie eine Adresse akzeptieren. Informationen zu den spezifischen Signalen, die die Address Validation API zurückgibt, um anzugeben, dass eine Adresse von guter Qualität ist und akzeptiert werden sollte, finden Sie in der Dokumentation zum Erstellen Ihrer Validierungslogik unter Adresse akzeptieren.

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, Kunden bis zu zwei Möglichkeiten zur Eingabe ihrer Adresse zu geben und bei einem zweiten Versuch die Eingabe zu akzeptieren, auch wenn sie nicht gültig ist. Beim zweiten Versuch soll der Nutzer unabhängig von der Validierung fortfahren können.

Zwei Methoden, wie Sie den zweiten Versuch akzeptieren können:

  • 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 ohne Bestätigungsschritt akzeptiert, auch wenn die Adresse nicht vollständig validiert wurde.

Achten Sie darauf, dass Ihr System Adressen, die nicht gültig sind, kennzeichnet, damit ein Kundenservicemitarbeiter sie vor dem Versand der Bestellung prüfen kann. So können Sie Fehler vermeiden.

Der Neubau ist ein gutes Beispiel dafür, 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.

Nachdem eine Zahlungssitzung abgeschlossen wurde, können Sie optional die Methode provideValidationFeedback verwenden, um Google Feedback zu einem bestimmten Versuch zur Adressbestätigung zu senden.

Fazit

In diesem Dokument wurde ein Bezahlvorgang mit automatischer Vervollständigung, Adressbestätigung und visueller Bestätigung auf einer Google-Karte beschrieben. Verwenden Sie dieses Dokument als Ausgangspunkt für die Implementierung und folgen Sie den empfohlenen Abläufen für die 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.

Weitere Informationen:

Beitragende

Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Solutions Engineer

  1. Nicht exklusiver Lizenznehmer des United States Postal Service. Die folgenden Marken sind eingetragene Marken von United States Postal Service® und werden mit dessen Zustimmung verwendet: CASS™, USPS®, DPV®. ↩