Validation de l'adresse pour le règlement e-commerce

Objectifs

Ce document décrit les méthodes permettant d'associer Place Autocomplete, l'API Address Validation1 et Maps dans un processus de paiement d'e-commerce dans le but d'enregistrer des adresses de haute qualité.

Conditions préalables

Google vous recommande de vous familiariser avec les éléments suivants:

  • Documentation pour les développeurs JavaScript pour Place Autocomplete
    • Comprenez d'un point de vue technique le fonctionnement de Place Autocomplete, ainsi que ses options d'implémentation.
  • Guide d'implémentation des paiements pour Place Autocomplete.
    • Exemples de bonnes pratiques d'implémentation de Place Autocomplete pour un règlement d'e-commerce.
  • Documentation de l'API Address Validation, axée sur la création de votre logique de validation.
    • Comprenez d'un point de vue technique le fonctionnement de l'API Address Validation et examinez 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 l'adresse pour le publipostage et trouve les coordonnées de latitude/longitude les plus connues pour celle-ci. Si vous résidez aux États-Unis et à Porto Rico, vous pouvez éventuellement activer le système CASSTM (Coding Accuracy Support System).

Pourquoi devez-vous valider votre adresse lors du règlement ?

Collectez les adresses précises pendant le processus de commande:
Il s'agit d'une étape importante pour assurer la réussite des livraisons, augmenter le respect des délais de traitement et réduire les frais de correction d'adresse coûteux.

Guidez les clients pour qu'ils saisissent l'adresse rapidement et précisément:
Place Autocomplete accélère la saisie de l'adresse et réduit les erreurs de saisie, ce qui permet aux clients de passer facilement au processus de paiement. Address Validation fournit des commentaires sur la qualité globale des adresses, apporte des corrections telles que la normalisation et les erreurs d'orthographe, et améliore les métadonnées, par exemple en fournissant un indicateur résidentiel ou commercial (disponible dans certaines régions).

Présentation de l'implémentation

Cette section décrit le workflow recommandé pour la saisie d'adresse pour les paiements en ligne. Le processus comprend trois étapes:

  1. Utilisez Place Autocomplete pour capturer initialement l'adresse.
  2. Utilisez l'API Address Validation pour confirmer l'adresse saisie.
  3. Affichez l'emplacement de l'adresse saisie sur une carte pour que les clients puissent recevoir leurs commandes en toute confiance.

Nous allons maintenant examiner chaque étape individuellement.

Étape 1: Flux de saisie d'adresse – avec le service Place Autocomplete

Implémentez Place Autocomplete à 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 ses coordonnées. Lorsqu'elle est implémentée à l'aide de l'API JavaScript, lorsque les utilisateurs commencent à saisir du texte, une liste déroulante s'affiche sous le champ du formulaire de saisie d'adresse. Elle affiche les résultats du service Autocomplete mis à jour à chaque frappe. Une fois que l'utilisateur a saisi suffisamment d'informations pour trouver l'adresse, il la sélectionne dans le menu déroulant. Cette action remplit automatiquement les champs du formulaire avec les données d'adresse.

Avec Place Autocomplete, vous pouvez proposer deux styles de saisie de formulaire à l'utilisateur : soit un affichage avec tous les champs d'adresse, soit un affichage avec un seul champ de saisie. Ce champ de saisie unique invite l'utilisateur à lancer une recherche au cours de sa saisie au lieu de saisir les composants d'adresse individuellement. Une fois que la saisie semi-automatique a rempli l'adresse, le workflow développe les champs du formulaire avec les données d'adresse, ce qui permet au client de vérifier et d'apporter des modifications, par exemple en ajoutant un numéro d'appartement ou de logement.

Voici un exemple de ce flux, à l'aide d'un seul champ de saisie:

Image

Étape 2: Utiliser l'API Address Validation pour valider les adresses

Une fois l'adresse saisie par l'utilisateur, Google vous recommande d'appeler l'API Address Validation lors du règlement pour vérifier que l'adresse est valide et complète. Déclenchez un appel vers l'API Address Validation lorsque l'utilisateur clique sur le bouton "Suivant" ou "Continuer" du 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 de l'API Address Validation dans un processus de paiement:

Image

Ce document aborde ultérieurement les scénarios d'acceptation d'adresses.

Étape 3: Fournir une confirmation visuelle

Une fois l'adresse saisie, affichez la carte pour une confirmation visuelle du lieu de livraison. Le client a ainsi l'assurance que l'adresse est correcte, et cela réduit le nombre d'échecs de livraison ou de retrait.

La carte peut être affichée lors du processus de paiement ou envoyée dans l'e-mail de confirmation de la transaction. Ces deux cas d'utilisation peuvent être réalisés à l'aide des 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.
  • Confirm (Confirmer) : l'adresse est de haute qualité, mais a été modifiée par rapport à l'adresse d'entrée. Vous pouvez demander confirmation.
  • Accepter : l'adresse est de haute qualité. Vous pouvez accepter l'adresse fournie.

Ce concept est abordé dans la section Créer votre logique de validation de la documentation sur l'API Address Validation. Nous aborderons chaque scénario dans cette section.

Solution

Image

Cette section explique comment corriger une adresse saisie. Pour en savoir plus sur les signaux spécifiques renvoyés par l'API Address Validation pour indiquer une adresse de faible qualité, consultez la section 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, redirigez le client vers le formulaire de saisie d'adresse pour vérifier les données qu'il a saisies. Une fois l'adresse corrigée, votre service doit renvoyer l'adresse à l'API Address Validation pour s'assurer que les corrections apportées sont valides.

Vous pouvez également mettre en évidence des erreurs spécifiques dans la ligne d'adresse à l'aide des signaux renvoyés au niveau addressComponents. La capture d'écran de droite illustre ce cas de figure.


Confirmer

Image

Cette section explique comment confirmer une adresse. Pour en savoir plus sur les signaux spécifiques renvoyés par l'API Address Validation pour indiquer qu'une adresse doit être confirmée, consultez la section Confirmer une 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 l'API Address Validation. Vous devez confirmer la correction avec le client. En effet, les modifications apportées par l'API peuvent modifier fondamentalement ce qui a été saisi à l'origine.

Utilisez une fenêtre modale interstitielle pour présenter les informations au client et lui permettre de continuer avec trois options:

  1. Vérifiez que l'adresse renvoyée par l'API se poursuit. Le processus de règlement se poursuit en utilisant l'adresse corrigée.
  2. Sélectionnez l'adresse saisie initialement, en ignorant la correction de l'API Address Validation. Le processus de paiement peut se poursuivre normalement, et la commande peut être signalée pour examen en aval avant l'expédition, si votre processus le permet.
  3. Le client annule ou quitte la fenêtre modale, et le renvoie à l'étape de saisie de l'adresse du processus de paiement, où il peut saisir à nouveau l'adresse à partir de zéro et recommencer 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 les signaux spécifiques renvoyés par l'API Address Validation pour indiquer qu'une adresse est de bonne qualité 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 règlement doit passer à l'étape suivante, probablement la capture des paiements, sans invite le client à traiter les questions de qualité. L'API a confirmé que l'adresse saisie par le client est de bonne qualité et qu'elle peut être livrée.

Nous vous recommandons d'utiliser les données d'adresse renvoyées par l'API Address Validation pour la commande, car elles pourraient contenir 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 créez votre logique d'acceptation d'adresse, assurez-vous que votre implémentation n'empêche pas les clients de passer au paiement s'ils ont saisi une adresse non valide. Construisez une logique de manière à éviter l'éventualité d'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 adresse et, lors de la deuxième tentative, d'accepter leur entrée, même si elle n'est pas validée. Lors de la deuxième tentative, l'objectif est de les laisser poursuivre quelle que soit 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 validée, mais autorisez l'option permettant de poursuivre sa saisie.
  • Acceptation silencieuse:acceptez automatiquement la deuxième tentative sans étape de confirmation, même si l'adresse n'est pas complètement validée.

Si possible, concevez votre système de manière à signaler les adresses non valides, afin qu'un conseiller clientèle puisse les examiner avant l'expédition de la commande. Cette mesure supplémentaire vous permet de détecter toute erreur éventuelle.

La construction de nouveaux bâtiments illustre bien les raisons pour lesquelles cette vérification est recommandée. Il peut y avoir un écart entre la fin de la construction du bâtiment et le moment où l'adresse de ce bâtiment est renseignée dans les bases de données d'adresses postales. Les clients doivent avoir la possibilité de forcer la navigation sur la page de paiement avec leur adresse saisie, même si celle-ci n'a pas été validée.

Une fois la session de paiement terminée, vous pouvez éventuellement utiliser la méthode provideValidationFeedback pour envoyer à Google des commentaires sur une tentative de validation d'adresse spécifique.

Conclusion

Ce document présente le processus de paiement mettant en œuvre la saisie semi-automatique, la validation des adresses et la confirmation visuelle sur une carte Google Maps. Utilisez ce document comme point de départ pour concevoir votre implémentation, en suivant les flux de saisie d'adresse recommandés.

Étapes suivantes

Téléchargez le livre blanc Améliorer le processus de paiement, la livraison et les opérations avec des adresses fiables , et regardez le webinaire Améliorer les processus de paiement, de livraison et des opérations avec la validation des adresses .

Documentation complémentaire suggérée:

Contributeurs

Henrik Valve | Ingénieur en solutions
Thomas Anglaret | Ingénieur en solutions
Sarthak Ganguly | Ingénieur en solutions


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