Alkalmazáson belüli termék létrehozása

A Google Play számlázási rendszere segítségével olyan alkalmazáson belüli termékeket kínálhatsz, amelyek egyszeri díjat számítanak fel a felhasználóknak. Alkalmazáson belüli termék lehet többek között virtuális árucikk (például játékszintek vagy varázsitalok) vagy prémium szolgáltatás a Google Playen rendelkezésre álló alkalmazáson belül.

Lehetőséged van előfizetés létrehozására is, amelyet a rendszer ismétlődően terhel a felhasználókra.

Fontos: A Google Play Fejlesztői programszabályzata és a szolgáltatási díjak az alkalmazáson belüli termékekre és az előfizetésekre is vonatkoznak.

Rendelkezésre állás

Ha olyan helyen tartózkodsz, ahol támogatott a kereskedői regisztráció, használhatod a Google Play számlázási rendszerét.

Ha támogatott helyen tartózkodsz, és alkalmazásaidban szeretnéd használni a Google Play számlázási rendszerét, akkor állíts be fizetési profilt, és az Android fejlesztői webhelyén olvasd el, hogyan kell beállítani a Google Play számlázási rendszerét.

Ahhoz, hogy egy alkalmazáson belüli termék megvásárolható legyen, aktívnak kell lennie, az alkalmazásnak pedig a felhasználó országára vagy régiójára kell célozva lennie. Az alkalmazáson belüli termék mindaddig megvásárolható lesz, amíg aktív, még akkor is, ha az alkalmazás közzététele meg van szüntetve. Ha nem szeretnéd, hogy az alkalmazáson belüli termék kapható legyen, inaktiválnod kell.

Ha tesztfiókot használsz, keresd fel az Android fejlesztői webhelyét, ahol többet is megtudhatsz a Google Play Billing Library integrációjának teszteléséről.

Miután létrehozod az alkalmazáson belüli terméket, rendelkezésre fog állni a Google Play Áruház alkalmazás legújabb verzióját használó felhasználók számára.

Szükséges engedélyek

Ahhoz, hogy alkalmazáson belüli terméket kínálhass, deklarálnod kell a com.android.vending.BILLING engedélyt alkalmazásod APK-jának manifestjében. Ha globálisan terjeszted az alkalmazást, továbbra is közzétehetsz olyan alkalmazásokat, amelyek a com.android.vending.BILLING engedélyt használják valamennyi országban.

Alkalmazáson belüli termékek létrehozása

Egyetlen alkalmazáson belüli termék létrehozása

Mielőtt létrehoznád a terméket, gondosan tervezd meg a termékazonosítót. A termékazonosítóknak egyedinek kell lenniük az alkalmazásoknál, és létrehozásuk után nem módosíthatók vagy használhatók fel újra.

• A termékazonosítónak számmal vagy kisbetűvel kell kezdődnie, és tartalmazhat számot (0–9), kisbetűt (a–z), aláhúzásjelet (_) és pontot (.).
• A termék létrehozása után a termékazonosítót már nem módosíthatod vagy használhatod újból.
• Megjegyzés: Az android.test termékazonosító, valamint az android.test karakterlánccal kezdődő termékazonosítók nem használhatók.

Alkalmazáson belüli termék létrehozásához a következő lépéseket kell megtenned:

1. Nyisd meg a Play Console oldalát.
2. Lépj az Alkalmazáson belüli termékek oldal (Bevételszerzés > Termékek > Alkalmazáson belüli termékek) menüpontba.
3. Kattints a Termék létrehozása lehetőségre.
4. Add meg a termék adatait.
   • Termékazonosító: Az alkalmazáson belüli termék egyedi azonosítója.
   • Cím: A termék rövid neve (legfeljebb 55 karakter, de érdemes 25 karakterben maximalizálnod, hogy minden környezetben megfelelően megjelenjen) – például „Altató bájital”.
   • Leírás: Az elem hosszú leírása (legfeljebb 200 karakter) – például „Azonnal álomba szenderíti az élőlényeket”.
   • Ikon: A termék egyedi és pontos képe. Ne szerepeltess szöveget, promóciókat vagy márkaelemeket. A termékikon az áruházi adatlapon és a vásárlási folyamat során látható.
     • 32 bites PNG-fájl
     • 512 × 512 képpont
     • Legfeljebb 1 MB
   • Ár: Add meg az árat helyi pénznemben, vagy válassz árképzési sablont.
   • Több alkalmazáson belüli termék: Több alkalmazáson belüli termék vásárlásának engedélyezése ennél a terméknél. A felhasználók több alkalmazáson belüli terméket vásárolhatnak az országukban vagy régiójukban megengedett mennyiségnél. Vedd figyelembe a következőket:
     • Ha szeretnéd beállítani a több alkalmazáson belüli termék vásárlása funkciót a Play Console-ban, akkor az alkalmazásodnak a Google Play Billing Library 4.0-s verziójára van szüksége. Az Android-fejlesztőknek szóló webhelyen megtudhatod, hogyan integrálhatod a Google Play Billing Library szolgáltatást az alkalmazásodba.
     • Egyes országokban vagy régiókban nem lehet egyszerre több terméket vásárolni.
     • A legtöbb olyan országban vagy régióban, ahol rendelkezésre áll a több alkalmazáson belüli termék vásárlása funkció, a cikkszám árának küszöbértéke körülbelül 100 USD. A több alkalmazáson belüli termék vásárlásának engedélyezéséhez az egyes országokban vagy régiókban a küszöbérték alá kell csökkentened az (adózás előtti) árat.
   • Kizárólag Play Points: A termék kizárólag a Google Play Points programban áll rendelkezésre.
5. Mentsd a módosításokat, és kattints az Aktiválás gombra, hogy az alkalmazáson belüli termék rendelkezésre álljon a felhasználók számára.

Nyelvek és fordítások

Az alkalmazáson belüli termékek ugyanazt az alapértelmezett nyelvet használják, mint az adott alkalmazás. Ha szeretnél más nyelvű fordításokat hozzáadni, válaszd ki az egyik alkalmazáson belüli terméket, majd kattints a Fordítások kezelése elemre, és válaszd ki a kívánt nyelveket. Ha további információra van szükséged arról, hogyan biztosíthatsz lokalizált élményt a felhasználóknak, lásd az Alkalmazás fordítása és lokalizálása című cikket.

Több alkalmazáson belüli termékből álló csomag létrehozása

Ha szeretnél egyszerre több alkalmazáson belüli terméket létrehozni, ezt megteheted az egyes termékek adatait tartalmazó CSV-fájl feltöltésével.

A CSV-fájlokban vesszők (,) és pontosvesszők (;) különítik el egymástól az adatértékeket. A vesszők az elsődleges adatértékeket, a pontosvesszők pedig az alértékeket különítik el egymástól.

Alkalmazáson belüli termékeket tartalmazó CSV-fájl létrehozásakor az első sorban a CSV szintaxisát add meg, az azt követő sorokban pedig a termékek adatait.

Fontos: Mindegyik elemnek egy-egy külön sorban kell szerepelnie a CSV-fájlban.

Alkalmazáson belüli termékeket tartalmazó CSV-fájl feltöltése

CSV-fájl feltöltéséhez kövesd a következő lépéseket:

1. Nyisd meg a Play Console oldalát.
2. Lépj az Alkalmazáson belüli termékek oldal (Bevételszerzés > Termékek > Alkalmazáson belüli termékek) menüpontba.
3. Kattints az Importálás elemre.
   • A több termék CSV-fájl feltöltésén keresztül történő importálása csak akkor írja felül a meglévő termékeket, ha a CSV-fájlban szereplő Product ID termékazonosító egyezik a terméklistán szereplő valamelyik meglévő alkalmazáson belüli termék Product ID termékazonosítójával. A termék felülírása nem törli azokat az alkalmazáson belüli termékeket, amelyek nem szerepelnek a CSV-fájlban.
4. A feltöltéshez húzd át a CSV-fájlt, vagy kattints a Feltöltés lehetőségre.

Meglévő alkalmazáson belüli termékeket tartalmazó CSV-fájl exportálása

CSV-fájl exportálásához kövesse a következő lépéseket:

1. Nyisd meg a Play Console oldalát.
2. Lépj az Alkalmazáson belüli termékek oldal (Bevételszerzés > Termékek > Alkalmazáson belüli termékek) menüpontba.
3. Kattints az Exportálás gombra.

Példa CSV-fájlra

Az alábbiakban bemutatunk egy példát a CSV-szintaxisra, valamint három példát az alkalmazáson belüli termékekre:

• Az első példa két különböző nyelven (en_US és es_ES) határozza meg a címet és a leírást. A termék árát árképzési sablon határozza meg.
• A második példa nem árképzési sablont használ, hanem az alapértelmezett országra (US) vonatkozóan határozza meg az árat. A Play Console az aktuális árfolyam és a helyileg releváns árképzési minták alapján adja meg automatikusan az árat az összes többi olyan országban, ahol az alkalmazást terjesztik.
• A harmadik példa sem használ árképzési sablont; itt a termék árának meghatározása manuálisan történik mindegyik olyan ország esetében, ahol az alkalmazást terjesztik.

Példa CSV-szintaxisra

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

Példák alkalmazáson belüli termékekre

1. példa

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

2. példa

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

3. példa

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,

A CSV-fájlok adatértékei

Az alkalmazáson belüli termékeket tartalmazó CSV-fájl egyes sorai a következő értékeket tartalmazhatják, de legalább az egyik érték definiálatlanul marad mindegyik sorban:

Termékazonosító	Ha megadod ezt az értéket a CSV-fájlban, annak ugyanaz lesz a hatása, mintha termékazonosítót adnál meg az új alkalmazáson belüli termék létrehozásakor. Ha a terméklistán már szereplő kezelt termékhez hozzárendelt Product ID termékazonosítót adsz meg, akkor a CSV-fájlban általad megadott értékek felülírják a meglévő kezelt termékre vonatkozó adatokat.
Publish State (közzététel állapota)	Ezt published (közzétéve) vagy unpublished (közzététel visszavonva) értékkel kell definiálni. Ez az érték ugyanaz, mint az alkalmazáson belüli termékre vonatkozó Active (aktív), illetve Inactive (inaktív) érték.
Vásárlás típusa	Ennek az értéke managed_by_android (az Android rendszer által felügyelt) kell legyen.
Auto Translate (automatikus fordítás)	Ezt false (hamis) értékre kell beállítani, mert az alkalmazáson belüli termékek részleteinek automatikus fordítása nem támogatott. Ha szeretnéd biztosítani az alkalmazáson belüli termék címének és leírásának a fordítását, akkor a fordításokat kifejezetten a Locale (nyelv- és országkód) értéken belül kell megadni.
Locale (nyelv- és országkód), Title (cím) és Description (leírás)	Ha csak egyetlen nyelv- és országkódot adsz meg a termékre vonatkozóan, akkor meg kell adnod az alkalmazás alapértelmezés szerinti nyelv- és országkódját, valamint alapértelmezés szerinti címét és leírását: app_default_locale; item_default_title; item_default_description; A Locale érték megadásakor az áruházi adatlap fordításainak hozzáadásakor megjelenő bármelyik nyelvkódot használhatod. Megjegyzés: A Title és a Description értékeinek meghatározásakor fordított törtvonallal oldhatod fel a pontosvessző (\;) és a fordított törtvonal karaktert (\\). Ha szeretnéd a CSV-fájlba belefoglalni a termék címének és leírásának lefordított verzióit, akkor fel kell tüntetned az alapértelmezett nyelv- és országkódot, címet és leírást, és ezek után kell megadnod az egyes fordítások nyelv- és országkódját, továbbá a lefordított címet és leírást. A következő példában az alkalmazáson belüli termék alapértelmezett nyelv- és országkódja az en_US (amerikai egyesült államokbeli angol), a fordításé pedig az es_ES (spanyolországi spanyol): en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible. Megjegyzés: Az alkalmazások egyetlen alapértelmezett nyelvet tartalmaznak, de minden alkalmazáson belüli termék fenntartja a saját fordítások listáját. Bár az egyes termékek Locale értékénél szereplő első nyelv- és országkódnak ugyanannak kell lennie az egész CSV-fájlban, a többi nyelv- és országkód eltérhet egymástól.
Auto-Fill prices (árak automatikus kitöltése), Country (ország) és Price (ár)	Az Auto-Fill prices értéke true (igaz) vagy false (hamis) lehet. Ha a kezelt termék árképzési sablont használ, akkor az Auto-Fill prices esetében célszerű a false értéket megadnod; ilyenkor ne állítsd be a Price értékét. Megjegyzés: Amikor megadod a termék árát a CSV-fájlban, akkor használj mikroegységeket – 1 000 000 mikroegység a valós pénznem 1 egységének felel meg. Automatikusan kitöltött árak használata A következő szakaszok azt ismertetik, hogy miként befolyásolja az Auto-fill prices értéke a Country és a Price értékek szintaxisát és jelentését. Ha az Auto-fill prices értékénél a true beállítást használod, akkor így csak a termék alapértelmezett árát adod meg – Country értéket nem. Például az alábbi feltételek esetén: alkalmazásod alapértelmezett nyelv- és országkódja az en_US; az alkalmazáson belüli termék alapértelmezett, adót nem tartalmazó ára 1,99 USD; a rendszer automatikusan adja meg a többi országra vonatkozó árat; az Auto-fill prices és a Price értékét a CSV-fájl adott sorának végén a true,1990000, karakterlánccal add meg. A saját ár országonkénti megadása Ha az Auto-Fill Prices esetében inkább a false értéket használod, akkor egy sor country és price értéket adhatsz meg az összes olyan országra vonatkozóan, ahol az alkalmazásodat terjeszted, így például az alkalmazás alapértelmezett nyelv- és országkódjának megfelelő országra vonatkozóan is. Mindegyik country érték az alkalmazás terjesztésének helye szerinti országot jelölő, kétbetűs, nagybetűvel szedett ISO-országkód. Megjegyzés: Az alkalmazásod által célzott mindegyik országra vonatkozóan meg kell adnod az országkódot és az árat. Az alkalmazásod által célzott országok listájának megtekintéséhez és szerkesztéséhez használd az Országok / régiók lapot az Éles oldalon. Mindegyik price érték az adott országban használt pénznem mikroegységeiben megadva tartalmazza a termék árát. Ha például a következő árakon kínálod alkalmazásodat (mindenféle adó nélkül) más országokban: 6,99 BRL Brazíliában, 129 RUB Oroszországban, 130 INR Indiában, 27 000 IDR Indonéziában, 37 MXN Mexikóban, akkor a következőképpen adhatod meg CSV-fájl egy sorának végén az Auto-Fill Prices, a Country és a Price értékeit: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID (árképzési sablon azonosítója)	Ha a termék árképzési sablonhoz van hozzárendelve, az Auto-Fill prices esetében célszerű a false értéket beállítanod, a price oszlop értékét pedig üresen hagynod. Ha a termék nincs hozzárendelve árképzési sablonhoz, nem kell beállítanod a Pricing template ID (árképzési sablon) oszlop értékét. Ehelyett az Auto-Fill prices, a Country és a Price oszlop értékét add meg aszerint, ahogyan a kezelt termék árait kívánod megadni. Ha CSV-fájlt importálsz, frissítheted az alkalmazáson belüli termékek és az árképzési sablonok közötti kapcsolatokat. Ha szeretnéd összekapcsolni a terméket valamilyen árképzési sablonnal, akkor a Pricing Template ID értékét állítsd az adott árképzési sablon azonosítójára. Ha az összes árképzési sablonról le szeretnéd választani az alkalmazáson belüli terméket, akkor ne állíts be értéket a termék Pricing template ID oszlopában. Az egyes árképzési sablonokhoz legfeljebb 1000 alkalmazáshoz vagy alkalmazáson belüli termékhez tartozó ár kapcsolható. Ezért a CSV-fájlnak legfeljebb 1000 sorában add meg ugyanazt a Pricing template ID értéket.
EGT-beli elállási jog típusa	Ha az Európai Gazdasági Térség (EGT) felhasználóinak terjesztesz, akkor itt kell megadnod a digitális tartalomra (DIGITAL_CONTENT) vagy a szolgáltatásra (SERVICE) vonatkozó értéket.
Csökkentett áfakulcs	Ha különféle országokban vagy régiókban értékesítesz digitális híreket, folyóiratokat, újságokat, könyveket, videókat, zenéket, hangfájlokat vagy hangoskönyveket, akkor csökkentett áfakulcsokra lehetsz jogosult. A csökkentett díjak esetében a mezőben szereplő értékek a következő formátumúak: CountryCode;VATRate; Új ország vagy díj pár megadása előtt minden ország vagy díj párt pontosvesszőnek kell követnie. Példák: CA;BOOKS_1 – a könyvek 1. szintje csökkentett díjának beállítása Kanadára vonatkozóan. FR;NEWS_1; GR;NEWS_2 – a hírek 1. szintje csökkentett díjának beállítása Franciaországra, és a hírek 2. szintje csökkentett díjának beállítása Görögországra vonatkozóan. A szintek a következőképpen állíthatók be: BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (nagy- vagy kisbetű).
Kommunikációs és szórakoztatóipari adók	Ha szeretnéd beszedni a vonatkozó állami telekommunikációs és szórakoztatóipari adókat, akkor meg kell adnod, hogy az alkalmazásod vagy terméked streamelési termék, és a mező értékeként az ELIGIBLE karakterláncot kell megadnod; egyéb esetben hagyd üresen a mezőt. Jelenleg csak az Egyesült Államokban engedélyezett az ilyen típusú adó. Ennek a mezőnek az értéke mindig a következő lesz: CountryCode;Eligibility;Rate Példák: US;ELIGIBLE;VIDEO_RENTAL Ha megfelelsz a feltételeknek, akkor a következő kategóriák szerint állíthatod be a mezőt: VIDEO_RENTAL – videóstreameléshez: előfizetés, kölcsönzés vagy megtekintésenként fizetett VIDEO_SALES – videóstreameléshez: értékesítés VIDEO_MULTI_CHANNEL – videóstreameléshez: többcsatornás AUDIO_RENTAL – hangstreameléshez: előfizetés vagy kölcsönzés AUDIO_saleS – hangstreameléshez: értékesítés AUDIO_MULTI_CHANNEL – audiostreameléshez: többcsatornás