Objectif
Ce document décrit les méthodes permettant de combiner Place Autocomplete, Address l'API de validation1 et Maps dans un processus de paiement d'e-commerce dans le but de en collectant des adresses de haute qualité.
Prérequis
Google vous recommande de vous familiariser avec les éléments suivants:
- Développeur Place Autocomplete JavaScript
documentation.
- Comprendre d'un point de vue technique comment Place Autocomplete et ses options de mise en œuvre.
- Guide d'implémentation des paiements pour Google Adresses
Saisie semi-automatique.
- Exemples de bonnes pratiques d'implémentation de Place Autocomplete sur une le paiement en ligne.
- Produit API Address Validation
documentation,
en nous concentrant sur l'élaboration de votre
logique.
- Comprendre d'un point de vue technique comment l'API Address Validation et examiner les signaux qui déterminent la qualité des adresses.
Qu'est-ce que la validation d'adresse ?
L'API Address Validation est un service qui accepte une adresse. Il identifie les composants d'adresse et les valide. Elle standardise également pour le publipostage et trouve ses coordonnées de latitude/longitude les plus connues. Pour les adresses aux États-Unis et à Porto Rico, vous pouvez éventuellement le système CASSTM (Coding Accuracy Support System).Pourquoi devez-vous valider votre adresse lors du règlement ?
Collectez les adresses exactes pendant le processus de commande:
Il s'agit d'une étape importante pour promouvoir
des livraisons réussies, augmente la ponctualité
le traitement des commandes, et réduit les frais de correction d'adresse coûteux.
Indiquez aux clients comment saisir l'adresse rapidement et précisément
:
Place Autocomplete accélère la saisie d'adresses et réduit les erreurs de saisie, ce qui permet
aux clients de passer facilement au processus de paiement. Address Validation donne des commentaires
sur la qualité globale de l'adresse, apporte des corrections telles que la normalisation et
les fautes d'orthographe et améliore les métadonnées, comme l'ajout d'une adresse
indicateur commercial (disponible dans
régions.
Présentation de l'implémentation
Cette section décrit le workflow recommandé pour la saisie d'adresse pour l'e-commerce paiements. Le processus comprend trois étapes:
- Utilisez Place Autocomplete pour capturer initialement l'adresse.
- Utilisez l'API Address Validation pour confirmer l'adresse saisie.
- Afficher l'emplacement de l'adresse saisie sur une carte pour permettre la livraison pour faire confiance aux clients.
Nous allons maintenant examiner chaque étape individuellement.
Étape 1: Flux de saisie d'adresse – avec le service Place Autocomplete
Implémentez Place Saisie semi-automatique à l'aide de l'API JavaScript sur la première ligne du formulaire de saisie d'adresse.
Place Autocomplete propose des suggestions au client lorsqu'il saisit sa les détails de l'adresse. Si elle est implémentée à l'aide de l'API JavaScript, lorsque les utilisateurs une liste déroulante s'affiche sous le champ du formulaire de saisie d'adresse et affiche les résultats du service de saisie semi-automatique qui se mettent à jour à chaque frappe. Une fois que l’utilisateur a saisi suffisamment d'informations pour trouver l'adresse, il la sélectionne dans le liste déroulante. Cette action remplit automatiquement les champs du formulaire avec l'adresse données.
Vous pouvez proposer deux styles de saisie de formulaire à l'utilisateur avec Place Autocomplete: soit un écran avec tous les champs d'adresse, soit un écran avec une seule entrée . Ce champ de saisie unique invite l'utilisateur à commencer une recherche pendant qu'il tape, plutôt que de saisir les composants d'adresse individuellement. Une fois la saisie semi-automatique renseigne l'adresse, le workflow développe les champs du formulaire avec l'adresse Il peut ainsi les examiner et les modifier, par exemple en ajoutant numéro d'appartement ou de logement.
Voici un exemple de ce flux, à l'aide d'un seul champ de saisie:
Étape 2: Utiliser l'API Address Validation pour valider les adresses
Une fois que l'utilisateur a saisi l'adresse, Google vous recommande d'appeler la fonction Adresse Validation API lors du règlement pour confirmer que l'adresse est valide et complète. Déclencher un appel vers l'API Address Validation lorsque l'utilisateur clique sur le bouton "Suivant" ou "Continuer" le formulaire d'adresse. Ce bouton mène souvent à la page de paiement.
Google recommande d'appeler l'API Address Validation pour chaque transaction.
Le schéma de flux suivant illustre un exemple d'intégration de bout en bout API Address Validation lors d'un paiement:
Ce document aborde ultérieurement les scénarios d'acceptation d'adresses.
Étape 3: Fournir une confirmation visuelle
Une fois l'adresse saisie, présentez à l'utilisateur une confirmation visuelle de la livraison. en l'affichant sur une carte. Cela offre au client s'assurer que l'adresse est correcte, et que cela réduit la livraison ou le retrait d'échecs.
La carte peut être affichée lors du règlement ou envoyée lors de la transaction e-mail de confirmation. Ces deux cas d'utilisation peuvent être réalisés API suivantes.
L'API Maps JavaScript fournit une carte interactive permettant d'afficher la position de l'utilisateur. | L'API Maps Static permet d'intégrer des images dans une page Web ou ultérieurement dans un e-mail. |
---|---|
![]() |
![]() |
Présentation détaillée – Scénarios d'acceptation
Les réponses de l'API Address Validation peuvent être classées dans trois scénarios principaux:
- Corriger : l'adresse est de mauvaise qualité. Vous devriez demander plus d'informations.
- Confirmer : l'adresse est de bonne qualité, de l'adresse d'entrée. Vous pourriez demander à confirmation.
- Accept (Accepter) : l'adresse est de haute qualité. Vous pouvez acceptez l'adresse indiquée.
Ce concept est abordé dans la leçon Créer votre logique de la documentation sur l'API Address Validation, et nous aborderons chaque scénario dans cette section.
Corriger
Cette section explique comment corriger une adresse saisie. Pour en savoir plus sur des que l'API Address Validation renvoie pour indiquer une faible qualité consultez l'article Corriger une adresse dans la documentation "Créer votre logique de validation".
Si la réponse de l'API Address Validation indique une adresse non valide, rediriger le client vers le formulaire de saisie de l'adresse afin de vérifier les données qu'il a saisies. Une fois l'adresse corrigée, votre service devrait renvoyer à l'adresse L'API de validation permet de vérifier la validité des corrections apportées.
Vous pouvez également mettre en évidence des erreurs spécifiques à la ligne d'adresse à l'aide des signaux
renvoyé au niveau addressComponents
. Vous trouverez un exemple dans la section
sur la droite.
Confirmer
Cette section explique comment confirmer une adresse. Pour en savoir plus sur des que renvoie l'API Address Validation pour indiquer qu'une adresse doit être confirmée, reportez-vous à la section Confirmer adresse dans la documentation "Créer votre logique de validation".
Souvent, le système invite l'utilisateur à confirmer une adresse. Par exemple : un client fait une faute d'orthographe dans le nom de la ville, qui est ensuite corrigé par le champ l'API de validation. Vous devez confirmer la correction avec le client. En effet, les modifications apportées par l'API peuvent modifier fondamentalement ce qui était à l'origine saisi.
Utiliser une fenêtre modale interstitielle pour présenter les informations au client trois options pour continuer:
- Confirmer l'adresse renvoyée par l'API et le processus de paiement en utilisant l'adresse corrigée.
- Sélectionnez l'adresse saisie initialement, en ignorant la correction apportée à API Address Validation. Le processus de règlement se poursuit normalement et la commande peut être signalée pour être examinée en aval avant son expédition, si votre processus autorise.
- Le client annule ou quitte la fenêtre modale, et le renvoie à la l'étape d'entrée du processus de paiement, au cours de laquelle ils peuvent accéder à nouveau adresse à partir de zéro, en recommençant le processus.
La capture d'écran de droite illustre ce cas de figure.
Accepter
Cette section explique comment accepter une adresse. Pour en savoir plus sur des indique que l'API Address Validation indique qu'une adresse est correcte et doit être acceptée, consultez la section Accepter une adresse dans la documentation "Créer votre logique de validation".
Dans ce scénario, le processus de paiement doit passer à l'étape suivante, probablement Capture des paiements, sans invite le client concernant la qualité de l'adresse. L'API a confirmé que l'adresse saisie par le client est de bonne qualité, et des produits livrables.
Nous vous recommandons d'utiliser les données d'adresse renvoyées par l'API Address Validation. à l'encontre de l'ordonnance, car celle-ci pouvait inclure des corrections et des ajouts mineurs, par exemple:
- Minuscules/Majuscules
- Corrections de mise en forme, par exemple
- De la rue à la rue
- Ordre des composants d'adresse correct
- ZIP+4 aux États-Unis.
Observations relatives à la mise en œuvre
Lorsque vous élaborez votre logique d'acceptation des adresses, assurez-vous que votre implémentation ne empêcher les clients de payer s'ils ont saisi une adresse non valide. Construire de manière à éviter une boucle infinie si l'API indique à plusieurs reprises que son entrée n'est pas valide.
Google vous recommande d'offrir aux clients jusqu'à deux occasions de saisir leur et, lors de la deuxième tentative, accepter sa demande, valider. Lors de la deuxième tentative, l'objectif est de le laisser poursuivre, indépendamment la validation.
Deux méthodes sont suggérées pour accepter la deuxième tentative:
- Force-proceed:montrez au client une fenêtre modale expliquant que l'adresse n'est pas en cours de validation, tout en laissant la possibilité de continuer avec l'adresse saisie.
- Acceptation silencieuse:accepte automatiquement la deuxième tentative sans confirmation, même si l'adresse n'est pas entièrement validée.
Si possible, concevez votre système de manière à signaler les adresses non valides, de sorte qu'une un conseiller clientèle peut les examiner avant l'expédition de la commande. Ce une mesure supplémentaire vous garantit de détecter toute erreur.
La construction de nouveaux bâtiments illustre bien l'importance de cette vérification recommandé. Il peut y avoir un décalage entre la date de terminé et que l'adresse du bâtiment est insérée dans le champ les bases de données. Les clients doivent avoir la possibilité de forcer la procédure via page de paiement et l'adresse saisie, même si la validation n'a pas été effectuée.
Une fois le règlement effectué, vous pouvez éventuellement utiliser la
provideValidationFeedback
pour envoyer à Google des commentaires sur une tentative de validation d'adresse spécifique.
Conclusion
Ce document vous a donné un aperçu de l'implémentation d'un processus de paiement. Autocomplete, Address Validation et confirmation visuelle sur une carte Google Maps Utilisez ce document comme point de départ pour concevoir votre implémentation, conformément aux de flux recommandés pour la saisie d'adresses.
Étapes suivantes
Téléchargez l'application Améliorez les processus de paiement, de livraison et d'exploitation grâce à des adresses fiables Livre blanc et consultez le module Améliorer les processus de paiement, de livraison et des opérations avec Validation .
Documentation complémentaire suggérée:
- Documentation Place Autocomplete
- Documentation de l'API Address Validation
- Rapports Google Maps Platform
Contributeurs
Henrik Valve | Ingénieur solutions
Thomas Anglaret | Ingénieur solutions
Sarthak Ganguly | Ingénieur solutions
-
Licencié non exclusif du service postal des États-Unis. La ou les marques suivantes appartiennent au service postal des États-Unis(United States Postal Service®) et sont utilisées avec son autorisation: CASSTM, USPS®, DPV®. ↩