Membuat produk dalam aplikasi

Dengan menggunakan sistem penagihan Google Play, Anda dapat menawarkan produk dalam aplikasi yang akan menagih biaya satu kali kepada pengguna. 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 biaya layanan Google Play berlaku untuk produk dalam aplikasi 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 pelajari cara menyiapkan sistem penagihan Google Play di situs Android Developers.

Agar tersedia untuk dibeli, produk dalam aplikasi harus aktif dan aplikasinya harus ditargetkan ke negara atau wilayah pengguna. Produk dalam aplikasi akan tersedia untuk dibeli selama produk tersebut aktif, meskipun aplikasinya tidak dipublikasikan. Anda harus menonaktifkan produk dalam aplikasi jika tidak ingin produk tersebut tersedia.

Jika Anda menggunakan akun pengujian, buka situs Android Developers untuk mempelajari pengujian integrasi Google Play Billing Library lebih lanjut.

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 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 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 dapat terdiri dari angka (0-9), huruf kecil (a-z), garis bawah (_), dan titik (.).
• Anda tidak dapat mengubah atau menggunakan kembali suatu 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, lakukan langkah-langkah berikut:

1. Buka Konsol Play.
2. Buka halaman Produk dalam aplikasi (Monetisasi > Produk > Produk dalam aplikasi).
3. Klik Buat produk.
4. 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), misalnya "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
     • 512x512 piksel
     • Hingga 1 MB
   • Harga: Masukkan harga dalam mata uang lokal Anda atau pilih template harga.
   • multikuantitas: Izinkan checkout multikuantitas untuk produk ini. Pengguna akan dapat membeli dalam multikuantitas sesuai dengan nilai minimum untuk negara atau wilayah mereka. Perhatikan informasi berikut:
     • Untuk mengonfigurasi checkout multikuantitas di Konsol Play, aplikasi Anda memerlukan Google Play Billing Library 4.0. Kunjungi situs Android Developers untuk mempelajari cara mengintegrasikan Google Play Billing Library ke dalam aplikasi Anda.
     • Checkout multikuantitas tidak tersedia di beberapa negara atau wilayah.
     • Di sebagian besar negara atau wilayah tempat checkout multikuantitas tersedia, nilai minimum harga SKU adalah sekitar US$100. Untuk mengizinkan checkout multikuantitas, Anda harus menyesuaikan harga (sebelum pajak) menjadi di bawah nilai minimum di setiap negara atau wilayah.
   • Eksklusif untuk Play Points: Buat produk Anda hanya tersedia di Google Play Points.
5. Simpan perubahan Anda, lalu klik Aktifkan untuk membuat produk dalam aplikasi Anda tersedia bagi pengguna.

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. Untuk mempelajari lebih lanjut cara memberikan pengalaman yang dilokalkan bagi pengguna, lihat Menerjemahkan dan melokalkan aplikasi.

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 berikutnya.

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

Mengupload file CSV produk dalam aplikasi

Untuk mengupload file CSV, lakukan langkah-langkah berikut:

1. Buka Konsol Play.
2. Buka halaman Produk dalam aplikasi (Monetisasi > Produk > Produk dalam aplikasi).
3. 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.
4. Lepas file CSV Anda yang akan diupload atau klik Upload.

Mengekspor file CSV dari produk dalam aplikasi yang sudah ada

Untuk mengekspor file CSV, lakukan langkah-langkah berikut:

1. Buka Konsol Play.
2. Buka halaman Produk dalam aplikasi (Monetisasi > Produk > Produk dalam aplikasi).
3. 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 Product ID yang ditetapkan ke produk dalam aplikasi yang sudah ada dalam daftar produk, data untuk produk dalam aplikasi yang sudah ada akan 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 satu 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. Meski 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 prices sebagai 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 asli. 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 pajak adalah US$1,99. Anda menginginkan harga untuk negara lain terisi 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 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 tidak boleh menetapkan nilai untuk kolom Price. Jika item tidak ditautkan ke template harga, sebaiknya jangan tetapkan 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 link 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.
EEA Withdrawal Right Type	Jika mendistribusikan aplikasi ke pengguna di Wilayah Ekonomi Eropa (EEA), Anda harus menetapkan nilai di sini baik untuk DIGITAL_CONTENT maupun SERVICE.
Reduced VAT Rates	Developer yang menjual berita, majalah, koran, buku, video, musik, audio, atau buku audio digital di berbagai negara/wilayah mungkin memenuhi syarat untuk menerima pengurangan tarif PPN. Untuk tarif yang dikurangi, nilai di kolom ini akan mengikuti format berikut: CountryCode;VATRate; Setiap pasangan negara atau tarif harus diikuti titik koma sebelum menambahkan pasangan tarif atau negara baru. Contoh: CA;BOOKS_1 untuk menetapkan pengurangan tarif Buku tingkat 1 untuk Kanada. FR;NEWS_1; GR;NEWS_2 untuk menetapkan pengurangan tarif Berita tingkat 1 untuk Prancis dan pengurangan tarif Berita tingkat 2 untuk Yunani. Tingkat dapat ditetapkan sebagai BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (huruf besar atau huruf kecil).
Communications and amusement taxes	Jika ingin memungut pajak hiburan dan komunikasi negara bagian yang berlaku, Anda harus menentukan bahwa aplikasi atau produk adalah produk streaming dan menetapkan kolom ini sebagai ELIGIBLE atau, jika tidak, biarkan kolom ini kosong. Saat ini, satu-satunya negara yang diizinkan untuk jenis pajak ini adalah AS. Nilai kolom ini selalu ditetapkan sebagai: CountryCode;Eligibility;Rate Contoh: US;ELIGIBLE;VIDEO_RENTAL Jika memenuhi syarat, Anda dapat menetapkan kolom sesuai dengan kategori berikut: VIDEO_RENTAL untuk streaming video - langganan, sewa, atau bayar-per-tonton VIDEO_SALES untuk streaming video - penjualan VIDEO_MULTI_CHANNEL untuk streaming video - multisaluran AUDIO_RENTAL untuk streaming audio - langganan atau sewa AUDIO_SALES untuk streaming audio - penjualan AUDIO_MULTI_CHANNEL untuk streaming audio - multi-saluran