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 saisir des adresses de haute qualité.

Prérequis

Google recommande de se 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 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.
    • 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. Elle identifie les composants d'adresse et les valide. Il standardise également l'adresse pour la distribution postale et trouve les coordonnées de latitude et de longitude les plus connues. Pour les adresses aux États-Unis et à Porto Rico, vous pouvez éventuellement activer le système CASS™ (Coding Accuracy Support System).

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

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

Aidez les clients à saisir l'adresse rapidement et précisément:
La saisie semi-automatique de l'adresse accélère la saisie 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 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 de saisie d'adresse recommandé pour les paiements en ligne. Le processus comprend trois étapes:

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

Nous allons ensuite 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 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 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 d'entrée unique invite l'utilisateur à commencer à rechercher au fur et à mesure de la saisie, plutôt que de saisir les composants de l'adresse individuellement. Une fois que la saisie semi-automatique a renseigné l'adresse, le workflow développe les champs du formulaire avec les données d'adresse, ce qui permet au client de les examiner et de les modifier, par exemple en ajoutant un numéro d'appartement ou d'unité.

Voici un exemple de ce à quoi peut ressembler ce flux, à l'aide d'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 de validation des adresses au moment 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) dans le formulaire d'adresse. Ce bouton redirige souvent vers la page de paiement.

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

Le diagramme de flux suivant illustre un exemple d'intégration de bout en bout de l'API de validation d'adresse dans un processus de paiement:

image

Ce document traite des 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. 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 s'afficher lors du processus de paiement ou être intégrée à l'e-mail de confirmation de la transaction. Ces deux cas d'utilisation peuvent être réalisés 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 dans une page Web ou ultérieurement dans un e-mail.

Analyse approfondie : scénarios d'acceptation des adresses

Les réponses de l'API de validation d'adresses peuvent être classées en trois scénarios principaux:

  • Correction : l'adresse est de mauvaise qualité. Vous devez 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 une confirmation.
  • Accepter : l'adresse est de haute qualité. Vous pouvez accepter l'adresse indiquée.

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.

Corriger

image

Cette section explique comment corriger une adresse. Pour en savoir plus sur les signaux spécifiques que l'API Address Validation renvoie pour indiquer une adresse de mauvaise 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 qu'il vérifie les données 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 mal orthographie le nom de la ville, qui sera ensuite corrigé par l'API Address Validation. Vous devez confirmer cette correction auprès du client. En effet, les modifications apportées par l'API peuvent fondamentalement modifier ce qui a été saisi à l'origine.

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

  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 telle qu'elle a été saisie à l'origine, en ignorant la correction apportée par 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, ce qui le ramène à l'étape de saisie de l'adresse du processus de paiement, où il peut saisir à nouveau l'adresse depuis le début, ce qui relance 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 paiement doit passer à l'étape suivante, probablement la capture du paiement, sans 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 livrable.

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 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 payer en raison d'une adresse incorrecte. Construisez une logique de manière à éviter la possibilité d'une boucle infinie si l'API indique à plusieurs reprises que leur entrée n'est pas valide.

Google vous recommande de donner aux clients jusqu'à deux chances de saisir leur adresse. 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 les laisser continuer, que la validation soit effectuée ou non.

Deux méthodes sont suggérées pour accepter la deuxième tentative:

  • Forcer la poursuite:affichez une fenêtre modale expliquant que l'adresse n'est pas validée, mais autorisez le client à continuer avec l'adresse 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 pour qu'il signale les adresses qui ne sont pas validées 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 toute erreur.

La construction d'un nouveau bâtiment est un bon exemple de la raison pour laquelle 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 la progression sur la page de paiement avec l'adresse saisie, même si elle n'est pas validée.

Une fois une session de paiement terminée, vous pouvez 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 flux 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 d'entrée d'adresse recommandés.

Étapes suivantes

Téléchargez le livre blanc Améliorer les processus de paiement, de livraison et d'exploitation avec des adresses fiables et regardez le webinaire Améliorer les processus de paiement, de livraison et d'exploitation avec 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®. ↩