Gumawa ng in-app na produkto

Gamit ang system ng pagsingil ng Google Play, puwede kang mag-alok ng mga in-app na produktong sisingilin sa mga user nang isang beses. Puwedeng kasama sa mga in-app na produkto ang mga item na gaya ng mga virtual na produkto (halimbawa, mga level o potion sa laro) at mga premium na serbisyo sa iyong app sa Google Play.

Puwede ka ring gumawa ng subscription, na may umuulit na singil sa mga user.

Mahalaga: Nalalapat ang Mga Patakaran ng Programa para sa Developer at mga bayarin sa serbisyo ng Google Play sa lahat ng in-app na produkto, kasama ang mga one-off na produkto at subscription.

Availability

Kung ikaw ay nasa isang sinusuportahang lokasyon para sa pagpaparehistro ng merchant, puwede mong gamitin ang system ng pagsingil ng Google Play.

Kung nasa sinusuportahang lokasyon ka at gusto mong magsimulang gumamit ng mga feature ng system ng pagsingil ng Google Play sa iyong mga app, mag-set up ng profile sa mga pagbabayad at matuto tungkol sa pag-set up sa system ng pagsingil ng Google Play sa site ng Mga Developer ng Android.

Para maging available para bilhin, kailangang aktibo ang in-app na produkto at naka-target ang app nito sa bansa o rehiyon ng user. Magiging available para bilhin ang isang in-app na produkto hangga't aktibo ito, kahit na hindi naka-publish ang app nito. Kailangan mong i-deactivate ang in-app na produkto kung ayaw mo itong maging available.

Kung gumagamit ka ng pansubok na account, pumunta sa site ng Mga Developer ng Android para matuto pa tungkol sa pagsubok sa pag-integrate ng iyong Library ng Google Play Billing.

Pagkatapos mong gumawa ng in-app na produkto, magiging available ito para sa mga user na gumagamit ng pinakabagong bersyon ng Google Play Store.

Mga kinakailangang pahintulot

Para makapag-alok ng in-app na produkto, kailanganin mong ideklara ang pahintulot na com.android.vending.BILLING sa APK manifest file ng iyong app. Kung ipinapamahagi mo ang iyong app sa buong mundo, puwede ka pa ring mag-publish ng mga app na gumagamit ng pahintulot na com.android.vending.BILLING sa lahat ng bansa.

Gumawa ng mga in-app na produkto

Gumawa ng isang in-app na produkto

Bago gumawa ng produkto, tiyaking planuhin nang mabuti ang iyong mga product ID. Kailangang natatangi ng mga product ID para sa iyong app, at hindi na mababago o muling magagamit ang mga ito kapag nagawa na.

• Dapat magsimula ang mga Product ID sa isang numero o lowercase na titik, at puwedeng maglaman ang mga ito ng mga numero (0-9), lowercase na titik (a-z), underscore (_), at tuldok (.).
• Hindi mo puwedeng baguhin o gamitin ulit ang isang product ID pagkatapos magawa ang produkto.
• Tandaan: Hindi magagamit ang product ID na android.test, pati ang lahat ng product ID na nagsisimula sa android.test.

Para gumawa ng in-app na produkto, gawin ang mga sumusunod na hakbang:

1. Buksan ang Play Console.
2. Pumunta sa page na Mga in-app na produkto (Mag-monetize > Mga produkto > Mga in-app na produkto).
3. I-click ang Gumawa ng produkto.
4. Ilagay ang mga detalye ng iyong produkto.
   • Product ID: Isang natatanging ID para sa iyong in-app na produkto.
   • Pamagat: Isang maikling pangalan ng item (hanggang 55 character, pero inirerekomenda naming limitahin sa 25 character ang mga pamagat para maipakita nang maayos ang mga ito sa lahat ng konteksto), tulad ng "Pampatulog."
   • Paglalarawan: Mahabang paglalarawan ng item (hanggang 200 character), tulad ng "Mabilis na napapatulog ang mga nilalang."
   • Icon: Natatangi at tumpak na larawan para sa iyong produkto. Huwag magsama ng text, mga promosyon, o branding. Ipapakita ang icon ng iyong produkto sa listing ng store mo at sa proseso ng pagbili.
     • 32-bit na PNG
     • 512 x 512 pixels
     • Hanggang 1 MB
   • Presyo: Maglagay ng presyo sa iyong lokal na currency o pumili ng template ng pagpepresyo.
   • Maramihan: Payagan ang maramihang pag-check out para sa produktong ito. Makakabili ang mga user ng maraming bilang hangga't pasok ito sa threshold ng kanilang bansa o rehiyon. Tandaan ang sumusunod na impormasyon:
     • Para ma-configure ang pag-check out ng maraming item sa Play Console, kailangan ng iyong app ang Library ng Google Play Billing 4.0. Pumunta sa site ng Mga Developer ng Android para alamin kung paano i-integrate ang Library ng Google Play Billing sa iyong app.
     • Hindi available sa ilang bansa o rehiyon ang maramihang pag-check out.
     • Sa karamihan ng mga bansa o rehiyon kung saan available ang maramihang pag-checkout, humigit-kumulang USD 100 ang threshold ng presyo ng SKU. Para payagan ang maramihang pag-check out, kakailanganin mong i-adjust ang presyo (bago ilapat ang buwis) nang mas mababa sa threshold sa bawat bansa o rehiyon.
   • Eksklusibo sa Play Points: Gawing sa Google Play Points lang available ang iyong produkto.
5. I-save ang iyong mga pagbabago at i-click ang I-activate para gawing available sa mga user ang in-app na produkto mo.

Mga wika at pagsasalin

Ang ginagamit ng mga in-app na produkto ay ang default na wikang ginagamit din ng app ng mga ito. Para magdagdag ng mga pagsasalin sa mga partikular na wika, pumili ng in-app na produkto, at pagkatapos ay i-click ang Pamahalaan ang mga pagsasalin at ilapat ang mga gusto mong wika. Para matuto pa tungkol sa kung paano magbigay ng naka-localize na experience para sa mga user mo, tingnan ang Isalin at i-localize ang iyong app.

Gumawa ng isang batch ng maraming in-app na produkto

Para gumawa ng maraming in-app na produkto nang sabay-sabay, puwede kang mag-upload ng CSV file na naglalaman ng mga detalye tungkol sa bawat isa sa iyong mga produkto.

Ang mga CSV file ay gumagamit ng mga kuwit (,) at semicolon (;) para paghiwa-hiwalayin ang mga data value. Pinaghihiwa-hiwalay ng mga kuwit ang mga pangunahing data value, at pinaghihiwa-hiwalay ng mga semicolon ang mga sub-value.

Kapag gumagawa ka ng CSV file na may mga in-app na produkto, tukuyin ang CSV syntax sa unang row, pagkatapos ay ang mga detalye ng produkto sa mga susunod na row.

Mahalaga: Ang bawat item ay dapat lumabas sa iisang linya sa CSV file.

Mag-upload ng CSV file ng mga in-app na produkto

Para mag-upload ng CSV file, gawin ang mga sumusunod na hakbang:

1. Buksan ang Play Console.
2. Pumunta sa page na Mga in-app na produkto (Mag-monetize > Mga produkto > Mga in-app na produkto).
3. I-click ang I-import.
   • Kapag nag-import ng maraming produkto sa pamamagitan ng pag-upload ng CSV file, mao-overwrite lang ang mga kasalukuyang produkto kung ang value ng isang Product ID sa CSV file ay tumutugma sa Product ID ng isang kasalukuyang in-app na produkto sa listahan ng produkto. Hindi made-delete ang mga in-app na produktong hindi kasama sa CSV kapag na-overwrite ang isang produkto.
4. I-drop ang iyong CSV file para i-upload ito o i-click ang I-upload.

Mag-export ng CSV file ng mga kasalukuyang in-app na produkto

Para mag-export ng CSV file, gawin ang mga sumusunod na hakbang:

1. Buksan ang Play Console.
2. Pumunta sa page na Mga in-app na produkto (Mag-monetize > Mga produkto > Mga in-app na produkto).
3. I-click ang Mag-export.

Tumingin ng halimbawa ng CSV file

Narito ang isang halimbawa ng CSV syntax na gagamitin at tatlong halimbawa ng mga in-app na produkto:

• Tinutukoy ng unang halimbawa ang isang pamagat at paglalarawan sa dalawang magkaibang wika (en_US at es_ES). Tinutukoy ng template ng pagpepresyo ang presyo ng item.
• Hindi gumagamit ng template ng pagpepresyo ang pangalawang item. Sa halip, tumutukoy ito ng presyo para sa default na bansa (US). Gumagamit ang Play Console ng mga kasalukuyang exchange rate at pattern sa pagpepresyo na may lokal na kaugnayan para awtomatikong itakda ang mga presyo sa lahat ng iba pang bansa kung saan ipinapamahagi ang app.
• Hindi rin gumagamit ng template ng pagpepresyo ang pangatlong item. Manual na tinutukoy ang presyo ng item para sa bawat bansa kung saan ipinamamahagi ang app.

Halimbawa ng CSV syntax

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

Mga halimbawa ng in-app na produkto

Halimbawa 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

Halimbawa 2

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

Halimbawa 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,

Mga data value para sa mga CSV file

Ang bawat row sa isang CSV file ng mga in-app na produkto ay puwedeng maglaman ng mga sumusunod na value, pero hindi tinukoy ang kahit isa lang sa mga value na ito sa bawat row:

Product ID	Magkapareho lang ang epekto ng pagtatakda ng value na ito sa CSV file at ang paglalagay ng Product ID kapag gumagawa ng bagong in-app na produkto. Kung tutukoy ka ng Product ID na nakatalaga sa isang in-app na produktong kasalukuyan nang nasa listahan ng produkto, ang data para sa kasalukuyang in-app na produkto ay mao-overwrite ng mga value na tutukuyin mo sa CSV file.
Publish State	Dapat itakda ang value na ito sa published o unpublished. Kapareho ito ng pagtatakda ng in-app na produkto bilang Aktibo o Hindi Aktibo.
Purchase Type	Ang value na ito ay dapat itakda sa managed_by_android.
Auto Translate	Dapat itakda ang value na ito sa false dahil hindi sinusuportahan ang awtomatikong pagsasalin ng mga detalye ng in-app na produkto. Kung gusto mong magbigay ng mga pagsasalin ng pamagat at paglalarawan ng isang in-app na produkto, tahasang tukuyin ang mga pagsasalin na ito sa value na Locale.
Locale, Title, at Description	Kung magsasama ka lang lokalidad para sa isang item, dapat mong tukuyin ang default na lokalidad ng iyong app at ang default na pamagat at paglalarawan ng item: app_default_locale; item_default_title; item_default_description; Kapag itinatakda ang value na Locale, magagamit mo ang alinman sa mga code ng wika na lalabas kapag nagdaragdag ng mga pagsasalin ng iyong listing ng store. Tandaan: Kapag tinutukoy ang mga value na Title at Description, gumamit ng mga backslash para i-escape ang mga character na semicolon (\;) at backslash (\\). Kung gusto mong magsama ng mga naisaling bersyon ng pamagat at paglalarawan ng item, dapat mong ilista ang default na lokalidad, pamagat, at paglalarawan, pagkatapos ay ang mga lokalidad, pamagat, at paglalarawan para sa bawat pagsasalin. Sa sumusunod na halimbawa, ginagamit ng in-app na produkto ang en_US (United States English) bilang default na lokalidad at ang es_ES (Spain Spanish) bilang pagsasalin: en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible. Tandaan: Naglalaman ng iisang default na wika ang isang app, pero nagpapanatili ng sariling listahan ng mga pagsasalin ang bawat in-app na produkto. Bagama't ang unang lokalidad sa value na Locale ng bawat item ay pare-pareho dapat sa buong CSV file, posibleng magkakaiba ang lokalidad sa bawat item.
Auto-Fill Prices, Country, at Price	Puwede mong itakda ang Auto-fill prices sa true o false. Kung gumagamit ng template ng pagpepresyo ang isang in-app na produkto, dapat mong itakda ang Auto-fill prices sa false, at hindi ka dapat magtakda ng value para sa Price. Tandaan: Kapag tinukoy mo ang presyo ng isang item sa isang CSV file, magbigay ng presyo sa micro-unit, kung saan ang 1,000,000 micro-unit ay katumbas ng 1 unit ng tunay na currency. Gumamit ng mga awtomatikong pinunang presyo Inilalarawan sa mga sumusunod na seksyon kung paano nakakaapekto ang value ng Auto-fill prices sa syntax at kahulugan ng mga value na Country at Price. Kung itatakda mo ang Auto-fill prices sa true, ang default na presyo lang ng item ang tutukuyin mo; hindi ka magsasama ng value na Country. Halimbawa, sa ilalim ng mga sumusunod na kundisyon: Ang default na lokalidad ng iyong app ay en_US. Ang default na presyo ng isang in-app na produkto na wala pang buwis ay USD 1.99. Gusto mong i-autofill ang mga presyo para sa iba pang bansa. Itatakda mo ang mga value ng Auto-fill prices at Price sa dulo ng isang row sa CSV file gaya ng sumusunod: true,1990000, Magtakda ng sarili mong presyo sa bawat bansa Kung sa false mo naman itatakda ang Auto-Fill Prices, puwede kang tumukoy ng serye ng mga value na country at price para sa lahat ng bansa kung saan mo ipinapamahagi ang iyong app, kasama ang bansang tumutugma sa default na lokalidad ng iyong app. Ang bawat value na country ay ang dalawang uppercase na titik na ISO country code na kumakatawan sa isang bansa kung saan ipinapamahagi ang iyong app. Tandaan: Dapat kang magbigay ng country code at presyo para sa bawat bansang tina-target ng iyong app. Para tingnan at i-edit ang listahan ng mga bansang tina-target ng iyong app, gamitin ang tab na Mga bansa/rehiyon sa page na Produksyon. Kinakatawan ng bawat value na price ang halaga ng item sa micro-units ng currency na ginagamit sa bansang iyon. Halimbawa, kung iniaalok mo ang iyong app sa mga sumusunod na presyo (kasama ang lahat ng buwis) sa ibang bansa: R$6.99 sa Brazil ₽129 sa Russia ₹130 sa India Rp 27,000 sa Indonesia $37 sa Mexico Puwede mong itakda ang mga value ng Auto-Fill Prices, Country, at Price sa dulo ng isang row sa CSV file gaya ng sumusunod: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Kung naka-link ang isang item sa isang template ng pagpepresyo, dapat mong itakda ang Auto-Fill prices sa false, at hindi ka dapat magtakda ng value para sa column na price. Kung hindi naka-link ang item sa isang template ng pagpepresyo, hindi ka dapat magtakda ng value para sa Pricing template ID. Sa halip, dapat mong itakda ang Auto-Fill prices, Country, at Price batay sa kung paano mo gustong itakda ang mga presyo ng in-app na produkto. Kung mag-i-import ka ng CSV file, puwede mong i-update ang mga link sa pagitan ng mga in-app na produkto at template ng pagpepresyo. Para i-link ang produkto sa isang partikular na template ng pagpepresyo, itakda ang value na Pricing Template ID sa ID ng template ng pagpepresyo na iyon. Para mag-unlink ng in-app na produkto sa lahat ng template ng pagpepresyo, huwag magtakda ng value para sa Pricing template ID nito. Puwede kang mag-link ng hanggang 1,000 presyo ng app o presyo ng in-app na produkto sa isang partikular na template ng pagpepresyo. Samakatuwid, huwag tukuyin ang parehong value na Pricing template ID sa mahigit 1,000 row ng isang CSV file.
Uri ng Karapatan sa Pag-withdraw ng EEA	Kung nagpapamahagi ka sa mga user sa European Economic Area (EEA), dapat mong itakda ang value dito para sa DIGITAL_CONTENT o SERVICE.
Mga Mas Mababang Rate ng VAT	Posibleng kwalipikado ka para sa mga mas mababang rate ng VAT kung nagbebenta ka ng mga digital na balita, magazine, pahayagan, libro, video, musika, audio, o audiobook sa iba't ibang bansa o rehiyon. Para sa mga mas mababang rate, susundin ng mga value sa field na ito ang format na ito: CountryCode;VATRate; Dapat sundan ng semicolon ang bawat pares ng bansa o rate bago magdagdag ng bagong pares ng bansa o rate. Halimbawa: CA;BOOKS_1 para magtakda ng mas mababang rate para sa tier 1 sa Books para sa Canada. FR;NEWS_1; GR;NEWS_2 para magtakda ng mas mababang rate para sa tier 1 sa News para sa France at mas mababang rate para sa tier 2 sa News para sa Greece. Puwedeng itakda ang mga tier bilang BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (uppercase o lowercase).
Mga buwis para sa komunikasyon at libangan	Kung gusto mong mangolekta ng mga naaangkop na buwis sa komunikasyon at libangan, dapat mong tukuyin na produkto para sa streaming ang iyong app o produkto at itakda ang field na ito bilang ELIGIBLE. O kaya, kung hindi, iwanang walang laman lang ang field. Kasalukuyang US lang ang bansang pinapayagan para sa ganitong uri ng buwis. Palaging nakatakda ang value ng field na ito bilang: CountryCode;Eligibility;Rate Halimbawa: US;ELIGIBLE;VIDEO_RENTAL Kung kwalipikado, puwede mong itakda ang field ayon sa mga sumusunod na kategorya: VIDEO_RENTAL para sa pag-stream ng video - subscription, rental, o pay-per-view VIDEO_SALES para sa pag-stream ng video - pagbebenta VIDEO_MULTI_CHANNEL para sa pag-stream ng video - multi-channel AUDIO_RENTAL para sa pag-stream ng audio - mga subscription o rental AUDIO_SALESpara sa pag-stream ng audio - pagbebenta AUDIO_MULTI_CHANNEL para sa pag-stream ng audio - multi-channel