Tujuan
Dokumen ini menjelaskan metode untuk menggabungkan Place Autocomplete, Address Validation API1, dan Maps dalam checkout e-commerce dengan tujuan menangkap alamat berkualitas tinggi.
Prasyarat
Google merekomendasikan agar Anda memahami 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 pada 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 itu validasi alamat?
Address Validation API adalah layanan yang menerima alamat. Alat ini mengidentifikasi komponen alamat dan memvalidasinya. File ini juga menstandarkan alamat untuk pengiriman surat dan menemukan koordinat lintang/bujur yang paling diketahui untuk alamat tersebut. Secara opsional, untuk alamat di Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan Sistem Dukungan Akurasi Coding (CASSTM).Mengapa Anda memerlukan validasi alamat saat checkout?
Kumpulkan alamat yang akurat selama proses pemesanan:
Ini adalah langkah penting untuk mendorong keberhasilan pengiriman, meningkatkan pemenuhan pesanan tepat waktu, dan mengurangi biaya koreksi alamat yang mahal.
Pandu pelanggan untuk memasukkan alamat dengan cepat dan akurat:
Place Autocomplete mempercepat entri alamat dan mengurangi error input, sehingga memudahkan
pelanggan melakukan checkout. Validasi Alamat memberikan masukan
tentang kualitas alamat secara keseluruhan, melakukan koreksi seperti standardisasi dan
kesalahan ejaan, serta meningkatkan metadata, seperti memberikan indikator perumahan 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 pertama kali mengambil alamat.
- Gunakan Address Validation API untuk mengonfirmasi alamat yang dimasukkan.
- Tampilkan lokasi alamat yang dimasukkan pada peta, untuk memberikan keyakinan pada pengiriman kepada pelanggan.
Selanjutnya, kita akan mempelajari setiap langkah secara terpisah.
Langkah 1: Alur entri alamat - menggunakan layanan Place Autocomplete
Terapkan Place Autocomplete menggunakan JavaScript API pada baris pertama formulir entri alamat.
Place Autocomplete memberikan saran kepada pelanggan saat mereka memasukkan detail alamat. Jika diterapkan menggunakan JavaScript API, saat pengguna mulai mengetik, drop-down akan muncul di bawah kolom formulir entri alamat, yang menampilkan hasil dari layanan Autocomplete yang diperbarui setiap kali tombol ditekan. 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: tampilan dengan semua kolom alamat, atau tampilan dengan satu kolom input. Kolom input tunggal ini meminta pengguna untuk mulai menelusuri saat mengetik, bukan memasukkan komponen alamat satu per satu. Setelah pelengkapan otomatis mengisi alamat, alur kerja akan memperluas kolom formulir dengan data alamat, sehingga memungkinkan pelanggan meninjau dan melakukan pengeditan, 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 agar Anda memanggil Address Validation API saat checkout untuk mengonfirmasi bahwa alamat tersebut valid dan lengkap. Picu panggilan ke Address Validation API setelah pengguna mengklik tombol Berikutnya atau Lanjutkan di formulir alamat. Tombol ini sering kali mengarah ke halaman pembayaran.
Google merekomendasikan untuk memanggil Address Validation API untuk setiap transaksi.
Diagram alur berikut mengilustrasikan contoh integrasi menyeluruh Address Validation API dalam checkout:
Dokumen ini 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. Hal ini menawarkan kepastian tambahan kepada pelanggan bahwa alamat 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 diselesaikan dengan API berikut.
| Maps JavaScript API menyediakan peta interaktif untuk menampilkan lokasi pengguna. | Maps Static API memungkinkan penyematan gambar di dalam halaman web atau di tahap berikutnya dalam email. |
|---|---|
 |
 |
Pembahasan Mendalam - mengatasi skenario penerimaan
Respons Address Validation API dapat dikategorikan ke dalam tiga skenario utama:
- Perbaiki—alamat berkualitas rendah. Anda harus meminta informasi selengkapnya.
- Konfirmasi—alamat berkualitas tinggi, tetapi memiliki perubahan dari alamat input. Anda mungkin meminta konfirmasi.
- Setuju—alamat berkualitas tinggi. Anda dapat menerima alamat yang diberikan.
Konsep ini dibahas di bagian Membangun logika validasi pada dokumen Address Validation API, dan kita akan membahas setiap skenario di bagian ini.
Perbaiki
Bagian ini menunjukkan cara memperbaiki input alamat. Untuk informasi tentang sinyal tertentu yang ditampilkan oleh 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 sudah valid.
Anda juga dapat menandai error baris alamat tertentu menggunakan sinyal
yang ditampilkan di tingkat addressComponents. Contohnya dapat dilihat di
screenshot di sebelah kanan.
Konfirmasi
Bagian ini menunjukkan cara mengonfirmasi alamat. Untuk mengetahui informasi tentang sinyal tertentu yang ditampilkan oleh Address Validation API untuk menunjukkan alamat yang harus dikonfirmasi, lihat Mengonfirmasi alamat di dokumentasi Membangun logika validasi Anda.
Sering kali sistem Anda 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 dibuat oleh API mungkin pada dasarnya mengubah apa yang awalnya dimasukkan.
Gunakan modal interstisial untuk menampilkan informasi kepada pelanggan, yang memungkinkan tiga opsi untuk melanjutkan:
- Konfirmasi alamat seperti yang ditampilkan oleh API, dan proses checkout akan dilanjutkan, menggunakan alamat yang dikoreksi.
- Pilih alamat seperti yang pertama kali dimasukkan, dengan mengabaikan koreksi dari Address Validation API. Proses checkout dapat dilanjutkan seperti biasa, dan pesanan dapat ditandai untuk peninjauan downstream sebelum pengiriman, jika proses Anda memungkinkan.
- Pelanggan membatalkan atau keluar dari modal, dan mengembalikannya ke tahap entri alamat pada proses checkout, tempat mereka dapat memasukkan kembali alamat tersebut dari awal, sehingga memulai proses dari awal.
Contohnya dapat dilihat pada screenshot di sebelah kanan.
Setujui
Bagian ini menunjukkan cara menerima alamat. Untuk informasi tentang sinyal tertentu yang ditampilkan oleh Address Validation API guna menunjukkan bahwa alamat berkualitas baik dan harus diterima, lihat Menerima alamat di dokumentasi Membangun logika validasi.
Dalam skenario ini, proses checkout harus berlanjut ke tahap berikutnya, kemungkinan pengambilan pembayaran, tanpa dialog kepada pelanggan terkait kualitas alamat. API telah mengonfirmasi bahwa alamat yang dimasukkan oleh pelanggan berkualitas baik, dan dapat dikirim.
Sebaiknya gunakan data alamat yang ditampilkan dari Address Validation API terhadap pesanan, karena dapat berisi koreksi dan penambahan kecil, seperti berikut:
- Kapitalisasi
- Koreksi pemformatan, misalnya
- Jalan ke St.
- Urutan komponen alamat yang benar
- ZIP+4 di AS.
Pertimbangan Penerapan
Saat membuat logika penerimaan alamat, pastikan penerapan Anda tidak memblokir pelanggan untuk check out karena memasukkan alamat yang tidak valid. Buat logika dengan cara yang mencegah kemungkinan loop tak terbatas jika API berulang kali menunjukkan entrinya tidak valid.
Google menyarankan agar Anda memberi pelanggan hingga dua kesempatan untuk memasukkan alamat mereka, dan pada upaya kedua, menerima entri mereka, meskipun tidak divalidasi. Pada upaya kedua, tujuannya adalah membiarkan mereka melanjutkan terlepas dari validasi.
Dua metode yang disarankan untuk menerima upaya kedua:
- Paksa lanjutkan: Tampilkan modal yang menjelaskan bahwa alamat tidak divalidasi kepada pelanggan, tetapi izinkan opsi untuk melanjutkan dengan alamat yang telah diketik.
- Penerimaan Senyap: Secara otomatis menerima upaya kedua tanpa langkah konfirmasi, meskipun alamat tidak sepenuhnya divalidasi.
Jika memungkinkan, desain sistem Anda untuk menandai alamat yang tidak tervalidasi, sehingga perwakilan layanan pelanggan dapat meninjaunya sebelum pesanan dikirim. Tindakan tambahan ini memastikan Anda mendeteksi kesalahan.
Konstruksi bangunan baru memberikan ilustrasi yang baik tentang mengapa pemeriksaan ini direkomendasikan. Mungkin ada kesenjangan antara saat konstruksi bangunan baru selesai dan saat alamat bangunan tersebut diisi di database alamat pos. Pelanggan harus memiliki opsi untuk melanjutkan paksa melalui halaman checkout dengan alamat yang mereka ketik, meskipun tidak memvalidasi.
Setelah sesi checkout selesai, Anda dapat memilih untuk menggunakan metode provideValidationFeedback untuk mengirim masukan ke Google tentang upaya validasi alamat tertentu.
Kesimpulan
Dokumen ini memberikan ringkasan alur checkout yang menerapkan Pelengkapan Otomatis, Validasi Alamat, dan konfirmasi visual pada Google Maps. Gunakan dokumen ini sebagai titik awal untuk mendesain implementasi Anda, dengan mengikuti alur entri alamat yang direkomendasikan.
Langkah Berikutnya
Download laporan resmi Meningkatkan checkout, pengiriman, dan operasi dengan alamat yang andal Laporan resmi dan lihat Webinar Meningkatkan checkout, pengiriman, dan operasi dengan Validasi Alamat .
Saran bacaan lebih lanjut:
Kontributor
Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Solutions Engineer
-
Penerima Lisensi non-eksklusif dari Layanan Pos Amerika Serikat. Merek dagang berikut dimiliki oleh United States postal Service® dan digunakan dengan izin: CASSTM, USPS®, DPV®. ↩