Buat produk dalam apl

Dengan sistem pengebilan Google Play, anda boleh menawarkan produk dalam apl yang mengenakan bayaran satu kali sahaja kepada pengguna. Produk dalam apl boleh termasuk item seperti barangan maya (sebagai contoh, tahap atau posyen permainan) dan perkhidmatan premium dalam apl anda pada Google Play.

Anda juga boleh membuat langganan, yang mengenakan bayaran kepada pengguna secara berulang.

Penting: Dasar Program Pembangun dan yuran perkhidmatan Google Play terpakai pada produk dalam apl dan langganan.

Ketersediaan

Jika anda berada di lokasi yang menyokong pendaftaran pedagang, anda boleh menggunakan sistem pengebilan Google Play.

Jika anda berada di lokasi yang disokong dan mahu mula menggunakan ciri sistem pengebilan Google Play pada apl anda, sediakan profil pembayaran dan ketahui tentang penyediaan sistem pengebilan Google Play pada laman Pembangun Android.

Produk dalam apl perlu aktif dan apl produk tersebut perlu menyasarkan negara atau rantau pengguna supaya tersedia untuk pembelian. Produk dalam apl akan tersedia untuk pembelian selagi produk itu aktif, walaupun apl produk tersebut dinyahterbitkan. Anda perlu menyahaktifkan produk dalam apl jika anda tidak mahu produk itu tersedia.

Jika anda menggunakan akaun percubaan, akses laman Pembangun Android untuk mengetahui lebih lanjut tentang pengujian penyepaduan Pustaka Google Play Billing.

Selepas anda membuat produk dalam apl, ciri ini tersedia untuk pengguna yang menjalankan versi terkini Google Play Store.

Kebenaran yang diperlukan

Untuk menawarkan produk dalam apl, anda perlu mengisytiharkan kebenaran com.android.vending.BILLING dalam fail manifes APK apl anda. Jika anda mengedarkan apl anda secara global, anda masih boleh menerbitkan apl yang menggunakan kebenaran com.android.vending.BILLING di semua negara.

Buat produk dalam apl

Buat produk dalam apl tunggal

Sebelum membuat produk, pastikan anda merancang ID produk dengan teliti. ID produk untuk apl anda mestilah unik dan tidak boleh diubah atau digunakan semula selepas dibuat.

• ID Produk perlu bermula dengan nombor atau huruf kecil dan boleh mengandungi nombor (0-9), huruf kecil (a-z), garis bawah (_) dan noktah (.).
• Anda tidak boleh mengubah atau mengguna semula ID produk selepas produk dicipta.
• Nota: ID produk android.test tidak tersedia untuk digunakan di samping semua ID produk yang bermula dengan android.test.

Untuk membuat produk dalam apl, ikut langkah yang berikut:

1. Buka Play Console.
2. Akses halaman Produk dalam apl (Mengewangkan > Produk > Produk dalam apl).
3. Klik Buat produk.
4. Masukkan butiran produk anda.
   • ID Produk: ID unik untuk produk dalam apl anda.
   • Tajuk: Nama pendek item (hingga 55 aksara tetapi kami mengesyorkan agar anda mengehadkan tajuk kepada 25 aksara supaya dapat dipaparkan dengan betul dalam semua konteks). Contohnya, "Posyen tidur".
   • Perihalan: Perihalan panjang item (hingga 200 aksara). Contohnya, "Membolehkan makhluk tidur dengan segera".
   • Ikon: Imej yang unik dan tepat untuk produk anda. Jangan sertakan teks, promosi atau penjenamaan. Ikon produk anda dipaparkan pada penyenaraian gedung anda dan semasa aliran pembelian.
     • PNG 32 bit
     • 512 x 512 piksel
     • Hingga 1 MB
   • Harga: Masukkan harga dalam mata wang tempatan anda atau pilih templat harga.
   • Berbilang kuantiti: Benarkan semak keluar berbilang kuantiti untuk produk ini. Pengguna akan dapat membeli berbilang kuantiti dalam ambang negara atau rantau mereka. Ambil perhatian maklumat yang berikut:
     • Untuk mengkonfigurasikan semak keluar berbilang kuantiti dalam Play Console, apl anda memerlukan Pustaka Google Play Billing 4.0. Lawati laman Pembangun Android untuk mengetahui cara menyepadukan Pustaka Google Play Billing pada apl anda.
     • Semak keluar berbilang kuantiti tidak tersedia di sesetengah negara atau rantau.
     • Di kebanyakan negara atau rantau dengan semak keluar berbilang kuantiti tersedia, ambang harga SKU adalah sekitar USD 100. Untuk membenarkan semak keluar berbilang kuantiti, anda perlu menyelaraskan harga (sebelum cukai) untuk berada di bawah ambang di setiap negara atau rantau.
   • Eksklusif Mata Play: Jadikan produk anda tersedia hanya dalam Mata Google Play.
5. Simpan perubahan anda dan klik Aktifkan untuk menjadikan produk dalam apl anda tersedia kepada pengguna.

Bahasa dan terjemahan

Produk dalam apl menggunakan bahasa lalai yang sama seperti apl yang berkenaan. Untuk menambahkan terjemahan dalam bahasa tertentu, pilih produk dalam apl, kemudian klik Urus terjemahan dan gunakan bahasa yang dimahukan. Untuk mengetahui lebih lanjut tentang cara menyediakan pengalaman disetempatkan untuk pengguna anda, lihat Terjemahkan dan setempatkan apl anda.

Buat kelompok berbilang produk dalam apl

Untuk membuat berbilang produk dalam apl secara serentak, anda boleh memuat naik fail CSV yang merangkumi butiran tentang setiap produk anda.

Fail CSV menggunakan koma (,) dan koma bernoktah (;) untuk memisahkan nilai data. Koma memisahkan nilai data utama dan koma bernoktah memisahkan subnilai.

Apabila anda membuat fail CSV dengan produk dalam apl, tentukan sintaks CSV pada baris pertama, diikuti dengan butiran produk pada baris seterusnya.

Penting: Setiap item perlu dipaparkan sepenuhnya pada satu baris dalam fail CSV.

Muat naik fail CSV produk dalam apl

Untuk memuat naik fail CSV, lakukan langkah yang berikut:

1. Buka Play Console.
2. Akses halaman Produk dalam apl (Mengewangkan > Produk > Produk dalam apl).
3. Klik Import.
   • Mengimport berbilang produk dengan memuat naik fail CSV akan menulis ganti produk sedia ada hanya jika nilai Product ID dalam fail CSV sepadan dengan Product ID bagi produk dalam apl yang sedia ada dalam senarai produk. Menulis ganti produk tidak akan memadamkan produk dalam apl yang tidak disertakan dalam CSV.
4. Seret dan lepaskan fail CSV anda untuk memuat naik atau klik Muat naik.

Eksport fail CSV produk dalam apl yang sedia ada

Untuk mengeksport fail CSV, lakukan langkah yang berikut:

1. Buka Play Console.
2. Akses halaman Produk dalam apl (Mengewangkan > Produk > Produk dalam apl).
3. Klik Eksport.

Lihat contoh fail CSV

Yang berikut ialah contoh sintaks CSV untuk digunakan dan tiga contoh produk dalam apl:

• Contoh pertama mentakrifkan tajuk dan perihalan dalam dua bahasa yang berbeza (en_US dan ms_MY). Templat harga menentukan harga item.
• Contoh kedua tidak menggunakan templat harga. Sebaliknya, contoh ini menentukan harga untuk negara lalai (AS). Play Console menggunakan kadar pertukaran semasa dan corak penetapan harga yang berkaitan secara tempatan untuk menetapkan harga secara automatik di semua negara lain apl itu diedarkan.
• Contoh ketiga juga tidak menggunakan templat harga. Harga item ditentukan secara manual untuk setiap negara apl itu diedarkan.

Contoh sintaks CSV

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

Contoh produk dalam apl

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 fail CSV

Setiap baris dalam fail CSV produk dalam apl boleh mengandungi nilai yang berikut tetapi sekurang-kurangnya satu daripada nilai ini tidak ditakrifkan dalam setiap baris:

Product ID	Penetapan nilai ini dalam fail CSV memberikan kesan yang sama seperti memasukkan ID Produk apabila membuat produk dalam apl baharu. Jika anda menentukan Product ID yang diberikan kepada produk dalam apl yang sudah wujud dalam senarai produk, data untuk produk dalam apl yang sedia ada akan ditulis ganti dengan nilai yang anda tentukan dalam fail CSV.
Publish State	Nilai ini hendaklah ditetapkan kepada published atau unpublished. Ini adalah sama dengan menetapkan produk dalam apl sebagai Aktif atau Tidak aktif.
Purchase Type	Nilai ini mesti ditetapkan kepada managed_by_android.
Auto Translate	Nilai ini hendaklah ditetapkan kepada false kerana autoterjemahan butiran produk dalam apl tidak disokong. Jika anda mahu menyediakan terjemahan untuk tajuk dan perihalan produk dalam apl, tentukan terjemahan ini dengan jelas dalam nilai Locale.
Locale, Title dan Description	Jika anda menyertakan hanya satu tempat peristiwa untuk satu item, anda perlu menentukan tempat peristiwa lalai apl anda dan tajuk serta perihalan lalai item: app_default_locale; item_default_title; item_default_description; Apabila menetapkan nilai Locale, anda boleh menggunakan sebarang kod bahasa yang dipaparkan apabila menambahkan terjemahan penyenaraian gedung anda. Nota: Apabila menentukan nilai Title dan Description, gunakan tanda condong ke belakang untuk menggantikan aksara koma bernoktah (\;) dan tanda condong ke belakang (\\). Jika anda ingin menyertakan tajuk dan perihalan item versi yang diterjemahkan, anda perlu menyenaraikan penempatan, tajuk dan perihalan lalai, diikuti oleh penempatan, tajuk dan perihalan untuk setiap terjemahan. Dalam contoh berikut, produk dalam apl menggunakan en_US (Bahasa Inggeris Amerika Syarikat) sebagai penempatan lalai dan es_ES (Sepanyol Bahasa Sepanyol) sebagai terjemahan: en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible. Nota: Apl mengandungi bahasa lalai tunggal tetapi setiap produk dalam apl mengekalkan senarai terjemahan produk dalam apl itu sendiri. Walaupun penempatan pertama dalam nilai Locale setiap item perlu sama dalam semua fail CSV, penempatan lain mungkin berlainan untuk satu item dengan item yang lain.
Auto-Fill Prices, Country dan Price	Anda boleh menetapkan Auto-fill prices kepada true atau false. Jika produk dalam apl menggunakan templat harga, anda hendaklah menetapkan Auto-fill prices kepada false dan anda tidak boleh menetapkan nilai untuk Price. Nota::Apabila anda menentukan harga item dalam fail CSV, berikan harga dalam unit mikro, iaitu 1,000,000 unit mikro bersamaan dengan 1 unit mata wang sebenar. Gunakan harga yang diisi secara automatik Bahagian yang berikut menjelaskan cara nilai Auto-fill prices memberikan kesan kepada sintaks dan makna nilai Country dan Price. Jika anda menetapkan Auto-fill prices kepada true, anda hanya menentukan harga lalai item; tidak merangkumi nilai Country. Contohnya, di bawah syarat yang berikut: Bahasa penempatan lalai apl anda ialah en_US. Harga lalai tidak termasuk cukai produk dalam apl ialah USD 1.99. Anda mahu harga untuk negara lain diisi secara automatik. Anda perlu menetapkan nilai Auto-fill prices dan Price pada akhir baris dalam fail CSV seperti yang berikut: true,1990000, Tetapkan harga anda sendiri untuk setiap negara Jika anda menetapkan Auto-Fill Prices kepada false, anda boleh menentukan satu siri nilai Country dan Price untuk semua negara yang apl anda diedarkan termasuk negara yang sepadan dengan penempatan lalai apl anda. Setiap nilai Country ialah kod negara ISO huruf besar dua huruf yang mewakili negara tempat apl anda diedarkan. Nota: Anda perlu menyediakan kod negara dan harga untuk setiap negara yang disasarkan oleh apl anda. Untuk melihat dan mengedit senarai negara apl anda disasarkan, gunakan tab Negara / rantau pada halaman Pengeluaran. Setiap nilai price mewakili kos item dalam unit mikro bagi mata wang yang digunakan di negara tersebut. Sebagai contoh, jika anda menawarkan apl anda pada harga yang berikut (termasuk semua cukai) di negara lain: R$6.99 di Brazil ₽129 di Rusia ₹130 di India Rp 27,000 di Indonesia $37 di Mexico Anda boleh menetapkan nilai Auto-Fill Prices, Country dan Price pada akhir baris dalam fail CSV seperti berikut: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Jika item dipautkan kepada templat harga, anda hendaklah menetapkan Auto-Fill prices kepada false dan anda tidak harus menetapkan nilai untuk lajur Price. Jika item tidak dipautkan kepada templat harga, anda tidak harus menetapkan nilai untuk Pricing template ID. Sebaliknya, anda harus menetapkan Auto-Fill prices, Country dan Price berdasarkan cara anda mahu menetapkan harga produk dalam apl. Jika anda mengimport fail CSV, anda boleh mengemaskinikan pautan antara produk dalam apl dengan templat harga. Untuk memautkan produk kepada templat harga khusus, tetapkan nilai Pricing Template ID untuk ID templat harga tersebut. Untuk menyahpaut produk dalam apl daripada semua templat harga, jangan tetapkan nilai untuk Pricing Template ID produk itu. Anda boleh memautkan hingga 1,000 harga apl atau harga produk dalam apl kepada templat harga tertentu. Oleh itu, jangan tentukan nilai Pricing template ID yang sama bagi fail CSV yang melebihi 1,000 baris.
Jenis Hak Penarikan Diri EEA	Jika apl anda boleh diedarkan kepada pengguna di Kawasan Ekonomi Eropah (EEA), anda harus menetapkan nilai di sini sama ada untuk DIGITAL_CONTENT atau SERVICE.
Kadar VAT Dikurangkan	Jika anda menjual berita digital, majalah, surat khabar, buku, video, muzik, audio atau buku audio di pelbagai negara atau rantau, anda mungkin layak mendapatkan kadar VAT dikurangkan. Bagi kadar dikurangkan, nilai pada medan ini akan mengikut format ini: KodNegara; KadarVAT; Setiap pasangan negara atau kadar haruslah diikuti oleh koma bernoktah sebelum menambahkan pasangan negara atau kadar baharu. Contohnya: CA;BOOKS_1untuk menetapkan kadar dikurangkan peringkat 1 Books untuk Kanada. FR; NEWS_1; GR; NEWS_2untuk menetapkan kadar dikurangkan peringkat 1 News untuk Perancis dan kadar dikurangkan peringkat 2 News untuk Greece. Peringkat boleh ditetapkan sebagai BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (huruf besar dan huruf kecil).
Cukai komunikasi dan hiburan	Jika anda mahu mengumpulkan cukai komunikasi dan hiburan negeri yang bersesuaian, anda perlu menentukan bahawa apl atau produk anda ialah produk penstriman dan menetapkan medan ini sebagai ELIGIBLE atau jika tidak, biarkan sahaja medan ini kosong. Pada masa ini, satu-satunya negara yang dibenarkan untuk jenis cukai ini ialah AS. Nilai medan ini sentiasa ditetapkan sebagai: KodNegara;Kelayakan;Kadar Contohnya: US;ELIGIBLE;VIDEO_RENTAL Jika layak, anda boleh menetapkan medan ini menurut kategori yang berikut: VIDEO_RENTAL untuk penstriman video - langganan, sewaan atau bayar sekali tonton VIDEO_SALES untuk penstriman video - jualan VIDEO_MULTI_CHANNEL untuk penstriman video - berbilang saluran AUDIO_RENTAL untuk penstriman audio - langganan atau sewaan AUDIO_SALES untuk penstriman audio - jualan AUDIO_MULTI_CHANNEL untuk penstriman audio - berbilang saluran