Convalida dell'indirizzo per il pagamento e-commerce

Obiettivo

Questo documento descrive i metodi per combinare Place Autocomplete, API Address Validation1 e Maps in un pagamento di e-commerce allo scopo di acquisire indirizzi di alta qualità.

Prerequisiti

Google consiglia di avere familiarità con quanto segue:

  • Place Autocomplete documentazione per gli sviluppatori JavaScript.
    • Comprendi dal punto di vista tecnico come funziona Place Autocomplete funziona e le relative opzioni di implementazione.
  • Guida all' implementazione del checkout per Place Autocomplete.
    • Esempi di best practice di implementazione di Place Autocomplete in un pagamento di e-commerce.
  • Documentazione del prodotto API AddressValidation, con particolare attenzione alla sezione Creare la logica di convalida.
    • Comprendi dal punto di vista tecnico come funziona l'API Address Validation funziona, ed esamina i segnali che determinano la qualità dell'indirizzo.

Che cos'è la convalida dell'indirizzo?

L'API Address Validation è un servizio che accetta un indirizzo. Identifica i componenti dell'indirizzo e li convalida. Inoltre, standardizza l'indirizzo per l'invio per posta e trova le coordinate di latitudine/longitudine più conosciute. Facoltativamente, per gli indirizzi negli Stati Uniti e a Porto Rico, puoi attivare il Coding Accuracy Support System (CASS™).

Perché è necessaria la convalida dell'indirizzo al momento del pagamento?

Raccogli indirizzi accurati durante la procedura di ordine:
questo è un passaggio importante per promuovere consegne riuscite, aumentare il fulfillment puntuale e ridurre i costi di correzione degli indirizzi.

Guida i clienti a inserire l'indirizzo in modo rapido e accurato:
Place Autocomplete velocizza l'inserimento dell'indirizzo e riduce gli errori di input, consentendo ai clienti di spostarsi facilmente durante l'acquisto rapido. Address Validation fornisce feedback sulla qualità complessiva dell'indirizzo, apporta correzioni come la standardizzazione e gli errori di ortografia e migliora i metadati, ad esempio fornendo un indicatore residenziale o commerciale (disponibile in alcune regioni).

Panoramica dell'implementazione

Questa sezione descrive il flusso di lavoro consigliato per l'inserimento dell'indirizzo per i pagamenti di e-commerce. La procedura è composta da tre passaggi:

  1. Utilizza Place Autocomplete per acquisire inizialmente l'indirizzo.
  2. Utilizza l'API Address Validation per confermare l'indirizzo inserito.
  3. Mostra la posizione dell'indirizzo inserito su una mappa per dare ai clienti la certezza della consegna.

Ora esamineremo ogni passaggio singolarmente.

Passaggio 1: flusso di inserimento dell'indirizzo - utilizzo del servizio Place Autocomplete

Implementa Place Autocomplete utilizzando l'API JavaScript sulla prima riga del modulo di inserimento dell'indirizzo.

Place Autocomplete fornisce suggerimenti al cliente mentre inserisce i dettagli dell'indirizzo. Quando viene implementato utilizzando l'API JavaScript, quando gli utenti iniziano a digitare, sotto il campo del modulo di inserimento dell'indirizzo viene visualizzato un elenco a discesa che mostra i risultati del servizio Autocomplete che si aggiornano a ogni tasto. Una volta che l'utente ha inserito informazioni sufficienti per trovare l'indirizzo, lo seleziona dal menu a discesa. Questa azione compila automaticamente i campi del modulo con i dati dell'indirizzo.

Puoi fornire all'utente due stili di inserimento del modulo con Place Autocomplete: una visualizzazione con tutti i campi dell'indirizzo o una visualizzazione con un singolo campo di input. Questo singolo campo di immissione chiede all'utente di iniziare la ricerca mentre digita, anziché inserire i componenti dell'indirizzo singolarmente. Una volta che il completamento automatico compila l'indirizzo, il workflow espande i campi del modulo con i dati dell'indirizzo, consentendo al cliente di rivederli e apportare modifiche, ad esempio aggiungendo un numero di appartamento o di unità.

Ecco un esempio di come potrebbe apparire questo flusso, utilizzando un singolo campo di immissione:

immagine

Passaggio 2: utilizza l'API Address Validation per convalidare gli indirizzi

Dopo che l'utente ha inserito l'indirizzo, Google consiglia di chiamare l'API Address Validation al momento del pagamento per confermare che l'indirizzo sia valido e completo. Attiva una chiamata all'API Address Validation quando l'utente fa clic sul pulsante Avanti o Continua nel modulo dell'indirizzo. Questo pulsante spesso porta alla pagina di pagamento.

Google consiglia di chiamare l'API Address Validation per ogni transazione.

Il seguente diagramma di flusso illustra un esempio di integrazione end-to-end dell'API Address Validation in un pagamento:

immagine

Questo documento descrive gli scenari di accettazione degli indirizzi più avanti.

Passaggio 3: fornisci una conferma visiva

Dopo l'inserimento dell'indirizzo, fornisci all'utente una conferma visiva della località di consegna mostrandola su una mappa. In questo modo, il cliente ha la certezza che l'indirizzo sia corretto e si riducono gli errori di consegna o ritiro.

La mappa può essere mostrata durante la procedura di pagamento o inviata nell'email di conferma della transazione. Entrambi questi casi d'uso possono essere realizzati con le seguenti API.

L'API Maps JavaScript fornisce una mappa interattiva per visualizzare la posizione dell'utente. L'API Maps Static consente di incorporare immagini nella pagina web o in un secondo momento in un'email.

Approfondimento: scenari di accettazione degli indirizzi

Le risposte dell'API Address Validation possono essere classificate in tre scenari principali:

  • Correggi : l'indirizzo è di bassa qualità. Dovresti richiedere ulteriori informazioni.
  • Conferma : l'indirizzo è di alta qualità, ma presenta modifiche rispetto all'indirizzo di input. Potresti richiedere una conferma.
  • Accetta—l'indirizzo è di alta qualità. Puoi accettare l'indirizzo fornito.

Questo concetto è trattato nella sezione Creare la logica di convalida della documentazione dell'API Address Validation e in questa sezione esamineremo ogni scenario.

Correggi

immagine

Questa sezione mostra come correggere un input di indirizzo. Per informazioni sui segnali specifici restituiti dall'API Address Validation per indicare un indirizzo di bassa qualità, consulta Correggere un indirizzo nella documentazione Creare la logica di convalida.

Se la risposta dell'API Address Validation indica un indirizzo non valido, reindirizza il cliente al modulo di inserimento dell'indirizzo per controllare i dati inseriti. Una volta corretto l'indirizzo, il tuo servizio deve inviarlo nuovamente all'API Address Validation per assicurarsi che le correzioni apportate siano valide.

Puoi anche evidenziare errori specifici della riga dell'indirizzo utilizzando i segnali restituiti a livello di addressComponents. Un esempio è visibile nello screenshot a destra.

Conferma

immagine

Questa sezione mostra come confermare un indirizzo. Per informazioni sui segnali specifici restituiti dall'API Address Validation per indicare che un indirizzo deve essere confermato, consulta Confermare un indirizzo nella documentazione Creare la logica di convalida.

Spesso il sistema chiederà a un utente di confermare un indirizzo. Ad esempio, un cliente digita in modo errato il nome della città, che verrà corretto dall'API Address Validation. Devi confermare questa correzione con il cliente. Questo perché le modifiche apportate dall'API potrebbero alterare radicalmente ciò che è stato inserito originariamente.

Utilizza una finestra modale interstiziale per mostrare le informazioni al cliente, consentendo tre opzioni per procedere:

  1. Conferma l'indirizzo restituito dall'API e la procedura di pagamento continua utilizzando l'indirizzo corretto.
  2. Seleziona l'indirizzo inserito originariamente, ignorando la correzione dell'API Address Validation. La procedura di pagamento può continuare normalmente e l'ordine può essere contrassegnato per la revisione a valle prima della spedizione, se la procedura lo consente.
  3. Il cliente annulla o esce dalla finestra modale, tornando alla fase di inserimento dell'indirizzo della procedura di pagamento, dove può inserire nuovamente l'indirizzo da zero, riavviando la procedura.

Un esempio è visibile nello screenshot a destra.

Accetta

Questa sezione mostra come accettare un indirizzo. Per informazioni sui segnali specifici restituiti dall'API Address Validation per indicare che un indirizzo è di buona qualità e deve essere accettato, consulta Accettare un indirizzo nella documentazione Creare la logica di convalida.

In questo scenario, la procedura di pagamento deve passare alla fase successiva, probabilmente l'acquisizione del pagamento, senza che al cliente venga chiesto nulla in merito alla qualità dell'indirizzo. L'API ha confermato che l'indirizzo inserito dal cliente è di buona qualità e consegnabile.

Ti consigliamo di utilizzare i dati dell'indirizzo restituiti dall'API Address Validation rispetto all'ordine, perché potrebbero contenere piccole correzioni e aggiunte, ad esempio:

  • Lettere maiuscole
  • Correzioni di formattazione, ad esempio
    • Via a Via
    • Ordine corretto dei componenti dell'indirizzo
  • CAP+4 negli Stati Uniti.

Considerazioni sull'implementazione

Quando crei la logica di accettazione degli indirizzi, assicurati che l'implementazione non impedisca ai clienti di effettuare il pagamento a causa dell'inserimento di un indirizzo non valido. Crea la logica in modo da evitare la possibilità di un loop infinito se l'API indica ripetutamente che l'input non è valido.

Google consiglia di dare ai clienti fino a due possibilità di inserire l'indirizzo e, al secondo tentativo, di accettare l'input, anche se non viene convalidato. Al secondo tentativo, l'obiettivo è consentire loro di procedere indipendentemente dalla convalida.

Due metodi suggeriti per accettare il secondo tentativo:

  • Forza la procedura: mostra al cliente una finestra modale che spiega che l'indirizzo non è stato convalidato, ma consenti di continuare con l'indirizzo digitato.
  • Accettazione silenziosa: accetta automaticamente il secondo tentativo senza un passaggio di conferma, anche se l'indirizzo non viene convalidato completamente.

Se possibile, progetta il sistema in modo da contrassegnare gli indirizzi che non vengono convalidati, in modo che un rappresentante dell'assistenza clienti possa esaminarli prima della spedizione dell'ordine. Questa misura aggiuntiva ti consente di rilevare eventuali errori.

La costruzione di un nuovo edificio offre una buona illustrazione del motivo per cui questo controllo è consigliato. Potrebbe esserci un divario tra il momento in cui la costruzione di un nuovo edificio viene completata e il momento in cui l'indirizzo dell'edificio viene inserito nei database degli indirizzi postali. I clienti devono avere la possibilità di forzare la procedura nella pagina di pagamento con l'indirizzo digitato, anche se non viene convalidato.

Una volta completata una sessione di pagamento, utilizza facoltativamente il provideValidationFeedback metodo per inviare a Google un feedback su un tentativo di convalida dell'indirizzo specifico.

Conclusione

Questo documento ha fornito una panoramica di un flusso di pagamento che implementa il completamento automatico, Address Validation e la conferma visiva su una mappa Google. Utilizza questo documento come punto di partenza per progettare l'implementazione, seguendo i flussi di inserimento dell'indirizzo consigliati.

Passaggi successivi

Letture consigliate:

Collaboratori

Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Solutions Engineer

  1. Licenziatario non esclusivo di United States Postal Service. I seguenti marchi sono di proprietà di United States Postal Service® e vengono utilizzati dietro autorizzazione: CASS™, USPS®, DPV®. ↩