Membuat produk terkelola

Dengan Layanan Penagihan Google Play, Anda dapat menawarkan produk dalam aplikasi yang menagih biaya 1 kali kepada pengguna, yang dikenal sebagai produk terkelola. Produk terkelola dapat mencakup item seperti barang virtual (contoh: level atau ramuan dalam game) dan layanan premium dalam aplikasi Anda di Google Play.

Penting: Kebijakan Program Developer dan biaya transaksi Google Play berlaku untuk semua produk dalam aplikasi, termasuk produk terkelola dan langganan.

Ketersediaan

Jika Anda berada di lokasi yang didukung untuk pendaftaran penjual, Anda dapat menggunakan Layanan Penagihan Google Play.

Jika Anda berada di lokasi yang didukung dan ingin memulai penggunaan fitur Layanan Penagihan Google Play di aplikasi, siapkan profil pembayaran dan tinjau dokumentasi Google Play Billing API.

Setelah Anda membuat produk terkelola, produk ini akan tersedia untuk pengguna yang menjalankan versi terbaru Google Play Store.

Izin yang diperlukan

Untuk menawarkan produk terkelola, Anda perlu menyatakan izin com.android.vending.BILLING di file manifes APK aplikasi. Jika mendistribusikan aplikasi secara global, Anda masih dapat memublikasikan aplikasi yang menggunakan izin com.android.vending.BILLING di semua negara.

Membuat produk terkelola

Membuat 1 produk terkelola

Sebelum membuat produk terkelola, pastikan Anda merencanakan ID produk dengan hati-hati. ID produk untuk aplikasi Anda harus unik dan tidak dapat diubah atau digunakan kembali setelah dibuat.
  • ID produk harus dimulai dengan huruf kecil atau angka dan hanya bisa terdiri dari huruf kecil (a-z), angka (0-9), garis bawah (_), dan titik (.)
  • Catatan: Anda tidak dapat menggunakan ID produk android.test serta semua ID produk yang dimulai dengan android.test.

Untuk membuat produk terkelola:

  1. Login ke Konsol Play.
  2. Pilih aplikasi.
  3. Di menu sebelah kiri, klik Keberadaan toko > Produk dalam aplikasi > Produk terkelola.
  4. Klik Buat Produk Terkelola.
  5. Masukkan detail produk Anda.
    • Judul: Nama pendek untuk item (maksimal 55 karakter, namun sebaiknya batasi judul hingga 25 karakter agar dapat ditampilkan dengan baik di semua konteks), seperti "Ramuan tidur".
    • Deksripsi: Deskripsi panjang untuk item (maksimal 80 karakter), seperti "Membuatmu tidur seketika".
    • Harga: Masukkan harga dalam mata uang lokal Anda atau pilih template harga.
  6. Di samping “Status”, pilih Aktif atau Tidak aktif.
    • Agar tersedia untuk dibeli, produk harus aktif dan aplikasinya harus dipublikasikan.
    • Jika Anda menggunakan akun uji, item aktif tersedia di aplikasi yang tidak dipublikasikan. Untuk mempelajari lebih lanjut, buka situs Developer Android kami.
  7. Klik Simpan.

Bahasa & terjemahan

Produk terkelola menggunakan bahasa default yang sama dengan aplikasinya. Untuk menambahkan terjemahan dalam bahasa tertentu, pilih produk terkelola, lalu klik Tambahkan terjemahanPelajari lebih lanjut cara menerjemahkan aplikasi Anda.

Membuat rangkaian beberapa produk terkelola

Untuk membuat beberapa produk terkelola dalam waktu yang sama, Anda dapat mengupload file CSV yang menyertakan detail tentang tiap produk.
File CSV menggunakan koma (,) dan titik koma (;) untuk memisahkan nilai data. Koma memisahkan nilai data utama sementara titik koma memisahkan subnilai.
Saat membuat file CSV dengan produk terkelola, tentukan sintaks CSV di baris pertama, diikuti dengan detail produk di baris selanjutnya.
Penting: Tiap item harus muncul sepenuhnya di 1 baris dalam file CSV.

Mengupload file CSV produk terkelola

  1. Login ke Konsol Play.
  2. Pilih aplikasi.
  3. Di menu sebelah kiri, klik Keberadaan toko > Produk dalam aplikasi > Produk terkelola.
  4. Klik Impor/Ekspor > Impor produk terkelola dari file CSV.
    • Untuk menimpa produk terkelola yang sudah ada di daftar produk Anda, pilih kotak centang Timpa produk yang sudah ada. Tindakan ini akan menimpa produk yang sudah ada hanya jika nilai Product ID dalam file CSV sesuai dengan Product ID dari produk terkelola yang sudah ada dalam daftar produk. Menimpa produk tidak akan menghapus produk terkelola yang tidak dimasukkan dalam CSV.
  5. Klik Telusuri file, lalu pilih file CSV Anda.

Mengekspor file CSV dari produk terkelola yang sudah ada

Jika Anda pernah membuat produk terkelola di Konsol Play, mengekspor file CSV bisa jadi cara yang baik untuk mulai membuat produk menggunakan file CSV sebagai gantinya.

  1. Login ke Konsol Play.
  2. Pilih aplikasi.
  3. Di menu sebelah kiri, klik Keberadaan toko > Produk dalam aplikasi > Produk terkelola.
  4. Klik Impor/Ekspor > Ekspor produk dalam aplikasi ke file CSV.

Melihat contoh file CSV

Berikut ini contoh sintaks CSV yang harus digunakan dan 3 contoh produk terkelola:
  • Contoh pertama menentukan judul dan deskripsi dalam 2 bahasa yang berbeda (en_US dan es_ES). Template harga menentukan harga item.
  • Contoh kedua tidak menggunakan template harga. Sebagai gantinya, contoh ini menentukan harga untuk negara default (AS). Konsol Play menggunakan nilai tukar saat ini dan pola penetapan harga yang relevan secara lokal, untuk menentukan harga secara otomatis di semua negara lain tempat aplikasi didistribusikan.
  • Contoh ketiga juga tidak menggunakan template harga. Harga item ditentukan secara manual untuk setiap negara tempat aplikasi didistribusikan.

Contoh sintaks CSV

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

Contoh produk terkelola

Contoh 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

Contoh 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

Contoh 3

invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

Nilai data untuk file CSV 

Setiap baris dalam file CSV produk terkelola dapat berisi nilai berikut, tetapi setidaknya salah satu dari nilai ini tidak ditentukan di tiap baris:  
Product ID

Menetapkan nilai ini dalam file CSV memiliki pengaruh yang sama dengan memasukkan ID Produk saat membuat produk terkelola baru.

Jika Anda menentukan Product ID yang ditetapkan ke produk terkelola yang sudah ada dalam daftar produk, dan telah mencentang kotak Timpa produk yang sudah ada di dialog "Impor Produk dalam Aplikasi", data untuk produk terkelola yang sudah ada akan ditimpa dengan nilai yang Anda tentukan dalam file CSV.

Publish State Nilai ini harus ditentukan sebagai published atau unpublished. Tindakan ini sama dengan menetapkan produk terkelola sebagai Aktif atau Tidak aktif.
Purchase Type

Nilai ini harus ditetapkan sebagai managed_by_android.

Auto Translate

Nilai ini harus ditentukan sebagai false karena terjemahan otomatis untuk detail produk terkelola tidak didukung.

Jika Anda ingin menyediakan terjemahan judul dan deskripsi produk terkelola, tentukan terjemahan ini secara tegas dalam nilai Locale.

Locale, Title, dan Description

Jika hanya menyertakan 1 bahasa untuk suatu item, Anda harus menentukan bahasa default aplikasi serta judul dan deskripsi default item:

app_default_locale; item_default_title; item_default_description;

Saat menentukan nilai Locale, Anda dapat menggunakan salah satu kode bahasa yang muncul saat menambahkan terjemahan listingan toko Anda.

Catatan: Saat menentukan nilai Title dan Description, gunakan garis miring terbalik untuk menghindari karakter titik koma (\;) dan garis miring terbalik (\\).

Jika Anda ingin menyertakan versi terjemahan dari judul dan deskripsi item, Anda harus mencantumkan bahasa, judul, dan deskripsi default, diikuti oleh bahasa, judul, dan deskripsi untuk setiap terjemahan. Dalam contoh berikut, produk terkelola menggunakan en_US (Inggris Amerika Serikat) sebagai bahasa default dan es_ES (Spanyol Spanyol) sebagai terjemahan:

en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible.

Catatan: Sebuah aplikasi memiliki bahasa default tunggal, tetapi setiap produk terkelola mempertahankan daftar terjemahannya sendiri. Meskipun bahasa pertama dalam nilai Locale setiap item harus sama di seluruh file CSV, bahasa lain antara 1 item dengan yang lain dapat berbeda-beda.

Auto Fill Prices, Country, dan Price

Anda dapat menetapkan Auto Fill Prices sebagai true atau false. Jika produk terkelola menggunakan template harga, Anda harus menetapkan Auto Fill Prices ke false, dan sebaiknya jangan menetapkan nilai untuk Price.

Catatan: Saat menentukan harga item dalam file CSV, berikan harga dalam bentuk unit mikro, yang mana 1.000.000 unit mikro setara dengan 1 unit mata uang riil.

Menggunakan harga yang sudah diisi sebelumnya

Bagian berikut menjelaskan bagaimana nilai Auto Fill Prices memengaruhi sintaks dan makna nilai Country dan Price.

Jika menetapkan Auto Fill Prices sebagai true, Anda hanya menetapkan harga default item dan tidak menyertakan nilai Country.

Misalnya, dalam kondisi berikut:

  • Bahasa default aplikasi Anda adalah en_US.
  • Harga default produk terkelola sebelum pajak adalah $1,99.
  • Anda menginginkan harga untuk negara lain diisi secara otomatis.

Anda harus menetapkan nilai Auto Fill Prices dan Price di akhir baris dalam file CSV sebagai berikut: true,1990000,

Menetapkan sendiri harga untuk tiap negara  

Jika menetapkan Auto Fill Prices sebagai false, Anda dapat menentukan serangkaian nilai Country dan Price untuk semua negara tempat aplikasi didistribusikan, termasuk negara yang sesuai dengan bahasa default aplikasi. Setiap nilai Country adalah kode negara ISO yang terdiri dari 2 huruf besar yang mewakili negara tempat aplikasi Anda didistribusikan.

Catatan: Anda harus memberikan kode negara dan harga untuk setiap negara yang ditargetkan oleh aplikasi. Untuk melihat dan mengedit daftar negara yang ditargetkan aplikasi, buka halaman Harga & distribusi di aplikasi Anda.

Setiap nilai Price mewakili biaya item dalam unit mikro mata uang yang digunakan di negara tersebut.

Misalnya, jika Anda menawarkan aplikasi dengan harga berikut (termasuk semua pajak) di negara lain:

  • R$6,99 di Brasil 
  • 129 ₽ di Rusia
  • ₹130 di India
  • Rp27.000 di Indonesia
  • $37 di Meksiko

Anda dapat menetapkan nilai Auto Fill Prices, Country, dan Price di akhir baris dalam file CSV sebagai berikut:

false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

Pricing Template ID

Jika sebuah item ditautkan ke template harga, Anda harus menetapkan Auto Fill Prices sebagai false, dan tidak boleh menetapkan nilai untuk kolom Price. Jika item tidak ditautkan ke template harga, jangan menetapkan nilai untuk Pricing Template ID. Sebagai gantinya, tetapkan Auto Fill Prices, Country, dan Price berdasarkan cara yang diinginkan untuk menetapkan harga produk terkelola tersebut.

Jika mengimpor file CSV dan telah mencentang kotak Timpa produk yang sudah ada di dialog "Impor Produk dalam Aplikasi", Anda dapat memperbarui link antara produk terkelola dan template harga. Untuk menautkan produk ke template harga tertentu, tetapkan nilai Pricing Template ID ke ID template harga tersebut. Untuk membatalkan link produk terkelola dari semua template harga, jangan menetapkan nilai untuk Pricing Template ID.

Anda dapat menautkan hingga 1.000 harga aplikasi atau produk terkelola ke sebuah template harga tertentu. Oleh karena itu, jangan menetapkan nilai Pricing Template ID yang sama di lebih dari 1.000 baris file CSV.

Apakah ini membantu?
Bagaimana cara meningkatkannya?