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

Objectif

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

Prérequis

Google recommande de bien connaître les éléments suivants :

  • Place Autocomplete JavaScript documentation pour les développeurs.
    • Découvrez d'un point de vue technique comment fonctionne Place Autocomplete et ses options d'implémentation.
  • Guide d'implémentation du règlement pour Place Autocomplete
    • Exemples de bonnes pratiques d'implémentation de Place Autocomplete sur une page de paiement d'e-commerce.
  • Documentation produit de l'API Address Validation, en particulier la section Créer votre logique de validation.
    • Découvrez d'un point de vue technique comment fonctionne l'API Address Validation et examinez les signaux qui déterminent la qualité des adresses.

Qu'est-ce que la validation de l'adresse ?

L'API Address Validation est un service qui accepte une adresse. Elle identifie les composants d'une adresse et les valide. Elle standardise également l'adresse pour la distribution postale et trouve les meilleures coordonnées de latitude/longitude connues. Vous pouvez éventuellement activer le système CASS™ (Coding Accuracy Support System) pour les adresses aux États-Unis et à Porto Rico.

Pourquoi avez-vous besoin de valider l'adresse lors du règlement ?

Collectez des adresses précises lors du processus de commande :
Cette étape est importante pour assurer la réussite des livraisons, améliorer le respect des délais et réduire les frais coûteux de correction d'adresse.

Aidez les clients à saisir leur adresse rapidement et précisément :
La saisie semi-automatique d'adresses accélère la saisie et réduit les erreurs de saisie, ce qui permet aux clients de passer facilement à la caisse. Address Validation fournit des informations 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, 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 saisir une adresse lors du règlement d'un achat en ligne. Le processus comprend trois étapes :

  1. Utilisez Place Autocomplete pour capturer l'adresse initiale.
  2. Utilisez l'API Address Validation pour confirmer l'adresse saisie.
  3. Affichez l'emplacement de l'adresse saisie sur une carte pour rassurer les clients sur la livraison.

Nous allons maintenant examiner chaque étape individuellement.

Étape 1 : Flux de saisie d'adresse à l'aide du service Place Autocomplete

Implémentez Place Autocomplete à l'aide de l'API JavaScript sur la première ligne du formulaire de saisie de l'adresse.

Place Autocomplete fournit des suggestions au client lorsqu'il saisit les détails de son adresse. Lorsqu'elle est implémentée à l'aide de l'API JavaScript, une liste déroulante s'affiche sous le champ du formulaire d'adresse lorsque les utilisateurs commencent à saisir du texte. Elle affiche les résultats du service de saisie semi-automatique, qui sont 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.

Place Autocomplete vous permet de proposer deux styles de saisie de formulaire à l'utilisateur : un affichage avec tous les champs d'adresse ou un affichage avec un seul champ de saisie. Ce champ de saisie unique invite l'utilisateur à commencer sa recherche en saisissant du texte, plutôt qu'en saisissant les composants d'adresse individuellement. Une fois la saisie semi-automatique de l'adresse effectuée, le workflow développe les champs du formulaire avec les données de l'adresse, ce qui permet au client de les examiner et de les modifier (par exemple, en ajoutant un numéro d'appartement ou de logement).

Voici un exemple de ce flux, avec un seul champ de saisie :

image

É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 l'API Address Validation au moment du règlement pour confirmer que l'adresse est valide et complète. Déclenchez un appel à l'API Address Validation lorsque l'utilisateur clique sur le bouton "Suivant" ou "Continuer" du formulaire d'adresse. Ce bouton redirige souvent vers la page de paiement.

Google recommande d'appeler l'API Address Validation pour chaque transaction.

Le diagramme 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 les scénarios d'acceptation des adresses plus loin.

Étape 3 : Fournissez une confirmation visuelle

Une fois l'adresse saisie, présentez une confirmation visuelle du lieu de livraison à l'utilisateur en l'affichant sur une carte. Il sera ainsi d'autant plus confiant de ne pas avoir commis d'erreur, ce qui réduira le nombre d'échecs de livraison ou de retrait.

La carte peut s'afficher lors du processus de règlement ou être intégrée à l'e-mail de confirmation de la transaction. Vous pouvez réaliser ces deux cas d'utilisation avec les API suivantes.

L'API Maps JavaScript fournit une carte interactive pour afficher la position de l'utilisateur. L'API Maps Static permet d'intégrer des images sur une page Web ou ultérieurement dans un e-mail.

Analyse approfondie : scénarios d'acceptation des adresses

Les réponses de l'API Address Validation peuvent être classées en trois scénarios principaux :

  • Corriger : l'adresse est de mauvaise qualité. Vous devez demander plus d'informations.
  • Confirmer : l'adresse est de bonne qualité, mais elle a été modifiée par rapport à l'adresse saisie. Vous pouvez demander une 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 de l'API Address Validation. Nous aborderons chaque scénario dans cette section.

Corriger

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 mauvaise qualité, consultez 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 qu'il vérifie les données qu'il a saisies. Une fois l'adresse corrigée, votre service doit la renvoyer à l'API Address Validation pour s'assurer que les corrections apportées sont valides.

Vous pouvez également mettre en évidence des erreurs spécifiques sur une ligne d'adresse à l'aide des signaux renvoyés au niveau addressComponents. Vous trouverez un exemple dans la capture d'écran de droite.

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 indiquant qu'une adresse doit être confirmée, consultez Confirmer une adresse dans la documentation "Créer votre logique de validation".

Votre système peut souvent demander à un utilisateur de confirmer une adresse. Par exemple, un client peut mal orthographier le nom de la ville, qui sera ensuite corrigé par l'API Address Validation. Vous devez confirmer cette correction avec le client. En effet, les modifications apportées par l'API peuvent altérer fondamentalement ce qui a été saisi à l'origine.

Utilisez une fenêtre modale interstitielle pour afficher les informations au client, en lui proposant trois options pour continuer :

  1. Confirmez l'adresse telle qu'elle est renvoyée par l'API. La procédure de règlement se poursuit en utilisant l'adresse corrigée.
  2. Sélectionnez l'adresse telle qu'elle a été saisie à l'origine, en ignorant la correction de l'API Address Validation. Le processus de règlement 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, ce qui le ramène à l'étape de saisie de l'adresse du processus de règlement, où il peut saisir à nouveau l'adresse à partir de zéro, en recommençant le processus.

Vous trouverez un exemple dans la capture d'écran à droite.

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 Accepter une adresse dans la documentation "Créer votre logique de validation".

Dans ce cas, le processus de règlement doit passer à l'étape suivante, probablement la capture du paiement, sans demander au client de vérifier la qualité de l'adresse. L'API a confirmé que l'adresse saisie par le client est de bonne qualité et que la livraison est possible.

Nous vous recommandons d'utiliser les données d'adresse renvoyées par l'API Address Validation pour la commande, car elles peuvent contenir des corrections et des ajouts mineurs, tels que les suivants :

  • Minuscules/Majuscules
  • Corrections de mise en forme, par exemple :
    • Rue à St
    • Ordre correct des composants d'adresse
  • ZIP+4 aux États-Unis.

Observations relatives à la mise en œuvre

Lorsque vous créez votre logique d'acceptation des adresses, assurez-vous que votre implémentation n'empêche pas les clients de finaliser leur commande s'ils saisissent une adresse non valide. Construisez une logique qui empêche la possibilité d'une boucle infinie si l'API indique à plusieurs reprises que l'entrée n'est pas valide.

Google vous recommande de laisser les clients saisir leur adresse jusqu'à deux fois. Lors de la deuxième tentative, acceptez leur saisie, même si elle n'est pas validée. Lors de la deuxième tentative, l'objectif est de lui permettre de continuer, quelle que soit la validation.

Voici deux méthodes suggérées pour accepter la deuxième tentative :

  • Forcer la poursuite : affichez un pop-up expliquant au client que l'adresse n'est pas validée, mais autorisez-le à continuer avec l'adresse qu'il a saisie.
  • Acceptation silencieuse : la deuxième tentative est automatiquement acceptée sans étape de 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, afin qu'un représentant du service client puisse les examiner avant l'expédition de la commande. Cette mesure supplémentaire vous permet de détecter les éventuelles erreurs.

La construction d'un nouveau bâtiment illustre bien pourquoi cette vérification est recommandée. Il peut y avoir un décalage entre la fin de la construction d'un nouveau bâtiment et le moment où son adresse est renseignée dans les bases de données d'adresses postales. Les clients doivent avoir la possibilité de passer en force à la page de paiement avec l'adresse qu'ils ont saisie, même si elle n'est pas validée.

Une fois une 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 a présenté un aperçu d'un parcours de paiement implémentant la saisie semi-automatique, la validation d'adresse et la confirmation visuelle sur une carte Google. 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 sur l'amélioration du paiement, de la livraison et des opérations grâce à des adresses fiables et regardez le webinaire sur l'amélioration du paiement, de la livraison et des opérations grâce à la validation des adresses .

Lectures complémentaires suggérées :

Contributeurs

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

  1. Licencié non exclusif du service postal des États-Unis. La ou les marques suivantes appartiennent au service postal des États-Unis(USPS®) et sont utilisées avec son autorisation : CASS™, USPS®, DPV®. ↩