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 règlement d'e-commerce afin de capturer des adresses de haute qualité.

Prérequis

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

  • Documentation pour les développeurs JavaScript Place Autocomplete.
    • D'un point de vue technique, vous comprendrez le fonctionnement de Place Autocomplete et ses options d'implémentation.
  • Guide d'implémentation de règlement pour Place Autocomplete.
    • Exemples de bonnes pratiques d'implémentation de Place Autocomplete pour un règlement e-commerce.
  • Documentation produit sur l'API Address Validation, avec en particulier comment créer une logique de validation.
    • D'un point de vue technique, vous comprendrez le fonctionnement de l'API Address Validation et examinerez les signaux qui déterminent la qualité de l'adresse.

Qu'est-ce que la validation des adresses ?

L'API Address Validation est un service qui accepte les adresses. Il identifie et valide les composants d'adresse. Il standardise également l'adresse pour l'envoi de courriers et trouve les coordonnées de latitude/longitude les plus connues pour celle-ci. Pour les adresses aux États-Unis et à Porto Rico, vous pouvez éventuellement activer le Coding Accuracy Support System (CASSTM).

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

Collectez des adresses précises lors du processus de commande:
Cette étape est importante pour favoriser les livraisons réussies, augmenter le respect des délais de traitement et réduire les frais de correction d'adresse coûteux.

Aidez les clients à saisir leur adresse de façon rapide et précise:
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 règlement. Address Validation fournit des commentaires sur la qualité globale de l'adresse, apporte des corrections telles que des erreurs de standardisation et 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 de saisie d'adresse recommandé pour les paiements en ligne. Le processus comprend trois étapes:

  1. Utilisez Place Autocomplete pour capturer l'adresse dans un premier temps.
  2. Utilisez l'API Address Validation pour confirmer l'adresse saisie.
  3. Affichez l'emplacement de l'adresse saisie sur une carte afin d'assurer la livraison aux clients.

Nous allons maintenant examiner en détail chaque étape.

Étape 1: Flux de saisie d'adresse – Utiliser 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 fournit 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 la liste déroulante. Cette action remplit automatiquement les champs du formulaire avec les données d'adresse.

Vous pouvez fournir deux styles de saisie à l'utilisateur avec Place Autocomplete : 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 à commencer la recherche à mesure qu'il tape, au lieu de saisir individuellement les composants d'adresse. Une fois que la saisie semi-automatique a renseigné l'adresse, le workflow ajoute les données d'adresse aux champs du formulaire, ce qui permet au client de la consulter et d'apporter des modifications, par exemple en ajoutant un numéro d'appartement ou d'unité.

Voici un exemple de flux utilisant un seul champ de saisie:

Image

Étape 2: Utilisez l'API Address Validation pour valider des adresses

Une fois que l'utilisateur a saisi l'adresse, Google vous recommande d'appeler l'API Address Validation lors du règlement pour vérifier qu'elle est valide et complète. Déclenchez un appel à l'API Address Validation lorsque l'utilisateur clique sur le bouton "Next" (Suivant) ou "Continue" (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 règlement:

Image

Ce document traite des scénarios d'acceptation des adresses ultérieurement.

Étape 3: Fournissez une confirmation visuelle

Une fois l'adresse saisie, affichez une confirmation visuelle du lieu de livraison à l'utilisateur en l'affichant sur une carte. Le client est ainsi assuré que l'adresse est correcte, ce qui réduit le risque d'échecs de livraison ou de retrait.

La carte peut être affichée lors du processus de règlement ou envoyée dans l'e-mail de confirmation de la transaction. Ces deux cas d'utilisation peuvent être accomplis à 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 la 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 en trois scénarios principaux:

  • Solution : l'adresse est de mauvaise qualité. Vous devriez demander plus d'informations.
  • Confirmer : l'adresse est de haute qualité, mais celle d'entrée a changé. Vous pouvez être invité à confirmer l'opération.
  • 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, et 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 saisies. Une fois l'adresse corrigée, votre service doit renvoyer à l'API Address Validation pour s'assurer que les corrections effectuées sont valides.

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


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

Votre système demande souvent à l'utilisateur de confirmer une adresse. Par exemple, un client orthographie mal le nom de la ville, ce qui sera ensuite corrigé par l'API Address Validation. Vous devez confirmer ce correctif auprès du 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, en activant trois options:

  1. Confirmez l'adresse renvoyée par l'API pour que le processus de règlement se poursuive en utilisant l'adresse corrigée.
  2. Sélectionnez l'adresse telle qu'elle a été 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 expédition, si votre processus le permet.
  3. Le client annule ou quitte le modal, et le renvoie à l'étape de saisie de l'adresse du processus de paiement, où il peut saisir à nouveau l'adresse en partant de zéro, en recommençant le processus.

La capture d'écran ci-contre illustre ce type de comportement.


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 paiement doit passer à l'étape suivante, probablement la capture des paiements, sans aucune invite au client concernant la qualité de l'adresse. L'API a confirmé que l'adresse saisie par le client est de bonne qualité et peut être livrée.

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

  • Minuscules/Majuscules
  • Corrections de mise en forme, par exemple :
    • De rue à rue
    • 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 achat en raison de la saisie d'une adresse non valide. Créez une logique de manière à éviter le risque d'une boucle infinie si l'API indique à plusieurs reprises que leur entrée n'est pas valide.

Google vous recommande d'offrir aux clients jusqu'à deux tentatives de saisie de leur adresse et de l'accepter lors de la deuxième tentative, même si celle-ci n'est pas validée. Lors de la deuxième tentative, l'objectif est de les laisser continuer, quelle que soit la validation.

Voici deux suggestions pour accepter la deuxième tentative:

  • Force-proceed (Forcer la procédure) : montrez au client une fenêtre modale expliquant que l'adresse n'est pas validée, mais autorisez l'option à poursuivre avec l'adresse saisie.
  • Acceptation silencieuse:acceptez automatiquement la deuxième tentative 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 qui ne sont pas validées, 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 les erreurs.

La construction de nouveaux bâtiments illustre parfaitement les raisons pour lesquelles 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 forcer l'utilisation de la page de paiement avec leur adresse saisie, même si celle-ci n'est pas 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 un processus de paiement mettant en œuvre 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 mise en œuvre, en suivant les flux de saisie d'adresses recommandés.

Étapes suivantes

Téléchargez le livre blanc Améliorer le règlement, la livraison et les opérations avec des adresses fiables et consultez le webinaire Améliorer le règlement, la livraison et les opérations avec la validation d'adresses .

Autres ressources suggérées:

Contributeurs

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


  1. Titulaire d'une licence non exclusive du service postal des États-Unis. La ou les marques suivantes appartiennent au United States Postal Service® et sont utilisées avec autorisation: CASSTM, USPS®, DPV®.