Tujuan
Dokumen ini menjelaskan metode untuk menggabungkan Place Autocomplete dan Address Validation API1, dan Maps dalam checkout e-commerce untuk tujuan mendapatkan alamat berkualitas tinggi.
Prasyarat
Google merekomendasikan agar Anda memahami hal berikut:
- Developer JavaScript Place Autocomplete
dokumentasi.
- Memahami dari sudut pandang teknis cara Pelengkapan Otomatis Tempat cara kerja dan opsi implementasinya.
- Panduan Penerapan checkout untuk Tempat
Pelengkapan Otomatis.
- Contoh praktik terbaik penerapan Place Autocomplete di checkout e-commerce.
- Produk Address Validation API
dokumentasi,
dengan fokus pada Membangun validasi Anda
logika.
- Memahami dari sudut pandang teknis bagaimana Address Validation API berfungsi, dan meninjau sinyal yang menentukan kualitas alamat.
Apa itu validasi alamat?
Address Validation API adalah layanan yang menerima alamat. Alat ini mengidentifikasi komponen alamat dan memvalidasinya. Standar ini juga menstandarkan untuk pengiriman surat dan menemukan koordinat lintang/bujur yang paling dikenal. Secara opsional, untuk alamat di Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan Coding Akurasi Support System (CASSTM).Mengapa Anda memerlukan validasi alamat saat checkout?
Kumpulkan alamat yang akurat selama proses pemesanan:
Ini adalah langkah penting untuk mempromosikan
pengiriman yang sukses, peningkatan tepat waktu
pemenuhan pesanan, dan mengurangi biaya koreksi alamat yang mahal.
Pandu pelanggan untuk memasukkan alamat dengan cepat dan akurat:
Pelengkapan Otomatis Tempat mempercepat entri alamat dan mengurangi error input, sehingga memungkinkan
pelanggan untuk lebih mudah melakukan checkout. Validasi Alamat memberikan masukan
pada kualitas alamat secara keseluruhan, melakukan koreksi seperti
kesalahan ejaan, dan menyempurnakan metadata, seperti menyediakan
indikator komersial (tersedia di pilih
region default.
Ringkasan Penerapan
Bagian ini menguraikan alur kerja entri alamat yang direkomendasikan untuk e-commerce pembayaran. 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 melakukan pengiriman kepercayaan diri kepada pelanggan.
Selanjutnya, kita akan mempelajari setiap langkah secara terpisah.
Langkah 1: Alur entri alamat - menggunakan layanan Place Autocomplete
Menerapkan Place Pelengkapan Otomatis menggunakan JavaScript API di baris pertama formulir entri alamat.
Pelengkapan Otomatis Tempat memberikan saran kepada pelanggan saat mereka memasukkan detail alamat. Jika diterapkan menggunakan JavaScript API, saat pengguna memulai mengetik, menu drop-down akan muncul di bawah bidang formulir entri alamat, yang menunjukkan hasil dari layanan Autocomplete yang diperbarui setiap kali tombol ditekan. Setelah pengguna telah memasukkan informasi yang cukup untuk menemukan alamat, dia memilihnya dari drop-down. Tindakan ini akan otomatis mengisi kolom formulir dengan alamat tersebut layanan otomatis dan data skalabel.
Anda dapat menyediakan dua gaya entri formulir kepada pengguna dengan Place Autocomplete: baik tampilan dengan semua kolom alamat, atau tampilan dengan satu input kolom tersebut. Satu isian {i>input<i} ini meminta pengguna untuk mulai menelusuri saat mereka mengetik, alih-alih memasukkan komponen alamat satu per satu. Setelah pelengkapan otomatis mengisi alamat, alur kerja memperluas kolom formulir dengan alamat sehingga pelanggan dapat meninjau dan melakukan pengeditan, misalnya menambahkan apartemen atau nomor 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 menyarankan agar Anda memanggil Alamat Validasi API saat checkout untuk mengonfirmasi bahwa alamat tersebut valid dan lengkap. Picu panggilan ke Address Validation API setelah pengguna mengklik tombol "Next" atau "Continue" formulir alamat. Tombol ini sering kali mengarah ke halaman pembayaran.
Google merekomendasikan untuk memanggil Address Validation API untuk setiap transaksi.
Diagram alir 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 pengiriman kepada pengguna lokasi dengan menampilkannya pada peta. Hal ini memberi pelanggan tambahan jaminan bahwa alamat tersebut sudah benar, dan mengurangi pengiriman atau pengambilan gagal.
Peta dapat ditampilkan selama proses checkout, atau dikirim dalam transaksi email konfirmasi. Kedua kasus penggunaan ini dapat diselesaikan dengan berikut ini API.
| 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—alamatnya 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 menyetujui alamat yang diberikan.
Konsep ini dibahas dalam artikel Membangun validasi Anda logika dari dokumen Address Validation API, dan kita akan membahas setiap skenario dalam bagian ini.
Perbaiki
Bagian ini menunjukkan cara memperbaiki input alamat. Untuk informasi tentang sinyal yang ditampilkan oleh Address Validation API untuk menunjukkan kualitas rendah alamat, lihat Memperbaiki Anda di dokumentasi Membangun logika validasi.
Jika respons dari Address Validation API menunjukkan alamat yang tidak valid, mengalihkan pelanggan ke formulir entri alamat untuk memeriksa data yang mereka masukkan. Setelah alamat diperbaiki, layanan Anda akan mengirim ulang ke Alamat Validation API untuk memastikan koreksi yang dilakukan adalah valid.
Anda juga dapat menandai kesalahan baris alamat tertentu dengan menggunakan sinyal
yang ditampilkan di level addressComponents. Contohnya dapat dilihat di
screenshot di sebelah kanan.
Konfirmasi
Bagian ini menunjukkan cara mengonfirmasi alamat. Untuk informasi tentang sinyal yang ditampilkan oleh Address Validation API untuk menunjukkan bahwa alamat harus dikonfirmasi, lihat Mengonfirmasi Anda di dokumentasi Membangun logika validasi.
Sering kali sistem Anda meminta pengguna untuk mengonfirmasi alamat. Misalnya, pelanggan salah mengeja nama kota, yang kemudian akan diperbaiki dengan Alamat Validation API. Anda harus mengonfirmasi perbaikan ini dengan pelanggan. Hal ini karena perubahan yang dibuat oleh API mungkin secara mendasar mengubah 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 berlanjut, menggunakan alamat yang dikoreksi.
- Pilih alamat seperti yang dimasukkan sebelumnya, dengan mengabaikan koreksi dari Address Validation API. Proses {i>checkout<i} dapat berjalan seperti biasa, dan pesanan dapat ditandai untuk peninjauan downstream sebelum dikirim, jika proses Anda Anda izinkan.
- Pelanggan membatalkan atau keluar dari modal, mengembalikannya ke alamat awal pada proses {i>checkout<i}, di mana mereka dapat memasukkan kembali dari awal, dan memulai dari awal.
Contohnya dapat dilihat pada screenshot di sebelah kanan.
Setujui
Bagian ini menunjukkan cara menerima alamat. Untuk informasi tentang sinyal yang ditampilkan oleh Address Validation API untuk menunjukkan bahwa alamat tersebut baik. dan harus diterima, lihat Menyetujui Anda di dokumentasi Membangun logika validasi.
Dalam skenario ini, proses {i>checkout<i} harus dipindah ke tahap berikutnya, kemungkinan pengambilan pembayaran, tanpa pertanyaan kepada pelanggan terkait kualitas alamat. API telah mengonfirmasi bahwa alamat yang dimasukkan oleh pelanggan berkualitas baik, hasil kerja/capaiannya.
Sebaiknya gunakan data alamat yang ditampilkan dari Address Validation API melanggar perintah, karena ini bisa berisi perbaikan 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 agar tidak check out karena memasukkan alamat yang tidak valid. Bangun logika sedemikian rupa sehingga mencegah kemungkinan loop tak terbatas jika API berulang kali menunjukkan entri mereka tidak valid.
Google merekomendasikan agar Anda memberi pelanggan hingga dua kesempatan untuk memasukkan dan pada upaya kedua, menerima entrinya, meskipun tidak validate. Pada upaya kedua, tujuannya adalah membiarkan mereka melanjutkan terlepas dari validasi.
Dua metode yang disarankan untuk menerima upaya kedua:
- Paksa lanjutkan: Menunjukkan kepada pelanggan modal yang menjelaskan alamat yang tidak memvalidasi, tetapi mengizinkan opsi untuk melanjutkan dengan alamat yang diketikkan.
- Penerimaan Senyap: Secara otomatis menerima upaya kedua tanpa permintaan konfirmasi tambahan, bahkan jika alamat tersebut tidak sepenuhnya divalidasi.
Jika memungkinkan, rancang sistem Anda untuk menandai alamat yang tidak tervalidasi, sehingga perwakilan layanan pelanggan dapat meninjaunya sebelum pesanan dikirim. Ini langkah tambahan memastikan Anda dapat menemukan kesalahan.
Konstruksi bangunan baru memberikan ilustrasi yang baik tentang alasan pemeriksaan ini direkomendasikan. Mungkin ada kesenjangan antara saat konstruksi bangunan baru selesai dan saat alamat gedung tersebut telah diisi di alamat pos {i>database<i}. Pelanggan harus memiliki opsi untuk melanjutkan melalui laman {i>checkout<i} dengan alamat yang mereka ketik, meskipun tidak dapat divalidasi.
Setelah sesi {i>checkout<i} selesai, gunakan metode
provideValidationFeedback
metode untuk mengirimkan masukan ke Google
tentang upaya validasi alamat tertentu.
Kesimpulan
Dokumen ini memberikan ringkasan tentang alur checkout yang menerapkan Pelengkapan Otomatis, Validasi Alamat, dan konfirmasi visual di Google Maps. Gunakan dokumen ini sebagai titik awal untuk merancang implementasi Anda, dengan mengikuti alur entri alamat yang disarankan.
Langkah Berikutnya
Download panduan Tingkatkan checkout, pengiriman, dan operasi dengan alamat yang tepercaya Laporan resmi dan lihat Meningkatkan checkout, pengiriman, dan operasi dengan Alamat Validasi Webinar.
Saran bacaan lebih lanjut:
Kontributor
Valve Henrik | Engineer Solusi
Thomas Anglaret | Engineer Solusi
Sarthak Ganguly | Engineer Solusi
-
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®. ↩