Obiettivo
Questo documento descrive i metodi per combinare Place Autocomplete, Address API 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:
- Sviluppatore JavaScriptPlace Autocomplete
documentazione.
- Comprendere da un punto di vista tecnico come Place Autocomplete e le sue opzioni di implementazione.
- Guida all'implementazione del pagamento per Place
Completamento automatico:
- Esempi di best practice per l'implementazione di Place Autocomplete su una pagamento e-commerce.
- Prodotto API Address Validation
documentazione,
con particolare attenzione
a Creare un sistema di convalida
logica.
- Comprendere da un punto di vista tecnico come l'API Address Validation funziona ed esaminare 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 l'indirizzo postale per l'invio e trova le coordinate di latitudine/longitudine più conosciute. 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à
distribuzione e riduce i costosi addebiti di correzione degli indirizzi.
Indirizza i clienti a inserire l'indirizzo in modo rapido e preciso:
Place Autocomplete accelera l'inserimento di indirizzi e riduce gli errori di input, consentendo
i clienti a completare facilmente la procedura di pagamento. Address Validation fornisce un feedback
sulla qualità complessiva degli indirizzi, fa correzioni come la standardizzazione
errori di ortografia e migliora i metadati, ad esempio fornendo un indirizzo
indicatore commerciale (disponibile in
regioni.
Panoramica dell'implementazione
Questa sezione descrive il flusso di lavoro consigliato per l'inserimento dell'indirizzo per l'e-commerce pagamenti. La procedura è composta da tre passaggi:
- Utilizza Place Autocomplete per acquisire inizialmente l'indirizzo.
- Utilizza l'API Address Validation per confermare l'indirizzo inserito.
- Mostrare la posizione dell'indirizzo inserito su una mappa per dare la consegna la fiducia dei clienti.
In seguito, analizzeremo ogni passaggio singolarmente.
Passaggio 1: flusso di inserimento dell'indirizzo, utilizzando il servizio Place Autocomplete
Implementa Luogo Completamento automatico utilizzando l'API JavaScript nella prima riga del modulo di inserimento dell'indirizzo.
Place Autocomplete fornisce suggerimenti al cliente quando inserisce il suo i dettagli dell'indirizzo. Se implementata utilizzando l'API JavaScript, quando gli utenti iniziano digitando, sotto il campo del modulo di inserimento dell'indirizzo viene visualizzato un menu a discesa con i risultati del servizio Autocomplete che si aggiorna a ogni pressione di un tasto. Dopo che l'utente abbia inserito informazioni sufficienti per trovare l'indirizzo, lo seleziona menu a discesa. Questa azione compila automaticamente i campi del modulo con l'indirizzo e i dati di Google Cloud.
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 input . Questo singolo campo di immissione richiede all'utente di iniziare la ricerca mentre digita, invece di inserirli singolarmente. Dopo il completamento automatico compila l'indirizzo, il flusso di lavoro espande i campi del modulo con l'indirizzo dati, consentendo al cliente di rivedere e apportare modifiche, ad esempio aggiungendo di appartamento o unità abitativa.
Ecco un esempio di come potrebbe apparire questo flusso, utilizzando un singolo campo di immissione:
Passaggio 2: utilizza l'API Address Validation per convalidare gli indirizzi
Dopo che l'utente ha inserito l'indirizzo, Google consiglia di chiamare l'indirizzo Convalida API al momento del pagamento per verificare che l'indirizzo sia valido e completo. Attiva una chiamata a l'API Address Validation quando l'utente fa clic sul pulsante Avanti o Continua il 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 della API Address Validation in una procedura di pagamento:
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 della consegna posizione visualizzandola su una mappa. Ciò offre al cliente ulteriori la garanzia che l'indirizzo sia corretto e ciò riduce la consegna o il ritiro errori.
La mappa può essere visualizzata durante la procedura di pagamento o inviata durante la transazione l'email di conferma. Entrambi questi casi d'uso possono essere realizzati le seguenti API.
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 cambia rispetto all'indirizzo di input. Potresti richiedere conferma.
- Accetta: l'indirizzo è di alta qualità. Puoi accetta l'indirizzo fornito.
Questo concetto è trattato nella sezione Creare la convalida logica della documentazione sull'API Address Validation, nel quale esamineremo ogni scenario questa sezione.
Correggi
Questa sezione mostra come correggere un indirizzo inserito. Per informazioni su specifiche indica che l'API Address Validation torna per indicare una qualità bassa di accesso, consulta la sezione 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 dovrebbe inviarsi nuovamente all'indirizzo l'API Validation per garantire la validità delle correzioni apportate.
Puoi anche evidenziare errori specifici nelle righe indirizzo utilizzando gli indicatori
restituito a livello di addressComponents
. Ne è un esempio il
screenshot a destra.
Conferma
Questa sezione mostra come confermare un indirizzo. Per informazioni su specifiche indica che l'API Address Validation restituisce per indicare che un indirizzo dovrebbe 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 in questo caso verrebbe corretto dall'indirizzo API Validation. Dovresti verificare questa correzione con il cliente. Questo perché le modifiche apportate dall'API potrebbero modificare sostanzialmente ciò che era inserito.
Utilizza una finestra modale interstitial per mostrare le informazioni al cliente, attivando tre opzioni per procedere:
- Conferma l'indirizzo restituito dall'API e la procedura di pagamento continua utilizzando l'indirizzo corretto.
- Selezionare l'indirizzo inserito inizialmente, ignorando la correzione 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.
- Il cliente annulla l'operazione o esce dalla finestra modale, restituendolo al di inserimento dell'indirizzo nella procedura di pagamento, in cui possono reinserire l'indirizzo email da zero, ricominciando il processo da capo.
Ne è un esempio lo screenshot a destra.
Accetta
Questa sezione mostra come accettare un indirizzo. Per informazioni su specifiche indica che l'API Address Validation restituisce per indicare che un indirizzo è valido e deve essere accettata, consulta la sezione Accettare indirizzo nella documentazione "Creare la logica di convalida".
In questo scenario, la procedura di pagamento dovrebbe passare alla fase successiva, probabilmente la procedura di acquisizione dei pagamenti, senza chiedere al cliente di fornire informazioni sulla qualità. L'API ha confermato che l'indirizzo inserito dal cliente è di buona qualità, e da raggiungere.
Ti consigliamo di utilizzare i dati degli indirizzi restituiti dall'API Address Validation dell'ingiunzione, in quanto potrebbe contenere correzioni e aggiunte di lieve entità, ad esempio:
- 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 degli indirizzi, assicurati che l'implementazione non impedire 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 ciclo infinito se l'API indica ripetutamente che la voce non è valida.
Google consiglia di offrire ai clienti fino a due opportunità di partecipare di destinazione e, al secondo tentativo, accetti l'inserimento, anche se valida. Al secondo tentativo, l'obiettivo è lasciarli procedere indipendentemente dal fatto che dei dati.
Due metodi suggeriti per accettare il secondo tentativo:
- Procedura forzata: mostra al cliente una finestra modale che spiega che l'indirizzo non è la 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 è completamente convalidato.
Se possibile, progetta il sistema in modo che contrassegni gli indirizzi che non vengono convalidati, in modo che il rappresentante dell'assistenza clienti può esaminarli prima della spedizione dell'ordine. Questo una maggiore misura di sicurezza per catturare qualsiasi errore.
I nuovi edifici offrono un buon esempio del motivo per cui questo controllo consigliato. Potrebbe esserci un divario tra il momento in cui la costruzione di nuovi edifici completata e quando l'indirizzo dell'edificio sarà inserito nel codice postale. o Microsoft SQL Server. I clienti dovrebbero avere la possibilità di procedere in modo forzato tramite pagina di pagamento con l'indirizzo digitato, anche se non è convalidato.
Una volta completata la sessione di pagamento, puoi utilizzare
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 Completamento automatico, Address Validation e conferma visiva su una mappa di Google. Utilizza le funzionalità di documento come punto di partenza per progettare l'implementazione, seguendo le flussi di inserimento indirizzi consigliati.
Passaggi successivi
Scarica la sezione Migliora pagamento, consegna e operazioni con indirizzi affidabili Whitepaper e consulta la sezione Miglioramento di pagamento, consegna e operazioni con l'indirizzo Convalida Webinar.
Ulteriori letture suggerite:
- Inserisci la documentazione di Autocomplete
- Documentazione dell'API Address Validation
- Report di Google Maps Platform
Collaboratori
Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Ingegnere di soluzioni
-
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®. ↩