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 al fine di acquisire indirizzi di alta qualità.

Prerequisiti

Google consiglia di acquisire familiarità con quanto segue:

  • Documentazione per sviluppatori di JavaScript di Place Autocomplete.
    • Comprendi dal punto di vista tecnico come funziona Place Autocomplete e le sue 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 a Creare la logica di convalida.
    • Comprendi 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 precisi durante il processo di ordinazione:
Si tratta di un passaggio importante per promuovere consegne riuscite, aumenta la puntualità degli evasione degli ordini e riduce i costosi addebiti per la correzione dell'indirizzo.

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 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. 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. Visualizza la posizione dell'indirizzo inserito su una mappa per garantire ai clienti la certezza delle consegne.

Successivamente, analizzeremo ogni passaggio singolarmente.

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

Implementa il completamento automatico del luogo 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 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 di convalida dell'indirizzo 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. 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

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

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 mostrare 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: gestire gli scenari di accettazione

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 l'inserimento di un indirizzo. 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 di convalida dell'indirizzo 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 nella riga indirizzo utilizzando gli indicatori restituiti 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 richiede all'utente di confermare un indirizzo. Ad esempio, un cliente scrive male il nome della città, che verrà poi corretto dall'API Address Validation. Dovresti verificare 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. Verifica che l'indirizzo sia stato restituito dall'API e che 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 segnalato per la revisione downstream 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.

Ne è un esempio lo 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 di convalida dell'indirizzo 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:

  • 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 è completamente valido.

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 consente di rilevare eventuali errori.

La costruzione di nuovi edifici offre una buona illustrazione del motivo per cui questo controllo è consigliato. 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 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. 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: CASS™, USPS®, DPV®. ↩