Convalida dell'indirizzo per il pagamento e-commerce

Scopo

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

Prerequisiti

Google consiglia di acquisire familiarità con quanto segue:

  • Inserisci la funzionalità di completamento automatico della documentazione per gli sviluppatori JavaScript.
    • Comprendi dal punto di vista tecnico come funziona Place Autocomplete e le sue opzioni di implementazione.
  • Guida all'implementazione di checkout per Place Autocomplete.
    • Esempi di best practice per l'implementazione di Place Autocomplete in un pagamento e-commerce.
  • Documentazione del prodotto dell'API Address Validation, con particolare attenzione a Creare la logica di convalida.
    • Comprendi dal punto di vista tecnico come funziona l'API Address Validation ed esamina gli indicatori che determinano la qualità degli indirizzi.

Che cos'è la convalida degli indirizzi?

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

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

Raccogli indirizzi precisi durante il processo di ordinazione:
Si tratta di un passaggio importante per promuovere consegne riuscite, aumenta la puntualità e riduce i costosi addebiti per la correzione dell'indirizzo.

Guida i clienti a inserire l'indirizzo in modo rapido e preciso:
Posiziona Autocomplete accelera l'inserimento dell'indirizzo e riduce gli errori di inserimento, consentendo ai clienti di completare facilmente la procedura di pagamento. Address Validation fornisce un feedback sulla qualità complessiva degli indirizzi, apporta correzioni (ad es. standardizzazione ed errori di ortografia) e migliora i metadati, ad esempio fornendo un indicatore residenziale o commerciale (disponibile in alcune regioni).

Panoramica dell'implementazione

Questa sezione illustra il flusso di lavoro consigliato per l'inserimento dell'indirizzo per i pagamenti 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. Visualizza la posizione dell'indirizzo inserito su una mappa per garantire ai clienti la certezza delle consegne.

In seguito, analizzeremo ogni passaggio singolarmente.

Passaggio 1: flusso di inserimento dell'indirizzo, utilizzando il servizio Place Autocomplete

Implementa il completamento automatico del luogo utilizzando l'API JavaScript nella prima riga del modulo di inserimento dell'indirizzo.

Place Autocomplete fornisce suggerimenti al cliente quando inserisce i dettagli dell'indirizzo. Se implementata utilizzando l'API JavaScript, man mano che gli utenti iniziano a digitare, sotto il campo del modulo di inserimento dell'indirizzo viene visualizzato un menu a discesa che mostra i risultati del servizio di completamento automatico che si aggiornano a ogni sequenza di tasti. Dopo aver inserito informazioni sufficienti per trovare l'indirizzo, l'utente lo seleziona dal menu a discesa. Questa azione compila automaticamente i campi del modulo con i dati dell'indirizzo.

Con Place Autocomplete, puoi fornire all'utente due stili di inserimento di modulo: una visualizzazione con tutti i campi indirizzo o una con un singolo campo di input. Questo singolo campo di immissione richiede all'utente di iniziare la ricerca durante la digitazione, anziché inserire i componenti dell'indirizzo singolarmente. Una volta che l'indirizzo viene compilato automaticamente, il flusso di lavoro espande i campi del modulo con i dati dell'indirizzo, consentendo al cliente di esaminarli e apportare modifiche, ad esempio aggiungendo un numero di appartamento o 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 verificare che l'indirizzo sia valido e completo. Attivare una chiamata all'API Address Validation quando l'utente fa clic sul pulsante Avanti o Continua nel modulo dell'indirizzo. Spesso questo pulsante rimanda 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 una procedura di pagamento:

immagine

In questo documento verranno illustrati gli scenari di accettazione in un secondo momento.

Passaggio 3: fornisci una conferma visiva

Dopo l'inserimento dell'indirizzo, fornisci all'utente una conferma visiva del luogo di consegna mostrandolo su una mappa. In questo modo, il cliente ha un'ulteriore garanzia della correttezza dell'indirizzo e riduce i problemi di consegna o ritiro.

La mappa può essere visualizzata durante la procedura di pagamento o inviata all'interno dell'email di conferma della transazione. Entrambi questi casi d'uso possono essere realizzati con le API riportate di seguito.

L'API Maps JavaScript fornisce una mappa interattiva per visualizzare la posizione dell'utente. L'API Maps Static consente l'incorporamento delle immagini all'interno di una pagina web o in una fase successiva in un'email.

Approfondimento: gestire gli scenari di accettazione

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 inserito. Potresti richiedere conferma.
  • Accetta: l'indirizzo è di alta qualità. Puoi accettare l'indirizzo fornito.

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

Correggi

immagine

Questa sezione mostra come correggere un indirizzo inserito. Per informazioni sugli indicatori 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 verificare i dati inseriti. Una volta corretto l'indirizzo, il servizio deve inviare di nuovo l'API Address Validation per garantire che le correzioni effettuate siano valide.

Puoi anche evidenziare errori specifici nella riga indirizzo utilizzando gli indicatori restituiti a livello di addressComponents. Ne è un esempio lo screenshot a destra.

Conferma

immagine

Questa sezione mostra come confermare un indirizzo. Per informazioni sugli indicatori 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 richiede all'utente di confermare un indirizzo. Ad esempio, un cliente commette errori di ortografia nel nome della città, che verrà corretto dall'API Address Validation. Dovresti verificare questa correzione con il cliente. Questo perché le modifiche apportate dall'API potrebbero modificare sostanzialmente ciò che è stato inserito originariamente.

Utilizza una finestra modale interstitial per mostrare le informazioni al cliente, attivando tre opzioni per procedere:

  1. Verifica che l'indirizzo sia stato restituito dall'API e che la procedura di pagamento continua, utilizzando l'indirizzo corretto.
  2. Seleziona l'indirizzo come inserito inizialmente, ignorando la correzione dell'API Address Validation. La procedura di pagamento può continuare normalmente e l'ordine può essere segnalato per la revisione downstream prima della spedizione, se la procedura lo consente.
  3. Il cliente annulla l'operazione o esce dalla finestra modale, riportandolo alla fase di inserimento dell'indirizzo della procedura di pagamento, dove potrà reinserire l'indirizzo da zero e ricominciare la procedura da capo.

Ne è un esempio lo screenshot a destra.

Accetta

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

In questo scenario, la procedura di pagamento dovrebbe passare alla fase successiva, la probabile acquisizione dei pagamenti, senza chiedere al cliente di gestire la qualità. L'API ha confermato che l'indirizzo inserito dal cliente è di buona qualità e può essere consegnato.

Consigliamo di utilizzare i dati dell'indirizzo restituiti dall'API Address Validation contro l'ordine, perché questo potrebbe contenere piccole correzioni e aggiunte, come le seguenti:

  • Lettere maiuscole
  • Correzioni di formattazione, ad esempio
    • Da via a St
    • Ordine corretto dei componenti dell'indirizzo
  • ZIP+4 negli Stati Uniti.

Considerazioni sull'implementazione

Quando crei la logica di accettazione dell'indirizzo, assicurati che l'implementazione non impedisca ai clienti di effettuare il pagamento a causa dell'inserimento di un indirizzo non valido. Creare una logica in modo da impedire la possibilità di un ciclo infinito se l'API indica ripetutamente che la relativa voce non è valida.

Google consiglia di offrire ai clienti fino a due possibilità di inserire il loro indirizzo e, al secondo tentativo, di accettarlo, anche se non è convalidato. Al secondo tentativo, l'obiettivo è lasciarli procedere indipendentemente dalla convalida.

Due metodi suggeriti per accettare il secondo tentativo:

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

Se possibile, progetta il sistema in modo da segnalare 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 garantisce di rilevare eventuali errori.

Le nuove costruzioni di edifici offrono un'ottima indicazione del motivo per cui questa verifica è consigliata. Potrebbe esserci un divario tra il termine delle nuove costruzioni e il momento in cui l'indirizzo dell'edificio viene inserito nei database degli indirizzi postali. I clienti dovrebbero avere la possibilità di procedere forzatamente tramite la pagina di pagamento con l'indirizzo digitato, anche se non è convalidato.

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

Conclusione

Questo documento fornisce una panoramica di un flusso di pagamento che implementa il completamento automatico, la convalida degli indirizzi e la conferma visiva su una mappa di Google. Utilizza questo documento come punto di partenza per progettare la tua implementazione, seguendo i flussi di inserimento indirizzo consigliati.

Passaggi successivi

Scarica il white paper Migliora pagamento, consegna e operazioni con indirizzi affidabili e guarda il webinar Migliorare l'acquisto, la consegna e le operazioni con Address Validation .

Ulteriori letture suggerite:

Collaboratori

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

  1. Licenziatario non esclusivo del Servizio postale degli Stati Uniti. I seguenti marchi sono di proprietà di United States Postal Service® e vengono utilizzati dietro autorizzazione: CASSTM, USPS®, DPV®. ↩