Menguji integrasi Library Layanan Penagihan Google Play Anda

Anda harus menguji integrasi selama pengembangan. Untuk melakukan pengujian selama fase pengembangan, sebaiknya manfaatkan penguji lisensi dan Play Billing Lab untuk menjalankan skenario yang dijelaskan di bagian ini.

Penguji Lisensi

Untuk mengonfigurasi penguji lisensi, lihat Menguji penagihan via Google Play dengan pemberian lisensi aplikasi.

Dengan menggunakan penguji lisensi, Anda bisa mendapatkan beberapa manfaat berikut:

  • Biasanya, Library Layanan Penagihan Google Play diblokir untuk aplikasi yang tidak ditandatangani dan diupload ke Google Play. Penguji lisensi dapat melewati pemeriksaan ini, artinya Anda dapat men-sideload aplikasi untuk pengujian, bahkan untuk aplikasi yang menggunakan build debug dengan tanda tangan debug tanpa perlu mengupload ke versi baru dari aplikasi Anda. Perhatikan bahwa nama paket harus cocok dengan nama aplikasi yang dikonfigurasi untuk Google Play, dan Akun Google harus merupakan akun penguji lisensi untuk akun Konsol Google Play.
  • Penguji lisensi memiliki akses ke metode pembayaran pengujian sehingga penguji tidak akan dikenai biaya ketika melakukan pembelian. Anda juga dapat menggunakan metode pembayaran pengujian untuk melakukan simulasi pada situasi tertentu, seperti saat pembayaran ditolak. Gambar 1 menunjukkan uji metode pembayaran seperti yang akan muncul dalam alur pembelian:
  • Penguji lisensi dapat menguji fitur langganan dengan cepat.
penguji lisensi memiliki akses ke uji metode pembayaran
Gambar 1. Penguji lisensi memiliki akses ke uji metode pembayaran.

Berikut adalah beberapa detail tambahan tentang proses uji pembelian:

  • Uji pembelian menggunakan alur pembelian aplikasi yang sama dengan yang digunakan di pembelian sebenarnya.
  • Pajak tidak dihitung untuk uji pembelian.
  • Google Play mengindikasikan uji pembelian dengan menampilkan pemberitahuan di bagian tengah dialog pembelian.

Anda dapat mengonfirmasi akun yang digunakan untuk melakukan pembelian dengan meluaskan dialog pembelian. Perhatikan hal berikut:

  • Akun pengujian harus berada di perangkat Android penguji.
  • Jika perangkat memiliki lebih dari satu akun, pembelian akan dilakukan dengan akun yang digunakan untuk mendownload aplikasi.
  • Jika belum ada akun yang mendownload aplikasi, pembelian dilakukan dengan akun pertama.

Sebelum mendistribusikan aplikasi, Anda dapat menggunakan jalur pengujian Google Play untuk melakukan validasi tambahan. Misalnya, Anda dapat memanfaatkan track pengujian untuk digunakan oleh tim QA dalam menyeleksi rilis baru.

Dengan track pengujian, pengguna dapat menginstal aplikasi Anda dari Google Play dan menguji versi aplikasi Anda yang belum tersedia untuk publik. Pengguna dapat melakukan pembelian nyata menggunakan metode pembayaran apa pun di Google Play.

Untuk menguji integrasi Library Layanan Penagihan Google Play menggunakan jalur pengujian, lakukan hal berikut:

  1. Publikasikan aplikasi Anda ke jalur pengujian. Setelah Anda memublikasikan aplikasi ke jalur pengujian, perlu waktu beberapa jam hingga aplikasi tersedia untuk penguji.
  2. Pastikan setiap penguji ikut serta dalam pengujian aplikasi Anda. Pada URL keikutsertaan pengujian Anda, penguji akan melihat penjelasan tentang tugas seorang penguji dan link untuk ikut serta.

Anda dapat menguji integrasi di perangkat hardware Android apa pun yang menjalankan Android 1.6 atau yang lebih baru. Versi aplikasi terbaru Google Play harus diinstal di perangkat. Untuk informasi umum tentang cara menyiapkan perangkat untuk digunakan dalam mengembangkan aplikasi Android, lihat Menggunakan Perangkat Hardware.

Play Billing Lab

Lab Layanan Penagihan Play adalah aplikasi Android yang membantu developer menguji integrasinya dengan sistem penagihan Google Play. Hal ini memberikan cara yang mudah dan nyaman bagi developer untuk menguji fitur penagihan, melakukan integrasi lebih cepat, dan meluncurkan dengan lebih yakin. Anda dapat mendownload dan menginstal Play Billing Lab dari Play Store.

Lab Layanan Penagihan Play memungkinkan Anda melakukan hal berikut dalam pengujian:

Dasbor Lab Layanan Penagihan Play
Gambar 2. Dasbor Lab Layanan Penagihan Play.

Menguji produk sekali beli

Menguji produk habis pakai

Saat menguji produk habis pakai, sebaiknya lakukan pengujian dalam berbagai situasi, termasuk situasi berikut:

  • Pembelian yang berhasil, yaitu saat pengguna menerima item. Dengan penguji lisensi, Anda dapat menggunakan metode pembayaran Instrumen uji, selalu disetujui.
  • Pembelian dengan metode pembayaran yang gagal ditagih dan pengguna tidak menerima item tersebut. Dengan penguji lisensi, Anda dapat menggunakan metode pembayaran Instrumen uji, selalu ditolak.
  • Pastikan item dapat dibeli beberapa kali.

Anda juga harus memverifikasi bahwa pembelian telah dikonfirmasi dengan benar seperti yang dijelaskan di memproses pembelian. Untuk pembelian dari penguji lisensi, pembelian akan dikembalikan dananya setelah 3 menit jika aplikasi Anda tidak mengonfirmasi pembelian dan Anda akan menerima email tentang pembatalan. Anda juga dapat memeriksa tab Pesanan di Konsol Google Play untuk melihat apakah dana pesanan telah dikembalikan setelah 3 menit.

Menguji produk tidak habis pakai

Produk yang tidak habis pakai harus diuji, sama halnya dengan produk habis pakai, tetapi Anda harus memverifikasi bahwa item tidak dapat dibeli lagi dalam aplikasi Anda. Pastikan Anda memverifikasi persetujuan pembelian untuk produk tidak habis pakai dan produk habis pakai (jika berlaku) karena logika untuk memproses masing-masing dari kedua jenis pembelian tersebut berbeda-beda.

Menguji pembelian tertunda

Anda harus menguji pembelian tertunda tempat item harus diizinkan saat status pembelian menjadi PURCHASED. Penguji lisensi memiliki akses ke dua instrumen pengujian untuk metode pembayaran tertunda yang pembayarannya secara otomatis diselesaikan atau dibatalkan setelah beberapa menit.

  1. Lakukan pembelian dengan metode pembayaran tertunda "Kartu tes lambat, menolak setelah beberapa menit", seperti yang ditunjukkan pada Gambar 2. Mulai ulang aplikasi, validasi bahwa pembelian belum diizinkan.

    uji pembelian dengan kartu tes lambat yang ditolak
    Gambar 3. Uji pembelian dengan kartu tes lambat yang ditolak.

  2. Lakukan pembelian dengan metode pembayaran tertunda "Kartu tes lambat, menyetujui setelah beberapa menit", seperti yang ditunjukkan pada Gambar 3. Tunggu beberapa menit, validasi bahwa pembelian telah diizinkan.

    uji pembelian dengan kartu tes lambat yang disetujui
    Gambar 4. Uji pembelian dengan kartu tes lambat yang disetujui.

Anda dapat menemukan informasi selengkapnya di bagian Menangani transaksi yang tertunda.

Menguji fitur khusus langganan

Alur pembelian untuk produk sekali beli dan langganan serupa, tetapi langganan memiliki skenario tambahan, seperti perpanjangan langganan yang berhasil atau ditolak. Untuk menguji perpanjangan, Anda dapat menggunakan metode pembayaran Instrumen uji, selalu disetujui dan Instrumen uji, selalu ditolak yang tersedia untuk penguji lisensi seperti yang ditunjukkan pada gambar 1. Gunakan instrumen pembayaran ini untuk menguji skenario di luar skenario langganan yang berhasil.

Serupa dengan produk sekali beli, Anda juga harus memverifikasi bahwa pembelian telah dikonfirmasi dengan benar seperti yang dijelaskan di memproses pembelian. Untuk pembelian dari penguji lisensi, pembelian akan dikembalikan dananya setelah 3 menit jika aplikasi Anda tidak mengonfirmasi pembelian, dan Anda akan menerima email tentang pembatalan. Anda juga dapat memeriksa tab Pesanan di Konsol Google Play untuk melihat apakah dana pesanan telah dikembalikan setelah 3 menit.

Periode perpanjangan

Langganan pengujian diperpanjang lebih cepat daripada langganan yang sebenarnya, dan langganan pengujian dapat diperpanjang maksimal enam kali, tidak termasuk uji coba gratis dan periode perkenalan.

Tabel berikut menunjukkan waktu perpanjangan uji untuk berbagai durasi langganan. Waktu ini merupakan perkiraan. Anda mungkin melihat beberapa variasi kecil dalam waktu yang tepat untuk suatu peristiwa. Sebagai kompensasi variasi, panggil API untuk melihat status saat ini setelah setiap tanggal habis masa berlaku langganan.

Periode langganan produksi Perpanjangan langganan uji
1 minggu 5 menit
1 bulan 5 menit
3 bulan 10 menit
6 bulan 15 menit
1 tahun 30 menit

Fitur langganan berbasis waktu, seperti uji coba gratis juga dipersingkat untuk pengujian. Tabel berikut menampilkan jangka waktu pengujian yang terkait dengan fitur langganan berbasis waktu:

Fitur Jangka waktu pengujian
Konfirmasi pembelian 5 menit
Uji coba gratis 3 menit
Jangka waktu harga perkenalan Sama dengan jangka waktu pengujian langganan
Masa tenggang (3 dan 7 hari) 5 menit
Penangguhan akun 10 menit
Jeda (1 bulan) 5 menit
Jeda (2 bulan) 10 menit
Jeda (3 bulan) 15 menit

Penawaran Uji Coba

Dengan fitur pengujian penawaran uji coba Lab Layanan Penagihan Play, penguji lisensi dapat menguji dan menggunakan uji coba gratis atau penawaran perkenalan dalam jumlah yang tidak terbatas dengan mencentang kotak "Uji coba gratis atau penawaran perkenalan" dan menerapkan perubahan. Dengan demikian, Anda tidak perlu membuat beberapa akun untuk menguji penawaran uji coba yang hanya tersedia bagi pelanggan baru.

penawaran uji coba
Gambar 5. Penawaran uji coba uji.

Perubahan harga

Anda juga dapat menggunakan Play Billing Lab dan penguji lisensi untuk menguji perubahan harga langganan tanpa memengaruhi pelanggan aktif lainnya dengan langkah-langkah berikut:

  1. Klik Kelola pada kartu Setelan langganan di Dasbor.
  2. Pilih langganan aktif yang ingin diuji.
  3. Masukkan harga baru.
  4. Centang atau hapus centang pada kotak Pilihan tidak ikut pengguna sesuai persyaratan pengujian Anda.
  5. Klik Terapkan.
menguji perubahan harga langganan
Gambar 6. Menguji perubahan harga langganan.

Setelah menerapkan perubahan, harga akan diperbarui mulai dari perpanjangan berikutnya hanya untuk penguji. Subscriber aktif lainnya tidak akan terpengaruh. Semua aturan penguji lisensi akan diterapkan ke langganan pengujian. Kemudian, penguji dapat menguji aplikasi mereka untuk proses downstream yang dipicu oleh perubahan harga, seperti notifikasi perubahan harga.

Perhatikan hal-hal berikut saat merencanakan periode pengujian:

  • Karena durasi perpanjangan yang pendek untuk penguji lisensi, ada kemungkinan migrasi harga yang dilakukan dari konsol tidak akan terdaftar untuk penguji lisensi. Untuk memastikan bahwa notifikasi dan email perubahan harga dapat diuji, developer harus menunda penagihan setidaknya satu jam setelah memicu perubahan harga.
  • Penurunan harga tidak memiliki periode notifikasi. Pengguna akan diberi tahu tentang penurunan harga segera setelah migrasi kohor. Hal ini tidak berubah saat menguji.
  • Untuk kenaikan harga, waktu notifikasi pengujian dihitung sama seperti kenaikan sebenarnya:
    • Pengguna pertama kali ditagih pada hari jadi penagihan pertama setelah periode notifikasi wajib.
    • Waktu notifikasi dihitung mundur dari tanggal penagihan pertama.
    • Notifikasi terakhir selalu 1 menit sebelum tagihan, terlepas dari periode penagihan.

Tabel berikut menampilkan periode notifikasi dan penagihan pengujian untuk beberapa periode penagihan sebenarnya:

Periode penagihan paket dasar sebenarnya Periode penagihan pengujian Periode notifikasi pengujian (wilayah yang menyatakan keikutsertaan dan ketidakikutsertaan dengan pemberitahuan 30 hari) Periode notifikasi pengujian (wilayah yang tidak ikut serta dengan pemberitahuan 60 hari)
1 minggu 5 menit 5 menit 10 menit
1 bulan 5 menit 5 menit 10 menit
3 bulan 10 menit 3 menit 6 menit
6 bulan 15 menit 2 menit 4 menit
1 tahun 30 menit 3 menit 6 menit

Kasus pengujian

Perluas bagian berikut dengan mengklik Tampilkan/Sembunyikan untuk menampilkan skenario pengujian yang harus Anda gunakan untuk memverifikasi integrasi langganan.

Menguji kode promo

Anda dapat menggunakan Konsol Google Play untuk membuat kode untuk pengujian Anda sendiri. Perlu diingat bahwa Anda hanya dapat membuat 500 kode promo per kuartal di semua produk terkelola di aplikasi.

Anda harus menguji skenario penukaran kode promo berikut:

  • Saat kode promosi dimasukkan ke dalam dialog pembelian yang diluncurkan dalam aplikasi Anda.
  • Saat kode promosi ditukarkan di aplikasi Google Play Store.
  • Saat kode promo ditukarkan di https://play.google.com/store menggunakan tombol Tukarkan di navigasi sebelah kiri.

Dalam skenario ini, Anda harus menguji kode penukaran dengan sebanyak mungkin cara. Sebaiknya pengujian berikut setidaknya harus dilakukan:

  • Penukaran sebelum aplikasi diinstal.
  • Penukaran saat aplikasi berjalan di latar depan. Harap diingat, untuk pengujian ini Anda memerlukan perangkat lain untuk melakukan pengujian menggunakan aplikasi Google Play Store. Pastikan untuk menguji penukaran dari berbagai layar di aplikasi Anda.
  • Penukaran dengan mode multi-aplikasi, yang menampilkan aplikasi Anda dan aplikasi Google Play Store secara bersamaan.

Untuk setiap pengujian, pastikan item dapat terdeteksi dengan benar dan pengguna dapat menerima notifikasi.

Menguji pengalaman pembelian di berbagai wilayah

Lab Layanan Penagihan Play dan penguji lisensi juga memungkinkan Anda menguji alur pembelian di wilayah mana pun tanpa memerlukan metode pembayaran asli untuk negara tersebut. Gunakan langkah-langkah berikut untuk menguji:

  1. Daftarkan pengguna penagihan aplikasi sebagai penguji lisensi.
  2. Login ke Lab Layanan Penagihan Play dengan pengguna yang sama.
  3. Pilih negara yang diinginkan dan terapkan perubahan di Play Billing Lab.
  4. Luncurkan alur pembelian di aplikasi yang sedang diuji.
menguji pengalaman pembelian di berbagai wilayah
Gambar 7. Uji pengalaman pembelian di berbagai wilayah.

Metode untuk menguji pembelian ini memungkinkan Anda menguji kelayakan dan pengalaman pengguna regional di wilayah mana pun, terlepas dari lokasi pengujian secara fisik.