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

Prerequisiti

Google consiglia di acquisire familiarità con quanto segue:

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 l'indirizzo per posta e trova le sue coordinate di latitudine e longitudine più note. Facoltativamente, per gli indirizzi negli Stati Uniti e a Portorico, puoi attivare il CASSTM (Coding Identification Support System).

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

Raccogli indirizzi precisi durante la procedura di ordinazione:
Questo è un passaggio importante per promuovere consegne riuscite, aumentare la puntualità dell'evasione degli ordini e ridurre i costosi addebiti per la correzione degli indirizzi.

Indica ai clienti l'inserimento dell'indirizzo in modo rapido e preciso:
Il completamento automatico dell'opzione Place Autocomplete velocizza l'inserimento dell'indirizzo e riduce gli errori di input, consentendo ai clienti di passare facilmente alla procedura di pagamento. Convalida degli indirizzi fornisce feedback sulla qualità complessiva degli indirizzi, esegue correzioni come errori di standardizzazione ed 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 e-commerce. La procedura si compone di 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 fiducia ai clienti nelle consegne.

Quindi, analizzeremo ogni passaggio singolarmente.

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

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

Place Autocomplete fornisce suggerimenti al cliente mentre inserisce i dettagli dell'indirizzo. Se implementata tramite 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, con i risultati del servizio di completamento automatico che si aggiornano a ogni sequenza di tasti. Dopo che l'utente ha inserito informazioni sufficienti a trovare l'indirizzo, l'utente lo seleziona dal menu a discesa. Questa azione compila automaticamente i campi del modulo con i dati degli indirizzi.

Con il completamento automatico dei luoghi puoi fornire all'utente due stili di inserimento dei moduli: una visualizzazione con tutti i campi indirizzo o una visualizzazione con un singolo campo di input. Questo singolo campo di immissione chiede all'utente di iniziare la ricerca durante la digitazione, anziché inserire singolarmente i componenti dell'indirizzo. 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 rivedere e apportare modifiche, ad esempio aggiungendo un numero di appartamento.

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. 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 in una procedura di pagamento:

immagine

Questo documento illustra gli scenari di accettazione degli indirizzi in un secondo momento.

Passaggio 3: fornisci una conferma visiva

Dopo l'inserimento dell'indirizzo, fornisci all'utente una conferma visiva della località di consegna visualizzandola su una mappa. In questo modo il cliente può essere certo che l'indirizzo sia corretto e ridurre gli errori di consegna o di ritiro.

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

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 una fase successiva di 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 modifiche rispetto all'indirizzo inserito. 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 dei documenti dell'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 che l'API Address Validation restituisce per indicare un indirizzo di bassa qualità, consulta Correggere un indirizzo nella documentazione di Build your Validation logic (Crea 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 essere inviato nuovamente all'API Address Validation per garantire che le correzioni apportate siano valide.

Puoi anche evidenziare errori specifici della 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 che l'API Address Validation restituisce per indicare che un indirizzo deve essere confermato, consulta Conferma un indirizzo nella documentazione della build della logica di convalida.

Spesso il sistema vuole chiedere all'utente di confermare un indirizzo. Ad esempio, un cliente non digita correttamente il nome della città, che viene poi corretto dall'API Address Validation. Devi confermare questa correzione con il cliente. Questo perché le modifiche apportate dall'API potrebbero modificare sostanzialmente ciò che era stato originariamente inserito.

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

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

Un esempio può essere visto nello screenshot a destra.

Accetta

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

In questo scenario, la procedura di pagamento dovrebbe passare alla fase successiva, probabile acquisizione dei pagamenti, senza chiedere al cliente informazioni sulla 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, poiché potrebbero contenere piccole correzioni e aggiunte, ad esempio quanto segue:

  • Lettere maiuscole
  • Correzioni della formattazione, ad esempio:
    • Da strada 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. Costruire la logica in modo da impedire la possibilità di un loop infinito se l'API indica ripetutamente che la voce non è valida.

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

Ecco due metodi consigliati per accettare il secondo tentativo:

  • Procedimento forzato: 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 è stato completamente convalidato.

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

La costruzione di nuovi edifici è un buon esempio del motivo per cui è consigliabile eseguire questo controllo. Potrebbe esserci un divario tra il momento in cui viene completata la costruzione di un nuovo edificio e il momento in cui l'indirizzo di quell'edificio viene inserito nei database degli indirizzi postali. I clienti devono avere la possibilità di procedere con la pagina di pagamento con l'indirizzo digitato, anche se non viene convalidato.

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

Conclusione

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

Passaggi successivi

Scarica il white paper, ovvero il miglioramento di checkout, consegna e operazioni con indirizzi affidabili, e visualizza il webinar Migliorare procedura di pagamento, consegna e operazioni con Address Validation .

Ulteriore lettura suggerita:

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à dell'Ufficio postale degli Stati Uniti® e vengono utilizzati previa autorizzazione: CASSTM, USPS®, DPV®. ↩