Tworzenie produktu w aplikacji

Dzięki systemowi rozliczeniowemu Google Play możesz oferować produkty w aplikacji, które pobierają od użytkowników jednorazowe opłaty. Produktami w aplikacji w Google Play mogą być na przykład wirtualne towary (takie jak poziomy w grze czy mikstury) lub usługi płatne.

Możesz też utworzyć subskrypcję, która będzie cyklicznie pobierać opłaty od użytkowników.

Ważne: produkty w aplikacji i subskrypcje podlegają zasadom programu dla deweloperów w Google Play oraz opłatom za obsługę.

Dostępność

Jeśli Twoja lokalizacja obsługuje rejestrację sprzedawców, możesz korzystać z systemu rozliczeniowego Google Play.

Jeśli Twoja lokalizacja obsługuje system rozliczeniowy Google Play i chcesz zacząć go używać w swoich aplikacjach, skonfiguruj profil płatności i dowiedz się, jak skonfigurować system rozliczeniowy Google Play (informacje na ten temat znajdziesz na stronie dla deweloperów aplikacji na Androida).

Aby można było kupić produkt w aplikacji, musi on być aktywny, a zawierająca go aplikacja musi być kierowana na kraj lub region użytkownika. Produkt w aplikacji można kupić, dopóki jest aktywny, nawet jeśli publikacja zawierającej go aplikacji zostałacofnięta. Jeśli nie chcesz, aby produkt w aplikacji był dostępny, musisz go dezaktywować.

Jeśli używasz konta testowego, wejdź na stronę dla deweloperów aplikacji na Androida, aby dowiedzieć się więcej o testowaniu integracji Biblioteki płatności w Google Play.

Gdy utworzysz produkt w aplikacji, będzie on dostępny dla użytkowników, którzy mają najnowszą wersję Sklepu Google Play.

Wymagane uprawnienia

Aby oferować produkt w aplikacji, w pliku manifestu pakietu APK musisz zadeklarować uprawnienie com.android.vending.BILLING. Jeśli rozpowszechniasz aplikację globalnie, nadal możesz publikować aplikacje korzystające z uprawnienia com.android.vending.BILLING we wszystkich krajach.

Tworzenie produktów w aplikacji

Tworzenie pojedynczego produktu w aplikacji

Zanim zaczniesz tworzyć produkty, starannie przygotuj ich identyfikatory. Każda aplikacja musi mieć unikalne identyfikatory, których po utworzeniu nie będzie można zmienić ani użyć ponownie.

• Identyfikator produktu musi zaczynać się od cyfry lub małej litery i może zawierać tylko cyfry (0–9), małe litery (a–z), podkreślenia (_) i kropki (.).
• Po utworzeniu produktu nie możesz zmienić ani wykorzystać ponownie jego identyfikatora.
• Uwaga: nie można używać identyfikatora produktu android.test ani żadnych identyfikatorów zaczynających się od android.test.

Aby utworzyć produkt w aplikacji, wykonaj te czynności:

1. Otwórz Konsolę Play.
2. Wejdź na stronę Produkty w aplikacji (Zarabianie > Produkty > Produkty w aplikacji).
3. Kliknij Utwórz produkt.
4. Wpisz szczegóły produktu.
   • Identyfikator produktu: unikalny identyfikator produktu w aplikacji.
   • Tytuł: krótka nazwa elementu (maksymalnie 55 znaków, ale zalecamy użycie nie więcej niż 25 znaków, aby tytuł zawsze wyświetlał się prawidłowo), np. „Eliksir snu”.
   • Opis: długi opis produktu (maksymalnie 200 znaków), np. „Powoduje, że istota natychmiast zasypia”.
   • Ikona: niepowtarzalny i dokładny obraz produktu. Nie dodawaj tekstu, informacji o promocjach ani oznaczeń marki. Ikona produktu jest widoczna na stronie aplikacji i w trakcie procesu zakupu.
     • 32-bitowy PNG
     • 512 x 512 pikseli
     • Do 1 MB
   • Cena: podaj cenę w walucie lokalnej lub wybierz szablon cen.
   • Wiele sztuk: zezwól na kupno jednocześnie wielu sztuk tego samego produktu. Użytkownicy będą mogli kupować jednocześnie wiele sztuk tego samego produktu w ramach określonego dla kraju lub regionu progu. Uwaga:
     • Aby w Konsoli Play można było skonfigurować kupno jednocześnie wielu sztuk tego samego produktu, aplikacja musi korzystać z Biblioteki płatności w Google Play 4.0. Aby dowiedzieć się, jak zintegrować Bibliotekę płatności w Google Play z aplikacją, odwiedź stronę dla deweloperów aplikacji na Androida.
     • W niektórych krajach i regionach nie można jednocześnie kupić wielu sztuk tego samego produktu.
     • W większości krajów i regionów, w których dostępna jest możliwość jednoczesnego zakupu wielu sztuk tego samego produktu, próg cenowy wynosi około 100 USD. Aby umożliwić kupno jednocześnie wielu sztuk produktu, musisz ustalić cenę (przed opodatkowaniem) poniżej progu w każdym kraju lub regionie.
   • Tylko w Play Points: udostępniaj swój produkt tylko w Google Play Points.
5. Aby udostępnić użytkownikom swój produkt w aplikacji, zapisz zmiany i kliknij Aktywuj.

Języki i tłumaczenia

Produkty w aplikacji domyślnie używają tego samego języka co aplikacja, w której są dostępne. Aby dodać tłumaczenia w określonych językach, wybierz produkt w aplikacji, a potem kliknij Zarządzaj tłumaczeniami i zastosuj wybrane języki. Jeśli chcesz dostosować przekaz do użytkowników z różnych krajów lub regionów, zapoznaj się z artykułem Tłumaczenie i lokalizowanie aplikacji.

Tworzenie grupy złożonej z wielu produktów w aplikacji

Aby jednocześnie utworzyć wiele produktów w aplikacji, możesz przesłać plik CSV ze szczegółowymi informacjami o każdym produkcie.

W plikach CSV wartości danych rozdzielane są przecinkami (,) lub średnikami (;). Przecinki rozdzielają podstawowe wartości danych, a średniki – wartości podrzędne.

Gdy tworzysz plik CSV z produktami w aplikacji, w pierwszym wierszu określ składnię CSV, a w następnych podaj szczegóły produktów.

Ważne: w pliku CSV każda pozycja musi mieścić się w całości w jednym wierszu.

Przesyłanie pliku CSV z produktami w aplikacji

Aby przesłać plik CSV, wykonaj te czynności:

1. Otwórz Konsolę Play.
2. Wejdź na stronę Produkty w aplikacji (Zarabianie > Produkty > Produkty w aplikacji).
3. Kliknij Importuj.
   • Importowanie wielu produktów przez przesłanie pliku CSV spowoduje zastąpienie dotychczasowych produktów tylko wtedy, gdy wartość Product ID w pliku CSV będzie odpowiadać wartości Product ID dotychczasowego produktu w aplikacji na liście produktów. Zastąpienie nie powoduje usunięcia produktów w aplikacji, które nie są zawarte w pliku CSV.
4. Upuść plik CSV, aby go przesłać, lub kliknij Prześlij.

Eksportowanie pliku CSV z dotychczasowymi produktami w aplikacji

Aby wyeksportować plik CSV, wykonaj te czynności:

1. Otwórz Konsolę Play.
2. Wejdź na stronę Produkty w aplikacji (Zarabianie > Produkty > Produkty w aplikacji).
3. Kliknij Eksportuj.

Wyświetlanie przykładowego pliku CSV

Oto przykład składni CSV, której możesz użyć, i 3 przykłady produktów w aplikacji:

• Pierwszy przykład zawiera tytuł i opis w 2 różnych językach (pl_PL i es_ES). Szablon cen definiuje cenę produktu.
• W drugim przykładzie nie ma szablonu cen. Zamiast tego podana jest cena dla kraju domyślnego (Polski). Na podstawie bieżących kursów wymiany i lokalnych wzorców cen Konsola Play automatycznie ustala ceny we wszystkich innych krajach, w których aplikacja jest rozprowadzana.
• W trzecim przykładzie również nie ma szablonu cen. Cena produktu jest określana ręcznie dla każdego kraju, w którym aplikacja jest rozprowadzana.

Przykład składni CSV

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

Przykłady produktów w aplikacji

Przykład 1

podstawowy_eliksir_snu,published,managed_by_android,false,pl_PL; Podstawowy eliksir snu; Usypia małe istoty.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,4637138456024710495

Przykład 2

standardowy_eliksir_snu,published,managed_by_android,false,pl_PL; Standardowy eliksir snu; Usypia wszystkie istoty na 2 minuty.,true, 1990000,

Przykład 3

eliksir_niewidzialności,published,managed_by_android,false,pl_PL; Eliksir niewidzialności; Jesteś niewidzialny dla wszystkich wrogów przez 5 minut.,false, PL; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

Wartości danych w plikach CSV

Każdy wiersz w pliku CSV z produktami w aplikacji może zawierać te wartości, ale co najmniej jedna z nich jest niezdefiniowana w każdym wierszu:

Product ID (Identyfikator produktu)	Ustawienie tej wartości w pliku CSV ma taki sam skutek jak wpisanie identyfikatora produktu podczas tworzenia nowego produktu w aplikacji. Jeśli podasz identyfikator Product ID przypisany do produktu w aplikacji, który jest już na liście produktów, dane dotychczasowego produktu w aplikacji zostaną zastąpione wartościami podanymi w pliku CSV.
Publish State (Stan publikacji)	Należy ustawić wartość published lub unpublished. Ma to taki sam skutek jak ustawienie dla produktu w aplikacji wartości Aktywny lub Nieaktywny.
Purchase Type (Typ zakupu)	Należy ustawić wartość managed_by_android.
Auto Translate (Tłumaczenie automatyczne)	Należy ustawić wartość false, ponieważ automatyczne tłumaczenie szczegółów produktu w aplikacji nie jest obsługiwane. Jeśli chcesz dodać tłumaczenia tytułu i opisu produktu w aplikacji, wyraźnie określ je w wartości Locale.
Locale (Język), Title (Tytuł) i Description (Opis)	Jeśli dla produktu ustawisz tylko 1 język, musisz określić język domyślny swojej aplikacji oraz domyślny tytuł i opis produktu: app_default_locale; item_default_title; item_default_description; Dla wartości Locale możesz ustawić dowolny kod języka spośród tych, które wyświetlają się, gdy dodajesz tłumaczenia informacji o aplikacji. Uwaga: określając wartości Title i Description, użyj ukośnika lewego jako znaku zmiany znaczenia przed średnikiem (\;) i innym ukośnikiem lewym (\\). Jeśli chcesz uwzględnić przetłumaczone wersje tytułu i opisu produktu, musisz wymienić domyślny język, tytuł i opis, a po nich podać języki, tytuły i opisy dla każdego tłumaczenia. W poniższym przykładzie ustawienia języka i tłumaczenia produktu w aplikacji to pl_PL (polski – Polska) jako domyślny język i es_ES (hiszpański – Hiszpania) jako tłumaczenie: pl_PL; Peleryna niewidzialności; Powoduje, że stajesz się niewidzialny.; es_ES; Capote Invisible; Se vuelven invisible. Uwaga: aplikacja zawiera 1 język domyślny, ale każdy produkt w aplikacji ma własną listę tłumaczeń. Mimo że pierwsze ustawienie języka w wartości Locale każdego produktu musi być takie samo w całym pliku CSV, pozostałe języki mogą się różnić między produktami.
Auto-Fill Prices (Autouzupełnianie cen), Country (Kraj) i Price (Cena)	Opcję Auto-Fill Prices możesz ustawić na wartość true lub false. Jeśli w przypadku produktu w aplikacji używasz szablonu cen, ustaw opcję Auto-Fill Prices na wartość false i nie ustawiaj wartości opcji Price. Uwaga: cenę elementu w pliku CSV podaj w mikrojednostkach, gdzie milion mikrojednostek odpowiada jednej jednostce rzeczywistej waluty. Używanie autouzupełniania cen W kolejnych sekcjach opisujemy, jak wartość opcji Auto-Fill Prices wpływa na składnię i znaczenie wartości Country i Price. Jeśli ustawisz opcję Auto-Fill Prices na wartość true, określ tylko cenę domyślną produktu i nie podawaj wartości Country. Na przykład gdy spełnione są te warunki: Domyślnym językiem Twojej aplikacji jest pl_PL. Domyślna cena produktu w aplikacji bez podatku to 1,99 PLN. Chcesz, aby ceny dla innych krajów były uzupełniane automatycznie. Ustaw opcje Auto-Fill Prices i Price na końcu wiersza w pliku CSV na wartości: true,1990000, Ustawianie własnej ceny według kraju Jeśli zamiast tego ustawisz opcję Auto-Fill Prices na wartość false, możesz określić serię wartości Country i Price dla wszystkich krajów, w których rozprowadzasz swoją aplikację – w tym dla kraju odpowiadającego jej domyślnemu językowi. Każda wartość Country jest dwuliterowym kodem ISO oznaczającym kraj, w którym rozprowadzana jest aplikacja. Uwaga: musisz podać kod kraju i cenę dla każdego kraju, na który chcesz kierować aplikację. Aby wyświetlić i edytować listę krajów, na które kierowana jest Twoja aplikacja, otwórz kartę Kraje/regiony na stronie Wersja produkcyjna. Każda wartość Price oznacza cenę produktu w mikrojednostkach waluty używanej w danym kraju. Na przykład jeśli oferujesz aplikację za podane poniżej ceny (obejmujące wszystkie podatki) w innych krajach: 6,99 BRL w Brazylii 129 RUB w Rosji 130 INR w Indiach 27 000 IDR w Indonezji 37 MXN w Meksyku Możesz ustawić następujące wartości opcji Auto-Fill Prices, Country i Price na końcu wiersza w pliku CSV: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID (Identyfikator szablonu cen)	Jeśli produkt jest powiązany z szablonem cen, ustaw opcję Auto-Fill Prices na wartość false i nie ustawiaj wartości w kolumnie Price. Jeśli produkt nie jest powiązany z szablonem cen, nie ustawiaj wartości dla opcji Pricing Template ID. Zamiast tego ustaw wartości opcji Auto-Fill Prices, Country i Price w zależności od tego, jak chcesz ustawić ceny produktu w aplikacji. Jeśli zaimportujesz plik CSV, możesz zaktualizować połączenia między produktami w aplikacji a szablonami cen. Aby połączyć produkt z określonym szablonem cen, ustaw wartość Pricing Template ID na identyfikator tego szablonu cen. Aby odłączyć produkt w aplikacji od wszystkich szablonów cen, nie ustawiaj wartości jego opcji Pricing Template ID. Z jednym szablonem cen możesz połączyć maksymalnie 1000 cen aplikacji lub cen produktów w aplikacji. W związku z tym w pliku CSV nie podawaj tej samej wartości dla opcji Pricing Template ID w większej liczbie wierszy niż 1000.
EEA Withdrawal Right Type (Prawo odstąpienia od umowy na terenie Europejskiego Obszaru Gospodarczego)	Jeśli rozprowadzasz produkty wśród użytkowników z Europejskiego Obszaru Gospodarczego, ustaw tu wartość DIGITAL_CONTENT lub SERVICE.
Reduced VAT Rates (Obniżone stawki VAT)	Jeśli sprzedajesz wiadomości, czasopisma, gazety, książki, filmy, muzykę, treści dźwiękowe i audiobooki w formie cyfrowej, w pewnych krajach i regionach możesz kwalifikować się do skorzystania z obniżonych stawek VAT. W przypadku obniżonych stawek wartości w tym polu mają następujący format: kod kraju; stawka VAT; Poszczególne pary kraj/stawka należy oddzielać średnikiem. Na przykład: CA; BOOKS_1, aby ustawić obniżoną stawkę na książki na poziomie 1 dla Kanady. FR; NEWS_1; GR; NEWS_2, aby ustawić obniżoną stawkę na wiadomości na poziomie 1 dla Francji oraz na poziomie 2 dla Grecji. Poziomy można ustawić jako BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (stosując zapis wielkimi lub małymi literami).
Communications and amusement taxes (Podatki komunikacyjne i podatki od rozrywki)	Jeśli chcesz pobierać obowiązujące podatki komunikacyjne lub podatki od rozrywki, musisz określić, że aplikacja lub produkt to usługa do strumieniowania, oraz ustawić w tym polu wartość ELIGIBLE. W przeciwnym razie pozostaw to pole puste. Obecnie jedynym krajem, w którym można ustawić tego rodzaju podatki, są Stany Zjednoczone. W tym polu znajdują się zawsze te wartości: Kod kraju;Kwalifikowalność;Stawka Na przykład: US;ELIGIBLE;VIDEO_RENTAL Jeśli spełniasz kryteria, możesz ustawić wartości w tym polu na podstawie tych kategorii: VIDEO_RENTAL – streaming wideo (subskrypcja/wypożyczenie/pay-per-view) VIDEO_SALES – streaming wideo (sprzedaż) VIDEO_MULTI_CHANNEL – streaming wideo (wiele kanałów) AUDIO_RENTAL – streaming audio (subskrypcje lub wypożyczenie) AUDIO_SALES – streaming audio (sprzedaż) AUDIO_MULTI_CHANNEL – streaming audio (wiele kanałów)