Adressbestätigung für E-Commerce-Kasse

Ziel

In diesem Dokument werden Methoden beschrieben, mit denen Sie Place Autocomplete, die Address Validation API1 und Maps an E-Commerce-Bezahlvorgängen kombinieren können, um qualitativ hochwertige Adressen zu erfassen.

Voraussetzungen

Google empfiehlt, mit Folgendem vertraut zu sein:

  • Place Autocomplete für JavaScript-Entwicklerdokumentation
    • Hier erfahren Sie aus technischer Sicht, wie Place Autocomplete funktioniert und welche Implementierungsoptionen es bietet.
  • Leitfaden zur Implementierung des Checkout-Artikels 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 mit dem Schwerpunkt Validierungslogik erstellen.
    • Erfahren Sie aus technischer Sicht, wie die Address Validation API funktioniert, und prüfen Sie die Signale, die die Adressqualität 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 wird die Postadresse standardisiert und die besten bekannten Breiten- und Längengrade dafür ermittelt. Für Adressen in den USA und Puerto Rico können Sie optional das Coding Accuracy Support System (CASSTM) aktivieren.

Warum muss an der Kasse die Adresse bestätigt werden?

Korrekte Adressen während des Bestellprozesses erfassen:
Dies ist ein wichtiger Schritt zur Förderung erfolgreicher Lieferungen, zur Steigerung der pünktlichen Abwicklung und zur Reduzierung kostspieliger Kosten für die Adresskorrektur.

Kunden bei der schnellen und genauen Eingabe der Adresse unterstützen:
Place Autocomplete beschleunigt die Adresseingabe und reduziert Eingabefehler, sodass Kunden den Bezahlvorgang leichter abschließen können. Mit Address Validation erhalten Sie Feedback zur allgemeinen Adressqualität, nehmen Korrekturen wie Standardisierungs- und Rechtschreibfehler vor und verbessern Metadaten, z. B. die Angabe einer Wohn- oder Gewerbeanzeige (in ausgewählten Regionen verfügbar).

Implementierungsübersicht

In diesem Abschnitt wird der empfohlene Workflow zur Adresseingabe für E-Commerce-Bezahlvorgänge erläutert. Der Prozess umfasst drei Schritte:

  1. Verwenden Sie Place Autocomplete, um die Adresse anfangs zu erfassen.
  2. Verwenden Sie die Address Validation API, um die eingegebene Adresse zu bestätigen.
  3. Zeigen Sie den Standort der eingegebenen Adresse auf einer Karte an, um die Liefersicherheit für Kunden zu erhöhen.

Als Nächstes gehen wir auf jeden Schritt einzeln ein.

Schritt 1: Adresseingabe – mit dem „Place Autocomplete“-Dienst

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

„Place Autocomplete“ unterbreitet dem Kunden während der Eingabe seiner Adresse Vorschläge. Wenn Nutzer bei der Implementierung über die JavaScript API mit der Eingabe beginnen, wird unter dem Formularfeld für die Adresseingabe ein Drop-down-Menü mit Ergebnissen des Autocomplete-Dienstes angezeigt, die mit jedem Tastenanschlag aktualisiert werden. Nachdem der Nutzer genügend Informationen eingegeben hat, um die Adresse zu finden, wählt er sie im Drop-down-Menü aus. Dadurch werden die Adressdaten automatisch in die Formularfelder eingefügt.

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 einem einzelnen Eingabefeld. In diesem einen Eingabefeld wird der Nutzer aufgefordert, die Suche bereits bei der Eingabe zu beginnen, anstatt die Adresskomponenten einzeln einzugeben. Sobald die Adresse durch die automatische Vervollständigung ausgefüllt ist, werden die Formularfelder im Workflow um die Adressdaten erweitert. Der Kunde kann diese 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:

Image

Schritt 2: Address Validation API zum Validieren von Adressen verwenden

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. Einen Aufruf der Address Validation API auslösen, sobald der Nutzer im Adressformular auf „Weiter“ oder „Weiter“ klickt. 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:

Image

In diesem Dokument werden später Szenarien für die Adressakzeptanz erläutert.

Schritt 3: Visuelle Bestätigung bereitstellen

Nach der Adresseingabe kannst du dem Nutzer den Lieferort visuell bestätigen, indem du ihn auf einer Karte anzeigst. 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 E-Mail mit der Transaktionsbestätigung gesendet werden. Beide Anwendungsfälle lassen sich mit den folgenden APIs umsetzen.

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 beheben: Die Adresse hat eine niedrige Qualität. Sie sollten nach weiteren Informationen fragen.
  • Bestätigen: Die Adresse ist hochwertig, hat sich aber gegenüber der eingegebenen Adresse geändert. Möglicherweise fordern Sie eine Bestätigung auf.
  • Akzeptieren: Die Adresse ist hochwertig. Sie können die angegebene Adresse übernehmen.

Dieses Konzept wird im Abschnitt Validierungslogik erstellen der Dokumentation zur Address Validation API behandelt und wir werden jedes Szenario in diesem Abschnitt besprechen.

Problembehebung

Image

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 unter Adresse korrigieren in der Dokumentation zum Erstellen deiner Validierungslogik.

Wenn die Antwort der Address Validation API auf eine ungültige Adresse hinweist, leite den Kunden zum Adresseingabeformular weiter, um die eingegebenen Daten zu prüfen. Sobald die Adresse korrigiert wurde, sollte Ihr Dienst eine neue Nachricht 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 hierfür sehen Sie im Screenshot rechts.

Bestätigen

Image

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, findest du in der Dokumentation zum Erstellen einer Validierungslogik unter Adresse bestätigen.

Häufig wird der Nutzer vom System aufgefordert, eine Adresse zu bestätigen. Beispiel: Ein Kunde falsch geschrieben hat den Namen der Stadt, was dann von der Address Validation API korrigiert wird. Klären Sie diese Korrektur mit dem Kunden ab. Das liegt daran, dass die von der API vorgenommenen Änderungen die ursprünglich eingegebenen Daten grundlegend ändern können.

Verwenden Sie ein Interstitial-Modaldialogfeld, um dem Kunden die Informationen anzuzeigen. Sie haben dann drei Möglichkeiten, fortzufahren:

  1. Bestätigen Sie die von der API zurückgegebene Adresse. Der Bezahlvorgang wird mit der korrigierten Adresse fortgesetzt.
  2. 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 nachgelagerten Überprüfung gekennzeichnet werden, wenn Ihr Prozess dies zulässt.
  3. 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 Prozess von vorn beginnen.

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 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 in die nächste Phase übergehen, wahrscheinlich die Zahlungserfassung. Der Kunde erhält keine Aufforderungen zur Adressqualität. Die API hat bestätigt, dass die vom Kunden eingegebene Adresse eine gute Qualität und einen Liefergegenstand hat.

Wir empfehlen, für die Bestellung die zurückgegebenen Adressdaten der Address Validation API zu verwenden, da diese kleinere Korrekturen und Ergänzungen enthalten kann, z. B.:

  • Großschreibung
  • Formatierungskorrekturen, z. B.
    • Straße nach St
    • Korrekte Reihenfolge der Adresskomponenten
  • ZIP+4 in den USA.

Hinweise zur Implementierung

Wenn du eine Logik zur Annahme von Adressen erstellst, achte darauf, dass deine Implementierung Kunden nicht daran hindert, den Bezahlvorgang aufgrund einer ungültigen Adresse zu blockieren. Erstellen der Logik so, dass eine Endlosschleife vermieden wird, wenn die API wiederholt angibt, dass ihr Eintrag ungültig ist.

Google empfiehlt, dass Sie Kunden maximal zwei Möglichkeiten bieten, ihre Adresse einzugeben, und beim zweiten Versuch die Eingabe akzeptieren, auch wenn sie nicht validiert wird. Beim zweiten Versuch besteht das Ziel darin, dass sie unabhängig von der Validierung fortfahren können.

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 validiert wird. Lasse aber die Option zu, mit der eingegebenen Adresse fortzufahren.
  • 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 Lücke zwischen dem Abschluss des Neubaus und der Erfassung der Adresse dieses Gebäudes in den Adressdatenbanken geben. Kunden sollten die Möglichkeit haben, den Zugriff auf die Zahlungsseite mit ihrer eingegebenen Adresse zu erzwingen, auch wenn diese nicht bestätigt werden kann.

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 Bezahl, Zustellung und Abläufe mit zuverlässigen Adressen verbessern herunter und sehen Sie sich das Webinar Bezahlvorgang, Bereitstellung und Abläufe mit Address Validation verbessern 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 Eigentum des United States Postal Service® und werden mit dessen Erlaubnis verwendet: CASSTM, USPS®, DPV®. ↩