Adressbestätigung für die Kaufabwicklung

Ziel

In diesem Dokument werden Methoden zum Kombinieren von Place Autocomplete, der Address Validation API1 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.
    • Verstehen Sie aus technischer Sicht, wie Place Autocomplete funktioniert und welche Implementierungsoptionen es gibt.
  • 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 : Produktdokumentation, insbesondere den Abschnitt Validierungslogik erstellen
    • Verstehen Sie aus technischer Sicht, wie die Address Validation API funktioniert, und sehen Sie sich die Signale an, die die Adressqualität bestimmen.

Was ist Adressbestätigung?

Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert. Sie identifiziert Adresskomponenten und validiert sie. Außerdem standardisiert sie die Adresse für den Postversand und ermittelt die genauesten Längen- und Breitengradkoordinaten dafür. 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:

  1. Verwenden Sie Place Autocomplete, um die Adresse 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 Kunden Vertrauen in die Lieferung zu geben.

Als Nächstes werden die einzelnen Schritte genauer erläutert.

Schritt 1: Ablauf der Adresseingabe – Verwendung des Place Autocomplete-Dienstes

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 mit jedem Tastendruck 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 anbieten: entweder eine Anzeige mit allen Adressfeldern oder eine Anzeige mit einem einzelnen Eingabefeld. Dieses einzelne Eingabefeld fordert den Nutzer auf, mit der Suche zu beginnen, während er tippt, anstatt Adresskomponenten einzeln einzugeben. Sobald die automatische Vervollständigung die Adresse eingegeben hat, 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:

Image

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:

Image

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 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 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

Image

In diesem Abschnitt wird beschrieben, wie Sie eine Adresseingabe korrigieren. Informationen zu bestimmten Signalen, die die Address Validation API zurückgibt, um eine Adresse von geringer Qualität anzugeben, finden Sie in der Dokumentation Validierungslogik erstellen unter 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

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 Validierungslogik erstellen unter 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ünglich eingegebenen Daten grundlegend verändern können.

Verwenden Sie ein modales Interstitial, um dem Kunden die Informationen anzuzeigen. So hat er drei Möglichkeiten, fortzufahren:

  1. Bestätigen Sie die von der API zurückgegebene Adresse. Der Zahlungsvorgang 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 Zahlungsvorgang kann wie gewohnt fortgesetzt werden. Die Bestellung kann zur Überprüfung vor dem Versand gekennzeichnet werden, wenn Ihr Prozess dies zulässt.
  3. Der Kunde bricht das modale Fenster ab oder verlässt es. Er wird zur Adresseingabephase des Zahlungsvorgangs zurückgeleitet, wo er die Adresse noch einmal eingeben kann. Der Prozess beginnt dann von vorn.

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, finden Sie in der Dokumentation Validierungslogik erstellen unter 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
  • Korrekturen der Formatierung, 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 Vorschläge für die Annahme des zweiten Versuchs:

  • Erzwingen:Zeigen Sie dem Kunden ein modales Fenster an, in dem erklärt wird, dass die Adresse nicht validiert wird. Er soll aber die Möglichkeit haben, mit der eingegebenen Adresse fortzufahren.
  • Stille Annahme:Akzeptieren Sie den zweiten Versuch automatisch ohne Bestätigungsschritt, auch wenn die Adresse nicht vollständig validiert wird.

Wenn möglich, kennzeichnen Sie in Ihrem System Adressen, die nicht validiert werden, 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 Überprüfung empfehlenswert ist. Es kann eine Lücke zwischen dem Abschluss des Neubaus und dem Zeitpunkt bestehen, an dem die Adresse des Gebäudes in die Datenbanken für Postadressen aufgenommen 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 Bezahlvorgang gegeben, bei dem die automatische Vervollständigung, die Address Validation 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 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

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