Convalida dell'indirizzo per il pagamento e-commerce

Obiettivo

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

Prerequisiti

Google consiglia di acquisire familiarità con quanto segue:

  • Documentazione per sviluppatori di JavaScript di Place Autocomplete.
    • Scopri da un punto di vista tecnico come funziona la funzionalità di completamento automatico dei luoghi e le relative opzioni di implementazione.
  • Guida all'implementazione del pagamento per Place Autocomplete.
    • Esempi di best practice per l'implementazione di Completamento automatico dei luoghi al momento del pagamento su un sito di e-commerce.
  • Documentazione del prodotto dell'API Address Validation, con particolare attenzione alla creazione della logica di convalida.
    • Scopri da un punto di vista tecnico come funziona l'API Address Validation e rivedi gli indicatori che determinano la qualità degli indirizzi.

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. Se vuoi, per gli indirizzi negli Stati Uniti e a Portorico 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 ordinazione:
si tratta di un passaggio importante per promuovere consegne riuscite, aumentare l'evasione degli ordini in tempo e ridurre i costi per la correzione degli indirizzi.

Guida i clienti a inserire l'indirizzo in modo rapido e preciso:
Il completamento automatico dei luoghi velocizza l'inserimento dell'indirizzo e riduce gli errori di immissione, consentendo ai clienti di procedere facilmente al pagamento. Address Validation fornisce feedback sulla qualità complessiva degli indirizzi, apporta correzioni come standardizzazione e errori ortografici e migliora i metadati, ad esempio fornendo un indicatore residenziale o commerciale (disponibile in regioni selezionate).

Panoramica dell'implementazione

Questa sezione illustra il flusso di lavoro consigliato per l'inserimento dell'indirizzo per i pagamenti in un sito di e-commerce. Il processo prevede tre passaggi:

  1. Utilizza il completamento automatico dei luoghi 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 garantire ai clienti la sicurezza della consegna.

Successivamente, analizzeremo ogni passaggio singolarmente.

Passaggio 1: flusso di inserimento dell'indirizzo - utilizzo del servizio di completamento automatico dei luoghi

Implementa la funzionalità Completamento automatico dei luoghi utilizzando l'API JavaScript nella prima riga del modulo di inserimento dell'indirizzo.

La funzionalità di completamento automatico dei luoghi fornisce suggerimenti al cliente mentre inserisce i dettagli dell'indirizzo. Quando viene implementato utilizzando l'API JavaScript, quando gli utenti iniziano a digitare viene visualizzato un menu a discesa sotto il campo del modulo di inserimento dell'indirizzo, che mostra i risultati del servizio di completamento automatico che si aggiornano a ogni pressione di 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.

Con il completamento automatico dei luoghi, puoi fornire all'utente due stili di inserimento dei moduli: una visualizzazione con tutti i campi dell'indirizzo o una visualizzazione con un singolo campo di immissione. Questo singolo campo di immissione consente all'utente di iniziare a cercare mentre digita, anziché inserire i componenti dell'indirizzo singolarmente. Una volta che il completamento automatico completa l'indirizzo, 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 il numero di un appartamento o di un'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 di convalida dell'indirizzo 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 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 all'interno di un pagamento:

immagine

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

Passaggio 3: fornisci una conferma visiva

Dopo aver inserito l'indirizzo, fornisci all'utente una conferma visiva della località di consegna visualizzandola su una mappa. In questo modo, il cliente ha la certezza che l'indirizzo sia corretto e si riducono i casi di mancata 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 le immagini all'interno della 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:

  • Correzione: l'indirizzo è di bassa qualità. Dovresti chiedere maggiori informazioni.
  • Conferma: l'indirizzo è di alta qualità, ma presenta alcune differenze rispetto all'indirizzo inserito. Potresti dover confermare.
  • 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 discuteremo ogni scenario in questa sezione.

Correggi

immagine

Questa sezione mostra come correggere un indirizzo inserito. Per informazioni su indicatori specifici che l'API Address Validation restituisce per indicare un indirizzo di bassa qualità, consulta Correggere un indirizzo nella documentazione relativa alla creazione della logica di convalida.

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

Puoi anche evidenziare errori specifici delle righe dell'indirizzo utilizzando gli indicatori retitrati a livello di addressComponents. Un esempio è riportato nello screenshot a destra.

Conferma

immagine

Questa sezione mostra come confermare un indirizzo. Per informazioni su indicatori specifici che l'API Address Validation restituisce per indicare che un indirizzo deve essere confermato, consulta Confermare un indirizzo nella documentazione relativa alla creazione della logica di convalida.

Spesso il sistema vorrà chiedere a un utente di confermare un indirizzo. Ad esempio, un cliente scrive male il nome della città, che verrà poi corretto dall'API Address Validation. Devi confermare questa correzione con il cliente. Questo accade perché le modifiche apportate dall'API potrebbero alterare in modo sostanziale quanto inserito inizialmente.

Utilizza una finestra modale popup per mostrare le informazioni al cliente, offrendo tre opzioni per procedere:

  1. Conferma l'indirizzo restituito dall'API e la procedura di pagamento continuerà 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 segnalato 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ò reinserire l'indirizzo da zero, riavviando la procedura.

Un esempio è riportato nello screenshot a destra.

Accetta

Questa sezione mostra come accettare un indirizzo. Per informazioni su indicatori specifici che l'API Address Validation restituisce per indicare che un indirizzo è di buona qualità e deve essere accettato, consulta Accettare un indirizzo nella documentazione Crea la tua logica di convalida.

In questo caso, la procedura di pagamento dovrebbe passare alla fase successiva, probabilmente la cattura del pagamento, senza richiedere al cliente informazioni sulla qualità dell'indirizzo. L'API ha confermato che l'indirizzo inserito dal cliente è di buona qualità e può essere recapitato.

Ti consigliamo di utilizzare i dati dell'indirizzo restituiti dall'API Address Validation in base all'ordine, in quanto potrebbero contenere correzioni e aggiunte minori, come ad esempio:

  • Lettere maiuscole
  • Correzioni di formattazione, ad esempio
    • Via a St
    • Ordinamento 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. Costruisci la logica in modo da evitare la possibilità di un ciclo infinito se l'API indica ripetutamente che la voce non è valida.

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

Due metodi suggeriti per accettare il secondo tentativo:

  • Forza-procedi:mostra al cliente una finestra modale che spiega che l'indirizzo non è valido, 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 è completamente valido.

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

La costruzione di nuovi edifici offre una buona illustrazione del motivo per cui questo controllo è consigliato. Potrebbe esserci un intervallo di tempo tra il completamento della costruzione di un nuovo edificio e il completamento dell'indirizzo dell'edificio nei database degli indirizzi postali. I clienti devono avere la possibilità di procedere forzosamente con l'indirizzo digitato anche se non è valido.

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

Conclusione

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

Passaggi successivi

Scarica il white paper Migliora il pagamento, la consegna e le operazioni con indirizzi affidabili e guarda il webinar Migliorare il pagamento, la consegna e le operazioni con la convalida dell'indirizzo .

Letture consigliate:

Collaboratori

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

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