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 checkout e-commerce allo scopo di acquisire indirizzi di alta qualità.

Prerequisiti

Google consiglia di avere familiarità con quanto segue:

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 ordine:
Questo è un passaggio importante per promuovere consegne riuscite, aumentare l'evasione puntuale e ridurre i costosi addebiti per la correzione dell'indirizzo.

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

Panoramica dell'implementazione

Questa sezione descrive il flusso di lavoro consigliato per l'inserimento degli indirizzi per i pagamenti e-commerce. La procedura prevede 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 dare ai clienti la certezza della consegna.

Successivamente, analizzeremo ogni passaggio singolarmente.

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

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

Place Autocomplete fornisce suggerimenti al cliente mentre inserisce i dettagli del suo indirizzo. Se 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.

Puoi fornire all'utente due stili di inserimento del modulo con il completamento automatico dei luoghi: un display con tutti i campi dell'indirizzo o un display con un singolo campo di input. Questo singolo campo di input 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 flusso di lavoro espande i campi del modulo con i dati dell'indirizzo, consentendo al cliente di rivedere 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 input:

immagine

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

Dopo che l'utente ha inserito l'indirizzo, Google ti 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 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 descrive 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 posizione di consegna visualizzandola su una mappa. In questo modo il cliente ha un'ulteriore garanzia che l'indirizzo sia corretto e si riducono i problemi 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 chiedere ulteriori informazioni.
  • Conferma: l'indirizzo è di alta qualità, ma presenta modifiche rispetto all'indirizzo inserito. Potrebbe essere richiesta una conferma.
  • Accetta: l'indirizzo è di alta qualità. Puoi accettare l'indirizzo fornito.

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

Correggi

immagine

Questa sezione mostra come correggere l'inserimento di un indirizzo. Per informazioni su 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 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 dell'indirizzo utilizzando gli indicatori restituiti a livello di addressComponents. Un esempio è visibile nello screenshot a destra.

Conferma

immagine

Questa sezione mostra come confermare un indirizzo. Per informazioni su 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 chiede all'utente di confermare un indirizzo. Ad esempio, un cliente scrive in modo errato il nome della città, che verrà poi corretto dall'API Address Validation. Devi confermare questa correzione con il cliente. Questo perché le modifiche apportate dall'API potrebbero alterare radicalmente ciò che era stato inserito in origine.

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 così come è stato 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 tua procedura lo consente.
  3. Il cliente annulla o esce dalla finestra modale, tornando alla fase di inserimento dell'indirizzo della procedura di pagamento, in cui può reinserire l'indirizzo da zero, ricominciando la procedura.

Un esempio è visibile 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 scenario, la procedura di pagamento deve passare alla fase successiva, probabilmente l'acquisizione del pagamento, senza richieste al cliente in merito alla qualità dell'indirizzo. L'API ha confermato che l'indirizzo inserito dal cliente è di buona qualità e può essere consegnato.

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

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

Considerazioni sull'implementazione

Quando crei la logica di accettazione degli indirizzi, assicurati che l'implementazione non impedisca ai clienti di completare il pagamento a causa dell'inserimento di un indirizzo non valido. Crea una logica che impedisca 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 tentativi per inserire il proprio indirizzo e, al secondo tentativo, accettare l'inserimento, 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 procedi:mostra al cliente una finestra modale che spiega che l'indirizzo non è in fase di convalida, ma consenti l'opzione 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 tuo sistema in modo da segnalare gli indirizzi non validi, in modo che un rappresentante del servizio clienti possa esaminarli prima della spedizione dell'ordine. Questa misura aggiuntiva ti consente di individuare eventuali errori.

La costruzione di un nuovo edificio offre un buon esempio del motivo per cui questo controllo è consigliato. Potrebbe esserci un intervallo di tempo tra il momento in cui viene completata la costruzione di un nuovo edificio e il momento in cui l'indirizzo dell'edificio viene inserito nei database degli indirizzi postali. I clienti devono avere la possibilità di procedere forzatamente alla pagina di pagamento con l'indirizzo digitato, anche se non viene convalidato.

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

Conclusione

Questo documento ha fornito 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 dell'indirizzo consigliati.

Passaggi successivi

Scarica il white paper Migliora pagamento, consegna e operazioni con indirizzi affidabili e guarda il webinar Migliorare pagamento, consegna e operazioni con la convalida degli indirizzi .

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®. ↩