Pendaftaran Program Loyalitas Pengguna & Upgrade Tiket

Fitur pendaftaran dan login loyalitas memungkinkan pengguna menelusuri program loyalitas Anda dan bergabung atau login ke akun mereka langsung dari Google Wallet. Pengguna akan diarahkan ke situs yang mobile-friendly untuk menyelesaikan prosesnya, setelah itu mereka dapat menambahkan kartu resmi mereka ke Google Wallet.

Penerapan fitur ini adalah prasyarat untuk mengonversi kartu "statis" yang ditambahkan pengguna menjadi kartu "dinamis" yang ditautkan ke API. Panduan ini memberikan ringkasan manfaat dan langkah-langkah penerapan yang diperlukan untuk mengaktifkan program loyalitas Anda untuk pendaftaran, login, dan upgrade kartu.

Ringkasan

Untuk memulai, pastikan Anda telah menyiapkan project dan memiliki akses ke Google Wallet API.

Anda harus mengikuti empat langkah berikut untuk menerapkan fitur ini:

  1. Siapkan kelas pengujian: Konfigurasikan Google Wallet untuk menguji alur Anda.
  2. Mengembangkan halaman: Buat halaman pendaftaran/login menggunakan SharedDataType Google Wallet.
  3. Menerapkan push back: Kirim kartu loyalitas ke Google Wallet setelah tindakan.
  4. Minta verifikasi: Kirim untuk ditinjau dan minta aktivasi upgrade.

Mengapa Perlu Menerapkan Pendaftaran Loyalitas?

Untuk memahami nilai integrasi ini, penting untuk membedakan antara dua jenis kartu yang ada di Google Wallet: L1 (Ditambahkan Pengguna) dan L2 (Diterbitkan Partner).

Perbedaan Antara L1 dan L2

Fitur L1 Pass (User-Added) Kartu L2 (Diterbitkan Partner)
Asal Dibuat saat pengguna memindai kartu fisik secara manual atau mengetikkan nomor. Dibuat dan dikirim menggunakan Wallet API setelah pengguna mendaftar atau login menggunakan alur Anda.
Kontrol Statis. Partner tidak memiliki visibilitas atau kontrol atas kartu ini. Dinamis. Partner memiliki kontrol penuh menggunakan API.
Fungsi Gambar statis kode batang. Tidak dapat diperbarui. Dapat memperbarui saldo poin, status tingkat, menampilkan penawaran yang dipersonalisasi, dan menerima notifikasi.

Jalur Upgrade: "Jembatan" ke Program Anda

Dengan membangun alur Pendaftaran Loyalitas ("tujuan"), Anda memungkinkan Google membangun "jembatan" yang mengupgrade pengguna dari kartu L1 statis ke kartu L2 resmi Anda. Ada dua pemicu upgrade utama:

  1. Upgrade Kartu L1 ke L2: Jika pengguna sebelumnya telah menambahkan kartu Anda secara manual (L1), Google Wallet dapat meminta mereka untuk mengunjungi alur login baru Anda guna mengupgrade ke kartu dinamis resmi (L2).
  2. Upgrade Kartu yang Diimpor dari Gmail: Jika Google Wallet mendeteksi kartu loyalitas menggunakan Gmail pengguna, Google Wallet dapat meminta pengguna untuk mengunjungi alur Anda dan melakukan autentikasi untuk menerima kartu L2 resmi.

Langkah 1: Siapkan class pengujian di Google Wallet

Tentukan URL pendaftaran dan login, logo program, dan kolom pengguna yang dipilih. Kemudian, gunakan kolom bertingkat discoverableProgram di loyaltyclass untuk menetapkan nilai yang sesuai.

Tetapkan nilai di discoverableProgram untuk membuat versi draf program loyalitas yang diaktifkan untuk pendaftaran/login. Untuk memastikan hal ini terlihat oleh penguji, pastikan penguji memiliki akses ke Konsol Google Pay dan Wallet Anda. Untuk mengetahui detail tentang cara membagikan akses Konsol Google Pay dan Wallet kepada orang lain, lihat Mempelajari halaman Pengguna.

Untuk menyelesaikan verifikasi fungsi penerapan Anda selama proses pengembangan, hubungi kami menggunakan widget hubungi dukungan di Konsol Google Pay dan Wallet. Saat berada di konsol, pilih Google Wallet API dalam topik, lalu pilih Login/pendaftaran loyalitas dalam subtopik.

Langkah 2: Kembangkan halaman pendaftaran dan login

Saat pengguna memilih untuk login atau mendaftar ke program loyalitas Anda, mereka akan diarahkan ke halaman yang disesuaikan di situs Anda untuk menyelesaikan proses pendaftaran atau login. Jika pengguna memilih untuk mendaftar, Google Wallet akan meminta pengguna untuk menyetujui berbagi data pengguna mereka dengan Anda.

Anda harus menyediakan salah satu atau kedua halaman yang memungkinkan pengguna menyelesaikan tindakan berikut:

  1. URL login tempat pengguna dapat login ke akun yang ada.
  2. URL pendaftaran tempat pengguna dapat membuat akun baru.

Halaman login dan pendaftaran Anda harus memenuhi persyaratan berikut:

  • Berikan pengalaman pengguna yang mobile-friendly.
  • Minimalkan jumlah kolom wajib diisi selama proses pendaftaran.
  • Izinkan pengguna menyelesaikan login atau pendaftaran dalam satu halaman.
  • Gunakan enkripsi HTTPS dengan sertifikat yang valid untuk memastikan data pengguna dikirimkan dengan aman.
  • Pastikan waktu beroperasi halaman login dan pendaftaran Anda minimal 99,9%.

Selain persyaratan ini, sebaiknya Anda mengizinkan pengguna mendaftar ke program loyalitas Anda tanpa mengisi formulir apa pun atau hanya menampilkan halaman persetujuan persyaratan layanan Anda.

  • Dengan memanfaatkan data pengguna yang diberikan di SharedDataType, Anda dapat membuat akun dan langsung mengirim kembali kartu loyalitas mereka.
  • Selanjutnya, Anda dapat mengirimkan sandi sekali pakai melalui email kepada pengguna, atau link untuk mengonfigurasi sandi dan detail akun opsional mereka.
  • Hal ini mengurangi kemungkinan pengguna membatalkan proses pendaftaran, karena setiap langkah tambahan dapat menyebabkan pengguna berhenti mendaftar.

Saat menampilkan halaman login atau pendaftaran, Google Wallet akan membuat WebView Android dan permintaan POST akan dibuat ke URL yang Anda berikan. Data pengguna disediakan dalam parameter SharedDataType yang disertakan dalam permintaan POST dengan Content-Type application/x-www-form-urlencoded dan encoding UTF-8. Nilai parameter SharedDataType adalah objek JSON yang dienkode dengan Base64.

Bergantung pada tindakan yang dipilih oleh pengguna dan kolom yang telah Anda tentukan untuk diminta dari pengguna, objek JSON dapat berisi kolom berikut.

Kolom Pendaftaran
email ✓
firstName ✓
lastName ✓
addressLine [1-3] ✓
kota ✓
dengan status tersembunyi akhir ✓
zipcode ✓
country ✓
telepon ✓

Lihat contoh objek JSON yang didekode yang terdapat dalam SharedDataType berikut.

Resource

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "jane.doe@example.com",
  "phone": "555-555-5555"
}

Langkah 3: Terapkan pengiriman langsung ke Google Wallet

Setelah diautentikasi (login), atau setelah pembuatan akun (pendaftaran), halaman Anda harus segera mengirim kembali kartu loyalitas pengguna ke Google Wallet.

Anda dapat mengirim kembali kartu loyalitas ke Google Wallet dengan mengalihkan ke link yang mengikuti struktur berikut.

https://pay.google.com/gp/v/save/{jwt_generated}

Panjang aman untuk URL adalah 2.000 karakter. Link Anda tidak boleh melebihi batas ini. Objek yang dienkode dalam JWT harus berukuran kecil, hanya berisi data yang spesifik untuk pengguna. Coba simpan sebagian besar data di class objek, dengan membuatnya sebelum membuat JWT. Untuk objek yang lebih besar yang tidak memenuhi batas, pertimbangkan untuk membuat objek terlebih dahulu di Google Wallet API dan hanya mengirim ID objek di JWT.

Alur Komunikasi Umum

Alur komunikasi untuk pengguna yang menyelesaikan pendaftaran atau login diilustrasikan dalam gambar berikut. Semua tindakan antara "Server Anda" adalah tanggung jawab Anda untuk diterapkan.

Alur login pendaftaran

Langkah 4: Minta verifikasi dan aktivasi

Setelah menyelesaikan pekerjaan pengembangan dan menguji alur pendaftaran/login, Anda harus mengirimkan permintaan agar implementasi Anda ditinjau dan diaktifkan sepenuhnya.

  1. Buka Konsol Google Pay dan Wallet.
  2. Gunakan widget Hubungi Dukungan.
  3. Beri tahu tim dukungan bahwa Anda telah menyelesaikan integrasi Pendaftaran Loyalitas.

Setelah peninjauan penuh atas penerapan Anda yang mengonfirmasi fungsi yang benar dalam kombinasi dengan aplikasi Google Wallet, fitur pendaftaran/login loyalitas akan diluncurkan secara publik untuk program loyalitas Anda.

Untuk memastikan pengalaman pengguna yang optimal, pemeriksaan berulang terhadap penerapan pendaftaran/login Anda akan dilakukan untuk memastikan kepatuhan berkelanjutan terhadap persyaratan fitur. Anda akan diberi tahu jika terjadi perbedaan dan fungsi login/pendaftaran dapat dinonaktifkan hingga masalah tersebut diselesaikan.

Pertanyaan Umum (FAQ)

  • Apakah ada persyaratan untuk gambar yang digunakan dalam program loyalitas saya? Ya, gambar Anda harus dihosting di lokasi HTTPS karena jika tidak, gambar tersebut tidak akan terlihat di Google Wallet.

  • Apakah ada alat yang menyederhanakan penerapan dan proses debug JWT? Ya, platform seperti www.jwt.io memungkinkan Anda mendekode dan men-debug token selama proses pengembangan, sehingga Anda dapat memverifikasi konten yang Anda kirimkan. Perhatikan bahwa Google tidak memiliki afiliasi dan tidak secara khusus merekomendasikan pihak ketiga tersebut.

  • Bagaimana cara menangani data SharedDataType berenkode Base64 dengan benar? Pastikan Anda menggunakan encoding UTF-8 di seluruh proses. String JSON pertama-tama dienkode UTF-8, lalu dienkode menggunakan android.util.Base64 dengan opsi NO_WRAP dan URL_SAFE. Hal ini sesuai dengan RFC 3548 bagian 4.