Tujuan
Dokumen ini menjelaskan metode untuk menggabungkan Place Autocomplete, Address Validation API1, dan Maps di checkout e-commerce untuk tujuan mengambil alamat berkualitas tinggi.
Prasyarat
Google merekomendasikan pemahaman tentang hal-hal berikut:
- Dokumentasi developer JavaScript Place Autocomplete.
- Pahami dari sudut pandang teknis cara kerja Place Autocomplete dan opsi penerapannya.
- Panduan penerapan checkout untuk Place Autocomplete.
- Contoh praktik terbaik penerapan Place Autocomplete di checkout e-commerce.
- Dokumentasi produk Address Validation API, dengan fokus pada Membangun logika validasi Anda.
- Pahami dari sudut pandang teknis cara kerja Address Validation API, dan tinjau sinyal yang menentukan kualitas alamat.
Apa yang dimaksud dengan validasi alamat?
Address Validation API adalah layanan yang menerima alamat. API ini mengidentifikasi komponen alamat dan memvalidasinya. Selain itu, Address Validation API menstandardisasi alamat untuk pengiriman surat dan menemukan koordinat lintang/bujur yang paling dikenal untuk alamat tersebut. Secara opsional, untuk alamat di Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan Coding Accuracy Support System (CASS™).Mengapa Anda memerlukan validasi alamat saat checkout?
Kumpulkan alamat yang akurat selama proses pemesanan:
Ini adalah langkah penting untuk meningkatkan keberhasilan pengiriman tepat waktu dan mengurangi biaya koreksi alamat yang mahal.
Mengarahkan pelanggan untuk memasukkan alamat dengan cepat dan akurat:
Place Autocomplete mempercepat pengisian alamat dan mengurangi kesalahan input, sehingga
pelanggan dapat menyelesaikan checkout dengan mudah. Validasi Alamat memberikan masukan tentang kualitas alamat secara keseluruhan, melakukan koreksi seperti standardisasi dan kesalahan ejaan, serta meningkatkan kualitas metadata, seperti memberikan indikator residensial atau komersial (tersedia di wilayah tertentu).
Ringkasan Penerapan
Bagian ini menguraikan alur kerja entri alamat yang direkomendasikan untuk checkout e-commerce. Proses ini terdiri dari tiga langkah:
- Gunakan Place Autocomplete untuk mendapatkan alamat pada awalnya.
- Gunakan Address Validation API untuk mengonfirmasi alamat yang dimasukkan.
- Tampilkan lokasi alamat yang dimasukkan di peta, untuk memberikan keyakinan pengiriman kepada pelanggan.
Selanjutnya, kita akan mempelajari setiap langkah satu per satu.
Langkah 1: Alur entri alamat - menggunakan layanan Place Autocomplete
Terapkan Place Autocomplete menggunakan JavaScript API di baris pertama formulir entri alamat.
Place Autocomplete memberikan saran kepada pelanggan saat mereka memasukkan detail alamat. Saat diterapkan menggunakan JavaScript API, saat pengguna mulai mengetik, menu drop-down akan muncul di bawah kolom formulir entri alamat, yang menampilkan hasil dari layanan Pelengkapan Otomatis yang diperbarui dengan setiap penekanan tombol. Setelah pengguna memasukkan informasi yang cukup untuk menemukan alamat, mereka akan memilihnya dari menu drop-down. Tindakan ini akan otomatis mengisi kolom formulir dengan data alamat.
Anda dapat memberikan dua gaya entri formulir kepada pengguna dengan Place Autocomplete: baik tampilan dengan semua kolom alamat, atau tampilan dengan satu kolom input. Kolom input tunggal ini akan meminta pengguna untuk mulai menelusuri saat mereka mengetik, bukan memasukkan komponen alamat satu per satu. Setelah melengkapi otomatis mengisi alamat, alur kerja akan memperluas kolom formulir dengan data alamat, sehingga pelanggan dapat meninjau dan mengedit, misalnya menambahkan nomor apartemen atau unit.
Berikut adalah contoh tampilan alur ini, menggunakan satu kolom input:
Langkah 2: Gunakan Address Validation API untuk memvalidasi alamat
Setelah pengguna memasukkan alamat, Google merekomendasikan Anda memanggil Address Validation API saat checkout untuk mengonfirmasi bahwa alamat tersebut valid dan lengkap. Picu panggilan ke Address Validation API saat pengguna mengklik tombol Berikutnya atau Lanjutkan di formulir alamat. Tombol ini sering kali mengarah ke halaman pembayaran.
Google merekomendasikan pemanggilan Address Validation API untuk setiap transaksi.
Diagram alur berikut mengilustrasikan contoh integrasi Address Validation API secara menyeluruh dalam checkout:
Dokumen ini akan membahas skenario penerimaan alamat nanti.
Langkah 3: Berikan konfirmasi visual
Setelah entri alamat, berikan konfirmasi visual kepada pengguna terkait lokasi pengiriman dengan menampilkannya di peta. Langkah ini akan memberikan kepastian tambahan kepada pelanggan bahwa alamat tersebut sudah benar dan mengurangi kegagalan pengiriman atau pengambilan.
Peta dapat ditampilkan selama proses checkout, atau dikirim dalam email konfirmasi transaksi. Kedua kasus penggunaan ini dapat dilakukan dengan API berikut.
| Maps JavaScript API menyediakan peta interaktif untuk menampilkan lokasi pengguna. | Maps Static API memungkinkan penyematan gambar dalam halaman web atau pada tahap selanjutnya dalam email. |
|---|---|
 |
 |
Pembahasan Mendalam - skenario penerimaan alamat
Respons Address Validation API dapat dikategorikan ke dalam tiga skenario utama:
- Perbaiki—alamat berkualitas rendah. Anda harus meminta informasi lebih lanjut.
- Konfirmasi—alamat berkualitas tinggi, tetapi memiliki perubahan dari alamat input. Anda mungkin diminta untuk konfirmasi.
- Terima—alamat berkualitas tinggi. Anda dapat menerima alamat yang diberikan.
Konsep ini dibahas di bagian Bangun logika validasi Anda dalam dokumentasi Address Validation API, dan kita akan membahas setiap skenario di bagian ini.
Perbaiki
Bagian ini menunjukkan cara memperbaiki input alamat. Untuk mengetahui informasi tentang sinyal spesifik yang ditampilkan Address Validation API untuk menunjukkan alamat berkualitas rendah, lihat Memperbaiki alamat dalam dokumentasi Membangun logika validasi Anda.
Jika respons dari Address Validation API menunjukkan alamat yang tidak valid, alihkan pelanggan ke formulir entri alamat untuk memeriksa data yang dimasukkan. Setelah alamat diperbaiki, layanan Anda harus mengirim ulang ke Address Validation API untuk memastikan koreksi yang dilakukan valid.
Anda juga dapat menandai error baris alamat tertentu menggunakan sinyal yang ditampilkan di tingkat addressComponents. Contohnya dapat dilihat dalam screenshot di sebelah kanan.
Konfirmasi
Bagian ini menunjukkan cara mengonfirmasi alamat. Untuk mengetahui informasi tentang sinyal spesifik yang ditampilkan Address Validation API untuk menunjukkan bahwa alamat harus dikonfirmasi, lihat Mengonfirmasi alamat dalam dokumentasi Membangun logika validasi Anda.
Sering kali sistem Anda akan meminta pengguna untuk mengonfirmasi alamat. Misalnya, pelanggan salah mengeja nama kota, yang kemudian akan dikoreksi oleh Address Validation API. Anda harus mengonfirmasi perbaikan ini dengan pelanggan. Hal ini karena perubahan yang dilakukan oleh API dapat mengubah secara mendasar apa yang awalnya dimasukkan.
Gunakan modal interstisial untuk menampilkan informasi kepada pelanggan, yang memungkinkan tiga opsi untuk melanjutkan:
- Konfirmasi alamat yang ditampilkan oleh API, dan proses checkout berlanjut, menggunakan alamat yang telah dikoreksi.
- Pilih alamat sebagaimana dimasukkan semula, dengan mengabaikan koreksi dari Address Validation API. Proses checkout dapat dilanjutkan seperti biasa, dan pesanan dapat ditandai untuk peninjauan lanjutan sebelum pengiriman, jika proses Anda mengizinkan.
- Pelanggan membatalkan atau keluar dari modal, sehingga mereka kembali ke tahap entri alamat dari proses checkout, tempat mereka dapat memasukkan kembali alamat dari awal, sehingga memulai proses lagi.
Contohnya dapat dilihat pada screenshot di sebelah kanan.
Terima
Bagian ini menunjukkan cara menyetujui alamat. Untuk mengetahui informasi tentang sinyal spesifik yang ditampilkan Address Validation API untuk menunjukkan bahwa alamat memiliki kualitas yang baik dan harus diterima, lihat Menerima alamat dalam dokumentasi Membangun logika validasi Anda.
Dalam skenario ini, proses checkout harus dilanjutkan ke tahap berikutnya, kemungkinan pengambilan pembayaran, tanpa ada perintah kepada pelanggan terkait kualitas alamat. API telah mengonfirmasi bahwa alamat yang dimasukkan oleh pelanggan memiliki kualitas yang baik dan dapat dikirim.
Sebaiknya gunakan data alamat yang ditampilkan dari Address Validation API untuk pesanan, karena data ini dapat berisi koreksi dan tambahan kecil, seperti berikut:
- Kapitalisasi
- Koreksi pemformatan, misalnya
- Street to St
- Urutan komponen alamat yang benar
- ZIP+4 di Amerika Serikat.
Pertimbangan Penerapan
Saat membuat logika penerimaan alamat, pastikan penerapan Anda tidak memblokir pelanggan untuk melakukan checkout karena memasukkan alamat yang tidak valid. Buat logika sedemikian rupa untuk mencegah kemungkinan loop tak terbatas jika API berulang kali menunjukkan bahwa entri pengguna tidak valid.
Google merekomendasikan agar Anda memberi pelanggan hingga dua kali kesempatan untuk memasukkan alamat mereka, dan pada percobaan kedua, terima entri mereka, meskipun entri tersebut tidak divalidasi. Pada upaya kedua, tujuannya adalah membiarkan mereka melanjutkan terlepas dari validasi.
Dua metode yang disarankan untuk menerima upaya kedua:
- Lanjutkan secara paksa: Tampilkan modal kepada pelanggan yang menjelaskan bahwa alamat tidak divalidasi, tetapi izinkan opsi untuk melanjutkan dengan alamat yang diketik.
- Penerimaan Senyap: Menerima upaya kedua secara otomatis tanpa langkah konfirmasi, meskipun alamat tidak sepenuhnya divalidasi.
Jika memungkinkan, desain sistem Anda untuk menandai alamat yang tidak divalidasi, sehingga perwakilan layanan pelanggan dapat meninjaunya sebelum pesanan dikirim. Tindakan tambahan ini memastikan Anda menemukan kesalahan apa pun.
Konstruksi bangunan baru memberikan ilustrasi yang baik tentang alasan pemeriksaan ini direkomendasikan. Mungkin ada jeda waktu antara saat konstruksi bangunan baru selesai dan saat alamat bangunan tersebut diisi dalam database alamat pos. Pelanggan harus memiliki opsi untuk melanjutkan secara paksa melalui halaman checkout dengan alamat yang diketik, meskipun alamat tersebut tidak divalidasi.
Setelah sesi checkout selesai, Anda dapat menggunakan metode
provideValidationFeedback
untuk mengirimkan masukan kepada Google tentang upaya validasi alamat tertentu.
Kesimpulan
Dokumen ini telah memberikan ringkasan alur checkout yang menerapkan Pengisian Otomatis, Validasi Alamat, dan konfirmasi visual di Google Maps. Gunakan dokumen ini sebagai titik awal untuk mendesain penerapan Anda, dengan mengikuti alur entri alamat yang direkomendasikan.
Langkah Berikutnya
Download Meningkatkan kualitas checkout, pengiriman, dan operasi dengan alamat yang andal Whitepaper dan tonton Webinar Meningkatkan kualitas checkout, pengiriman, dan operasi dengan Validasi Alamat .
Bacaan lebih lanjut yang disarankan:
Kontributor
Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Solutions Engineer
-
Pemegang Lisensi non-eksklusif United States Postal Service. Merek dagang berikut dimiliki oleh United States Postal Service® dan digunakan dengan izin: CASS™, USPS®, DPV®. ↩