Membuat produk dalam aplikasi

Dengan menggunakan sistem penagihan Google Play, Anda dapat menawarkan produk dalam aplikasi yang akan menagih biaya satu kali kepada pengguna, yang dikenal sebagai produk sekali beli. Produk dalam aplikasi dapat mencakup item seperti item virtual (misalnya, level atau ramuan dalam game) dan layanan premium dalam aplikasi Anda di Google Play.

• Anda juga dapat membuat langganan, yang akan menagih pengguna secara berulang.

Penting: Kebijakan Program Developer dan tarif layanan Google Play berlaku untuk semua produk dalam aplikasi, termasuk produk sekali beli dan langganan.

Ketersediaan

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

Jika Anda berada di lokasi yang didukung dan ingin menggunakan fitur sistem penagihan Google Play di aplikasi, siapkan profil pembayaran dan tinjau dokumentasi API sistem penagihan Google Play.

Produk dalam aplikasi akan tersedia untuk pengguna yang menjalankan Google Play Store versi terbaru setelah Anda membuatnya.

Izin yang diperlukan

Untuk menawarkan produk dalam aplikasi, Anda perlu mendeklarasikan 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 dalam aplikasi

Membuat satu produk dalam aplikasi

Sebelum membuat produk, pastikan Anda merencanakan ID produk dengan saksama. ID produk untuk aplikasi Anda harus unik, dan itu tidak dapat diubah atau digunakan kembali setelah dibuat.

• ID produk harus diawali dengan angka atau huruf kecil dan hanya bisa terdiri dari huruf kecil (a-z), angka (0-9), garis bawah (_), dan titik(.).
• Anda tidak dapat mengubah atau menggunakan kembali ID produk setelah produk tersebut telah dibuat. 
• Catatan: Anda tidak dapat menggunakan ID produk android.test, serta semua ID produk yang dimulai dengan android.test.

Untuk membuat produk dalam aplikasi:

1. Buka Konsol Play dan buka halaman Produk dalam aplikasi (Monetisasi > Produk > Produk dalam aplikasi).
2. Klik Buat produk.
3. Masukkan detail produk Anda.
   • ID Produk: ID unik untuk produk dalam aplikasi Anda.
   • Judul: Nama pendek untuk item (maksimal 55 karakter, tetapi sebaiknya batasi judul hingga 25 karakter agar dapat ditampilkan dengan baik dalam semua konteks), seperti "Ramuan tidur".
   • Deskripsi: Deskripsi panjang untuk item (maksimal 200 karakter), seperti “Membuat makhluk tertidur seketika".
   • Ikon: Gambar yang unik dan akurat untuk produk Anda. Jangan sertakan teks, promosi, atau branding. Ikon produk Anda ditampilkan di listingan Play Store dan selama alur pembelian.
     • PNG 32-bit
     • 512 x 512 px
     • Hingga 1 MB
   • Harga: Masukkan harga dalam mata uang lokal Anda atau pilih template harga.
   • multikuantitas: Izinkan checkout multikuantitas untuk produk ini. Pengguna dapat membeli dalam beberapa kuantitas dalam nilai minimum negara/wilayah mereka. Perhatikan informasi berikut:
     • Untuk mengonfigurasi checkout multikuantitas di Konsol Play, aplikasi Anda memerlukan Library Layanan Penagihan Google Play 4.0. Kunjungi situs Developer Android untuk mempelajari cara mengintegrasikan Library Layanan Penagihan Google Play ke dalam aplikasi Anda
     • Checkout multikuantitas tidak tersedia di beberapa negara/wilayah.
     • Di sebagian besar negara/wilayah tempat checkout multikuantitas tersedia, nilai minimum harga SKU sekitar US$100. Untuk mengizinkan checkout multikuantitas, Anda harus menyesuaikan harga (sebelum pajak) ke nilai minimum di setiap negara/wilayah.
   • Play Points eksklusif: Buat produk Anda hanya tersedia di Google Play Points.
4. Simpan perubahan Anda, lalu klik Aktifkan untuk membuat produk dalam aplikasi Anda tersedia bagi pengguna.
   • Agar tersedia untuk dibeli, produk harus aktif dan aplikasinya harus dipublikasikan.
   • Jika Anda menggunakan akun pengujian, item aktif tersedia di aplikasi yang tidak dipublikasikan. Untuk mempelajari lebih lanjut, buka situs Developer Android.

Bahasa dan terjemahan

Produk dalam aplikasi menggunakan bahasa default yang sama dengan aplikasinya. Untuk menambahkan terjemahan dalam bahasa tertentu, pilih produk dalam aplikasi, lalu klik Kelola terjemahan dan terapkan bahasa yang diinginkan. Pelajari lebih lanjut cara menerjemahkan aplikasi Anda.

Membuat batch berisi beberapa produk dalam aplikasi

Untuk membuat beberapa produk dalam aplikasi secara bersamaan, 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 dalam aplikasi, tentukan sintaksis CSV di baris pertama, diikuti dengan detail produk di baris selanjutnya.

Penting: Tiap item harus muncul sepenuhnya di satu baris dalam file CSV.

Mengupload file CSV produk dalam aplikasi

1. Buka Konsol Play dan buka halaman Produk dalam aplikasi (Monetisasi > Produk > Produk dalam aplikasi).
2. Klik Impor.
   • Mengimpor beberapa produk dengan mengupload file CSV akan menimpa produk yang sudah ada hanya jika nilai ID Produk dalam file CSV cocok dengan ID Produk dari produk dalam aplikasi yang ada di daftar produk. Menimpa produk tidak akan menghapus produk dalam aplikasi yang tidak disertakan dalam CSV.
3. Lepas file CSV Anda yang akan diupload atau klik Upload.

Mengekspor file CSV dari produk dalam aplikasi yang sudah ada

Jika Anda telah membuat produk dalam aplikasi satu per satu di Konsol Play, mengekspor file CSV dapat menjadi cara yang tepat untuk mulai membuatnya menggunakan file CSV.

1. Buka Konsol Play dan buka halaman Produk dalam aplikasi (Monetisasi > Produk > Produk dalam aplikasi).
2. Klik Ekspor.

Melihat contoh file CSV

Berikut adalah contoh sintaksis CSV yang akan digunakan dan tiga contoh produk dalam aplikasi:

• Contoh pertama menentukan judul dan deskripsi dalam dua 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 dalam aplikasi

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 dalam aplikasi 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 dalam aplikasi baru. Jika Anda menentukan ID Produk yang ditetapkan ke produk dalam aplikasi yang sudah ada dalam daftar produk, data untuk produk dalam aplikasi yang sudah ada ditimpa dengan nilai yang Anda tentukan di file CSV.
Publish State	Nilai ini harus ditentukan sebagai published atau unpublished. Tindakan ini sama dengan menetapkan produk dalam aplikasi sebagai Aktif atau Tidak aktif.
Purchase Type	Nilai ini harus ditetapkan sebagai managed_by_android.
Auto Translate	Nilai ini harus ditetapkan sebagai false karena terjemahan otomatis untuk detail produk dalam aplikasi tidak didukung. Jika Anda ingin memberikan terjemahan judul dan deskripsi produk dalam aplikasi, tentukan terjemahan ini secara eksplisit 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 Play Store 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 dalam aplikasi 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 dalam aplikasi mempertahankan daftar terjemahannya sendiri. Meskipun bahasa pertama dalam nilai Locale setiap item harus sama di seluruh file CSV, bahasa lain antara satu 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 dalam aplikasi menggunakan template harga, Anda harus menetapkan Auto Fill Price sebagai false, dan sebaiknya jangan menetapkan nilai untuk Price. Catatan: Saat menentukan harga item dalam file CSV, berikan harga dalam bentuk unit mikro, tempat 1.000.000 unit mikro setara dengan 1 unit mata uang nyata. 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 dalam aplikasi sebelum terkena 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 Anda. Setiap nilai Country adalah kode negara ISO yang terdiri dari dua 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 oleh aplikasi, gunakan tab Negara/wilayah di halaman Produksi. 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 sebaiknya jangan menetapkan nilai untuk kolom Price. Jika item tidak ditautkan ke template harga, sebaiknya jangan menetapkan nilai untuk Pricing Template ID. Namun, Anda harus menetapkan Auto Fill Prices, Country, dan Price berdasarkan cara yang diinginkan untuk menetapkan harga produk dalam aplikasi. Jika mengimpor file CSV, Anda dapat memperbarui link antara produk dalam aplikasi dan template harga. Untuk menautkan produk ke template harga tertentu, tetapkan nilai Pricing Template ID ke ID template harga tersebut. Untuk membatalkan tautan produk dalam aplikasi dari semua template harga, jangan menetapkan nilai untuk Pricing Template ID-nya. Anda dapat menautkan hingga 1.000 harga aplikasi atau harga produk dalam aplikasi ke template harga tertentu. Oleh karena itu, jangan menetapkan nilai Pricing Template ID yang sama di lebih dari 1.000 baris file CSV.