Як створити продукт, що продається через додаток

Через платіжну систему Google Play ви можете пропонувати користувачам продукти в додатку, за які плата стягується одноразово. До них, зокрема, належать віртуальні товари (наприклад, рівні гри або зілля) і платні сервіси в межах додатка Google Play.

Ви також можете створити підписку, за яку регулярно стягуватимете плату з користувачів.

Важливо. До підписок і продуктів, що продаються через додаток, застосовуються Правила програми для розробників і комісійні збори Google Play.

Доступність

Платіжна система Google Play підтримується в країнах і регіонах, де можна зареєструвати обліковий запис продавця.

Якщо ця вимога виконується й ви хочете використовувати платіжну систему Google Play у своїх додатках, створіть платіжний профіль і дізнайтеся, як налаштувати платіжну систему Google Play, на сайті для розробників Android.

Щоб продукт можна було купити, він має бути активний, а його додаток – націлений на країну або регіон користувача. Поки продукт активний, його можна купити, навіть якщо скасовано публікацію додатка, у якому він продається. Щоб зробити продукт недоступним для покупки, його потрібно деактивувати.

Якщо ви використовуєте тестовий обліковий запис, перейдіть на сайт для розробників Android і дізнайтеся більше про тестування інтеграції Google Play Billing Library.

Коли ви створите продукт, що продається через додаток, він стане доступним для користувачів найновішої версії Google Play.

Потрібні дозволи

Щоб пропонувати продукт, що продається через додаток, задекларуйте в маніфесті файлу APK дозвіл com.android.vending.BILLING. Додатки з дозволом com.android.vending.BILLING можна публікувати в усіх країнах.

Інструкції зі створення

Один продукт, що продається через додаток

Перш ніж створити продукт, що продається через додаток, ретельно сплануйте його ідентифікатори. Вони мають бути унікальні для вашого додатка, і їх не можна змінювати або використовувати повторно.

• Ідентифікатор продукту має починатися з цифри або малої літери й може містити цифри (0–9), малі літери (a–z), підкреслення (_) і крапки (.).
• Якщо продукт уже створено, змінити або повторно використати його ідентифікатор не можна.
• Примітка. Ідентифікатор продукту android.test недоступний, як і всі інші, що починаються з android.test.

Щоб створити продукт, що продається через додаток:

1. Відкрийте Play Console.
2. Перейдіть на сторінку Покупки в додатку (Монетизація > Продукти > Покупки в додатку).
3. Натисніть Створити продукт.
4. Введіть докладну інформацію про нього.
   • Ідентифікатор продукту. Унікальний код вашого продукту, що продається через додаток.
   • Назва. Коротка назва продукту, як-от "Сонне зілля" (до 55 символів, однак радимо використовувати не більше ніж 25 символів, щоб назва мала правильний вигляд на всіх екранах).
   • Опис. Довгий опис (до 200 символів), наприклад "Миттєво змушує істоту заснути".
   • Значок. Унікальне й правильне зображення вашого продукту. Не додавайте текст, рекламу чи фірмову символіку. Значок продукту показуватиметься на сторінці додатка й у процесі покупки.
     • PNG (32 біти)
     • 512 x 512 пікселів
     • До 1 МБ
   • Ціна. Введіть ціну в місцевій валюті або виберіть шаблон цін.
   • Оплата кількох одиниць. Дозвольте придбання кількох одиниць продукту. Користувачі зможуть придбати ваш продукт у кількості, що не перевищує порогове значення для країни чи регіону, де вони проживають. Зверніть увагу на наведену нижче інформацію.
     • Щоб налаштувати оформлення замовлення з кількома одиницями продукту в Play Console, у додатку потрібно використовувати Google Play Billing Library 4.0. Щоб дізнатися, як інтегрувати Google Play Billing Library у свій додаток, відвідайте сайт для розробників Android.
     • Створити замовлення з кількома одиницями продукту можна не в усіх країнах і регіонах.
     • У більшості країн або регіонів, де користувачі можуть придбати кілька одиниць продукту, порогове значення ціни артикула становить приблизно 100 дол. США. Щоб дозволити оплату кількох одиниць продукту, змініть ціну (без урахування податків) так, щоб вона була нижча за порогове значення для кожної країни чи кожного регіону.
   • Лише в Play Points. Зробіть свій продукт доступним лише для учасників програми Google Play Points.
5. Збережіть зміни й натисніть Активувати, щоб надати користувачам доступ до вашого продукту, що продається через додаток.

Мови та переклади

У додатку й продуктах, що продаються через нього, використовується однакова мова за умовчанням. Щоб додати переклади певними мовами, виберіть продукт, що продається через додаток, натисніть Керувати перекладами й застосуйте потрібні мови. Дізнатися, як локалізувати додаток для користувачів з усього світу, можна із цієї статті.

Група продуктів, що продаються через додаток

Щоб одночасно створити кілька продуктів, що продаються через додаток, можна завантажити файл CSV, який містить інформацію про кожен із них.

У файлах CSV значення даних розділяються комами (,) і крапками з комою (;). Коми розділяють основні, а крапки з комою – допоміжні значення.

У першому рядку потрібно вказати синтаксис файлу CSV, а в наступних – докладну інформацію про продукти.

Важливо. Повні дані для кожного продукту у файлі CSV мають міститися в одному рядку.

Як додати файл CSV зі списком продуктів, що продаються через додаток

Щоб додати файл CSV:

1. Відкрийте Play Console.
2. Перейдіть на сторінку Покупки в додатку (Монетизація > Продукти > Покупки в додатку).
3. Натисніть Імпортувати.
   • Якщо раніше для цього додатка вже додавалися дані про продукти, їх буде замінено на дані з імпортованого файлу CSV лише за умови збігу значень Product ID. Для продуктів, яких немає у файлі CSV, дані не видаляться.
4. Перетягніть свій файл CSV, щоб завантажити його, або натисніть Завантажити.

Як експортувати файл CSV зі списком наявних продуктів, що продаються через додаток

Щоб експортувати файл CSV:

1. Відкрийте Play Console.
2. Перейдіть на сторінку Покупки в додатку (Монетизація > Продукти > Покупки в додатку).
3. Натисніть Експортувати.

Приклад файлу CSV

Нижче наведено приклад синтаксису файлу CSV та три приклади продуктів, що продаються через додаток.

• У першому прикладі наведено назву й опис двома різними мовами (uk і en_US). Ціну продукту визначає вказаний шаблон цін.
• У другому прикладі немає шаблону цін. Натомість у ньому вказано ціну для країни за умовчанням (України). Для всіх інших країн, де розповсюджується додаток, Play Console автоматично призначатиме ціну за поточними курсами обміну й відповідними місцевими моделями ціноутворення.
• У третьому прикладі також немає шаблона цін. Вартість продукту вказано вручну для кожної країни, де розповсюджується додаток.

Приклад синтаксису файлу CSV

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

Приклади продуктів, що продаються через додаток

Приклад 1

basic_sleeping_potion,published,managed_by_android,false,uk; Слабке сонне зілля; Присипляє маленьких істот.; en_US; Basic Sleeping Potion; Puts small creatures to sleep.,false,,4637138456024710495

Приклад 2

standard_sleeping_potion, published,managed_by_android,false,uk; Звичайне сонне зілля; Присипляє всіх істот на 2 хвилини.,true, 54600000,

Приклад 3

invisibility_potion,published, managed_by_android,false,uk; Зілля невидимості; Робить невидимим для ворогів на 5 хвилин.,false, UA; 54600000; BR; 6990000; US; 1990000; IN; 130000000; ID; 27000000000; MX; 37000000,

Значення даних у файлах CSV

Кожен рядок у файлі CSV з продуктами, що продаються через додаток, може містити наведені нижче значення, але принаймні одне з них не визначається.

Product ID	Визначити цей параметр у файлі CSV – це те саме, що ввести ідентифікатор під час створення нового продукту, що продається через додаток. Якщо значення параметра Product ID у файлі CSV збігатиметься з ідентифікатором уже створеного продукту, дані з файлу перезапишуть уже наявні дані про цей продукт.
Publish State	Потрібно вказати значення published (опубліковано) або unpublished (не опубліковано). Це те саме, що призначити продукту, що продається через додаток, статус Активний чи Неактивний.
Purchase Type	Потрібно вказати значення managed_by_android.
Auto Translate	Потрібно вказати значення false, оскільки автоматичний переклад докладної інформації про продукти, що продаються через додаток, не підтримується. Якщо ви хочете надати переклади назви й опису продукту, що продається через додаток, включіть їх у параметр Locale.
Locale, Title і Description	Якщо ви додаєте для продукту лише одну мову, потрібно вказати для нього назву й опис за умовчанням, а також мову за умовчанням для додатка: app_default_locale; item_default_title; item_default_description; Для параметра Locale можна вказати будь-який із кодів мов, що з’являються, коли ви додаєте переклад сторінки додатка. Примітка. Указуючи значення Title і Description, використовуйте обернені скісні риски, щоб екранувати символи крапки з комою (\;) і оберненої скісної риски (\\). Якщо ви хочете включити перекладені назву й опис продукту, спершу вкажіть мову за умовчанням і оригінальні назву й опис. Після них зазначте мову, назву та опис для кожного перекладу. У цьому прикладі мова за умовчанням – uk (українська), а мова перекладу – en_US (англійська, США): uk; Плащ-невидимка; Робить вас невидимим.; en_US; Invisibility Cloak; Makes you invisible. Примітка. Додаток має одну мову за умовчанням, але в кожного продукту, що продається через нього, є власний список перекладів. Хоча перша мова в значенні параметра Locale кожного продукту має бути однакова в усьому файлі CSV, інші мови можуть відрізнятися.
Auto-fill prices, Country й Price	Для параметра Auto-fill prices можна вказати значення true або false. Якщо в продукті, що продається через додаток, використовується шаблон цін, потрібно вказати для параметра Auto-fill prices значення false і не визначати параметр Price. Примітка. Коли ви вказуєте ціну продукту у файлі CSV, вводьте її в мікроодиницях, де 1 000 000 дорівнює 1 одиниці реальної валюти. Як використовувати автозаповнення цін У розділах нижче описано, як параметр Auto-fill prices впливає на синтаксис і значення Country й Price. Якщо ви задаєте для параметра Auto-fill prices значення true, указуйте лише ціну продукту за умовчанням; параметр Country визначати не потрібно. Наприклад, умови такі: мова додатка за умовчанням – uk_UA; ціна за умовчанням продукту, що продається через додаток, без урахування податків становить 72,77 грн; ви хочете, щоб ціни для інших країн заповнювались автоматично. Тоді вам потрібно визначити параметри Auto-fill prices і Price у кінці рядка файлу CSV так: true,1990000, Як налаштувати власну ціну для кожної країни Якщо задати для параметра Auto-fill prices значення false, то можна вказати різні значення в стовпцях Country й Price для всіх країн, у яких ви розповсюджуєте додаток, зокрема для тієї, де використовується мова додатка за умовчанням. Кожне значення параметра Country – це код ISO з двох великих літер, який позначає країну, де розповсюджується додаток. Примітка. Потрібно вказати код ISO й ціну для кожної країни, на яку націлюється додаток. Щоб переглянути й змінити список цих країн, перейдіть на вкладку Країни або регіони на сторінці Робоча версія. Кожне значення параметра Price – це вартість у мікроодиницях валюти відповідної країни. Наприклад, ви пропонуєте свій додаток в інших країнах за такими цінами (з усіма податками): 6,99 бразильських реалів у Бразилії 129 російських рублів у Росії 130 індійських рупій в Індії 27 000 індонезійських рупій в Індонезії 37 мексиканських песо в Мексиці Параметри Auto-fill prices, Country й Price у кінці рядка файлу CSV можна визначити так: false, BR; 6990000; US; 1990000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Якщо продукт зв’язано із шаблоном цін, задайте для параметра Auto-fill prices значення false і не вказуйте дані в стовпці Price. Якщо продукт не зв’язано із шаблоном цін, не визначайте параметр Pricing Template ID. Натомість укажіть потрібні значення в стовпцях Auto-fill prices, Country й Price. Ви можете імпортувати файл CSV, щоб оновити зв’язки між продуктами, що продаються через додаток, і шаблонами цін. Для цього вкажіть для параметра Pricing Template ID значення, що збігається з ідентифікатором потрібного шаблона. Щоб від’єднати продукт, що продається через додаток, від усіх шаблонів, не визначайте параметр Pricing Template ID. З одним шаблоном цін можна зв’язати до 1000 цін на додатки або продукти, що продаються через них. Тому не вказуйте однакове значення параметра Pricing Template ID в більше ніж 1000 рядках файлу CSV.
EEA Withdrawal Right Type	Якщо ви розповсюджуєте свій продукт у Європейській економічній зоні (ЄЕЗ), для цього параметра потрібно вказати значення DIGITAL_CONTENT або SERVICE.
Reduced VAT Rates	Якщо ви продаєте цифрові новини, журнали, газети, книги, відео, музику, аудіокниги чи інший аудіоконтент у різних країнах або регіонах, ви можете мати право на сплату ПДВ за зниженою ставкою. Для цього значення в цьому полі мають відповідати такому формату: CountryCode;VATRate; Кожна пара (країна й ставка) має відділятися від наступної крапкою з комою. Нижче наведено приклади. CA;BOOKS_1, якщо для книг у Канаді застосовується знижена ставка рівня 1. FR;NEWS_1; GR;NEWS_2, якщо для новин у Франції і Греції застосовуються знижені ставки рівня 1 і 2 відповідно. Рівні можна вказувати так: BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (великими або малими літерами).
Communications and amusement taxes	Якщо ви хочете стягувати належні податки на комунікаційні послуги й розваги, ви повинні вказати, що ваш додаток або продукт належить до продуктів потокового передавання, і задати для відповідного параметра значення ELIGIBLE. Інакше не заповнюйте це поле. Зараз цей тип податків можна вибрати лише для США. Заповніть це поле в такому форматі: CountryCode;Eligibility;Rate Нижче наведено приклади. US;ELIGIBLE;VIDEO_RENTAL Якщо ви сплачуєте цей податок, виберіть одне з таких значень для параметра Rate: VIDEO_RENTAL – потокове передавання відео (підписка, прокат або плата за перегляд) VIDEO_SALES – потокове передавання відео (продаж) VIDEO_MULTI_CHANNEL – потокове передавання відео (багатоканальні мережі) AUDIO_RENTAL– потокове передавання аудіо (підписка або прокат) AUDIO_SALES – потокове передавання аудіо (продаж) AUDIO_MULTI_CHANNEL – потокове передавання аудіо (багатоканальні мережі)