Як завантажувати й експортувати щомісячні звіти

З веб-сайту Play Console можна завантажувати щомісячні звіти про окремі додатки, щоб відстежувати й аналізувати їх продуктивність.

Типи звітів

Детальні звіти

Детальні звіти містять дані про окремі події.

• Відгуки
• Фінанси: приблизний обсяг продажів, прибутки, бонусні продукти та платежі з балансу Play у Кореї

Зведені звіти

Зведені звіти містять сукупну статистику додатка (середні значення, сумарні дані за день тощо).

• Статистика: встановлення, збої, оцінки й підписки
• Конверсії користувачів: користувачі, які не видалили додаток; покупці (7 днів після встановлення); користувачі, які підписалися

Як завантажувати звіти

1. Відкрийте Play Console.
2. Натисніть Завантаження звітів і виберіть Відгуки, Статистика або Фінанси.
3. У відповідному полі введіть і виберіть назву потрібного додатка.
4. Виберіть рік і місяць звіту, який хочете завантажити.

Примітка. Фінансові звіти містять дані щодо всіх додатків у вашому обліковому записі.

Як завантажувати звіти з Google Cloud Storage

Звіти доступні в Google Cloud Storage. Вони генеруються щодня та накопичуються в щомісячних файлах CSV. Звіти зберігаються в приватному сегменті Google Cloud Storage вашого облікового запису розробника Google Play.

Доступ до звітів можна отримати за допомогою Google Cloud Storage у веб-переглядачі або програмними засобами, користуючись інструментом gsutil. Щоб отримати доступ до сегмента Cloud Storage програмними засобами, можна скористатись також іншими інструментами.

Порада: щоб імпортувати звіти з Google Cloud Storage у BigQuery, конвертуйте файли CSV з UTF-16 у UTF-8.

Як знайти ідентифікатор URI сервісу Google Cloud Storage

Ви можете скопіювати свій ідентифікатор URI сервісу Google Cloud Storage. Для цього натисніть кнопку Копіювати URI Cloud Storage біля заголовка відповідного розділу на сторінках Завантаження звітів.

Ваш ідентифікатор URI сервісу Cloud Storage починається з pubsite_prod_rev (наприклад, pubsite_prod_rev_01234567890987654321).

Як завантажувати звіти за допомогою інструмента командного рядка

1. Установіть інструмент gsutil.
   • Обов’язково ввійдіть в обліковий запис, який має доступ до Play Console.
   • Якщо ви працюєте з інструментом gsutil уперше та не маєте проектів, налаштованих у Google Cloud Storage, під час налаштування введіть назву свого додатка, коли буде запропоновано вказати ідентифікатор проекту.
2. Щоб знайти свій ідентифікатор сегмента звітів, натисніть Копіювати URI Cloud Storage біля заголовка відповідного розділу на сторінках Завантаження звітів.
   • Ваш ідентифікатор URI сервісу Cloud Storage починається з pubsite_prod_rev (наприклад, pubsite_prod_rev_01234567890987654321).
3. Щоб завантажити звіти, введіть команду gsutil cp.
   • Щоб дізнатися про інші команди для доступу до звітів, перегляньте документи щодо інструмента gsutil.

Звіти впорядковуються в каталоги, названі відповідно до типу звітів. Назва файлу CSV складається з типу звіту, назви пакета, періоду часу та параметра (у відповідних випадках).

Як завантажувати звіти за допомогою клієнтської бібліотеки та сервісного облікового запису

Крок 1. Створіть сервісний обліковий запис

1. Відкрийте Google Developers Console.
2. Якщо у вас уже є проект, виберіть його зі спадного списку. Якщо вашого проекту немає в списку або ви хочете створити новий, натисніть Create project (Створити проект).
3. Натисніть значок меню > Permissions (Дозволи) > Service accounts (Сервісні облікові записи) > Create service account (Створити сервісний обліковий запис).
4. Виконайте вказівки на екрані та виберіть Create (Створити).
5. Скопіюйте електронну адресу.
   • Наприклад: [e-mail]

Крок 2. Додайте сервісний обліковий запис у Play Console

1. Відкрийте Play Console.
2. Виберіть значок > Облікові записи та права користувачів > Запросити нового користувача.
3. Вставте або введіть електронну адресу, зв’язану із сервісним обліковим записом.
4. Виберіть дозволи відповідно до потрібних вам типів звітів. 
   • Порада. Про різні рівні доступу й дозволи можна прочитати в статті Як додавати користувачів в обліковий запис розробника та керувати дозволами.
5. Натисніть Додати користувача. Сервісний обліковий запис буде додано у ваш обліковий запис.

Крок 3. Отримайте звіти за допомогою виклику API

1. Установіть клієнтську бібліотеку API для своєї мови кодування.
2. Налаштуйте код для виклику API, що застосовує автентифікацію із сервера на сервер OAuth2 та запитує рівень доступу OAuth2 (https://www.googleapis.com/auth/devstorage.read_only).
3. Отримайте звіти за допомогою виклику API.

Приклад (Python)

Приклад коду на мові Python для отримання звітів:

import json

from httplib2 import Http

from oauth2client.client import SignedJwtAssertionCredentials

from apiclient.discovery import build

# Підставляйте змінні, які підійдуть для вашого випадку

client_email = "ваш службовий обліковий запис"

json_file = 'path_to_json_file_obtained_when_creating_the_service_account'

cloud_storage_bucket = 'pubsite_prod_rev_…'

report_to_download = 'earnings/earnings_….zip'

 

private_key = json.loads(open(json_file).read())['private_key']

credentials = SignedJwtAssertionCredentials(client_email, private_key,

   'https://www.googleapis.com/auth/devstorage.read_only')

storage = build('storage', 'v1', http=credentials.authorize(Http()))

print storage.objects().get(

   bucket=cloud_storage_bucket,

   object=report_to_download).execute()

Як керувати доступом до Google Cloud Storage

До звітів у Google Cloud Storage застосовуються ті самі обмеження доступу, що й до даних у Play Console. Це означає, що користувачі облікового запису, які мають доступ до його певних розділів у Play Console, матимуть доступ до відповідних звітів у Google Cloud Storage. 

Власники облікових записів можуть будь-коли оновлювати дозволи для окремих користувачів.

• Для доступу до пакетів звітів потрібно мати дозвіл "Перегляд інформації про додаток" для всіх додатків. 
• Щоб завантажувати фінансові звіти, потрібно мати дозвіл "Перегляд фінансових даних" для всіх додатків.

Команди та формати файлів для докладних звітів

Збої та помилки ANR

Починаючи з травня 2018 року, більше не можна завантажувати докладні звіти про збої та помилки ANR.

Відгуки

Відгуки

Команда

gs://[identyfikator_sehmenta]/reviews/reviews_[nazva_paketa]_YYYYMM.csv

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Package Name (Назва пакета)	Рядок	НІ	com.company.app
App Version Code (Код версії додатка)	Ціле число	ТАК	Тільки файли APK робочої версії
App Version Name (Назва версії додатка)	Рядок	ТАК
Reviewer Language (Мова відгуку)	Рядок – абревіатура з двох літер у форматі ISO 639-1	ТАК	en
Device (Пристрій)	Рядок	ТАК	hammerhead
Review Submit Date and Time (Дата й час надсилання відгуку)	У форматі ISO 8601, включно з часом UTC	НІ	2014-06-19T19:12:32Z
Review Submit Millis Since Epoch (Час надсилання відгуку в мілісекундах за UNIX-часом)	Ціле число, мілісекунди за UNIX-часом	НІ
Review Last Update Date and Time (Дата й час останнього оновлення відгуку)	У форматі ISO 8601, включно з часом UTC	ТАК	2014-06-19T19:12:32Z
Review Last Update Millis Since Epoch (Час останнього оновлення відгуку в мілісекундах за UNIX-часом)	Ціле число, мілісекунди за UNIX-часом	ТАК
Star Rating (Оцінка)	Ціле число (від 1 до 5)	НІ
Review Title (Заголовок відгуку)	Рядок мовою, якою написаний відгук (без нових рядків)	ТАК
Review Text (Текст відгуку)	Рядок мовою, якою написаний відгук (без нових рядків)	ТАК
Developer Reply Date and Time (Дата й час відповіді розробника)	У форматі ISO 8601, включно з часом UTC	ТАК	2014-06-19T19:12:32Z
Developer Reply Millis Since Epoch (Час відповіді розробника в мілісекундах за UNIX-часом)	Ціле число, мілісекунди за UNIX-часом	ТАК
Developer Reply Text (Текст відповіді розробника)	Рядок (без нових рядків і зі стиснутими пробілами)	ТАК
Review Link (Посилання на відгук)	Рядок	ТАК	https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>

Приклад

Якщо ви хочете завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета "com.example.app" у 2014 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /vash/lokalnyi/kataloh

Фінансові звіти

Приблизний обсяг продажів

Радимо не брати до уваги кількість стовпців у файлах CSV під час роботи з автоматизованими звітами.

Інформація

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

Цей звіт можна використовувати для аналітики чи аналізу тенденцій, але небажано застосовувати для обліку. Натомість використовуйте Звіт про доходи.

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

Команда

gs://[identyfikator_sehmenta]/sales/salesreport_YYYYMM.zip

Приклад

Якщо ви хочете завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета "com.example.app" у 2014 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /vash/lokalnyi/kataloh

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Order Number (Номер замовлення)	Рядок	Ні	GPA.1234-1234-1234-12345 У кінці ідентифікатора замовлення на підписку вказується номер циклу поновлення (наприклад, перше поновлення має номер GPA.1234-1234-1234-12345..0, друге поновлення – GPA.1234-1234-1234-12345..1 тощо).
Order Charged Date (Дата стягнення плати за замовлення)	Рядок	Ні	2016-11-30 Дата цього замовлення за універсальним часом UTC (у форматі РРРР-ММ-ДД).
Order Charged Timestamp (Позначка часу стягнення плати за замовлення)	Ціле число	Ні	1480507200 Позначка часу UNIX, коли з користувача стягнули плату за замовлення. Вимірюється в секундах за UNIX-часом.
Financial Status (Фінансовий статус)	Рядок	Ні	charged, refund, partial refund тощо. Якщо ви спочатку частково повернете кошти, а потім – повністю: часткове відшкодування з’явиться в окремому рядку рядок повного відшкодування показуватиме залишковий баланс
Device Model (Модель пристрою)	Рядок	Ні	mako тощо. Модель пристрою Android, з якого здійснено покупку. У випадку підписок ці дані стосуються пристрою, з якого було оформлено перше замовлення.
Product Title (Назва продукту)	Рядок	Ні	coins, monthly subscription тощо. Зазначена розробником назва продукту. Наводиться мовою покупця.
Product ID (Ідентифікатор продукту)	Рядок	Ні	com.example.app Назва пакета додатка, через який було придбано продукт.
Product Type (Тип продукту)	Рядок	Ні	paidapp, subscription, inapp
SKU ID (Артикул)	Рядок	Ні	treasure_chest_for_new_users Зазначений розробником унікальний ідентифікатор продукту.
Currency of Sale (Валюта продажу)	Рядок	Ні	UAH, EUR, THB тощо.
Item Price (Ціна продукту)	Ціле число	Ні	12,345.67 Наводиться в місцевій валюті покупця. Тисячі відділяються знаком ",".
Taxes Collected (Стягнені податки)	Ціле число	Так	12,345.67 Наводиться в місцевій валюті покупця. Тисячі відділяються знаком ",".
Charged Amount (Стягнена сума)	Ціле число	Ні	12,345.67 Наводиться в місцевій валюті покупця. Це сума вартості товару та податків. Тисячі відділяються знаком ",".
City of Buyer (Місто покупця)	Рядок	Так	Boston, Toronto, тощо. Заповнюється лише для продажів у місцях, де ви зареєстровані продавцем.
State of Buyer (Штат покупця)	Рядок	Так	MA, ON тощо.
Postcode of Buyer (Поштовий індекс покупця)	Рядок	Так	02140, M5B 1L6 тощо. Заповнюється лише для продажів у місцях, де ви зареєстровані продавцем.
Country of Buyer (Країна покупця)	Рядок	Ні	US, CA тощо.
Base Plan ID (Ідентифікатор базового плану)	Рядок	Так	weekly Ідентифікатор базового плану підписки. Заповнюється лише для підписок. Докладніше.
Offer ID (Ідентифікатор пропозиції)	Рядок	Так	spring-offer Ідентифікатор пропозиції підписки. Заповнюється лише для підписок. Докладніше.
Group ID (Ідентифікатор групи)	Ціле число	Так	1234567891234567890 Унікальний ідентифікатор надається під час створення групи облікових записів розробника. Докладніше.
First USD 1M Eligible (Право на комісійний збір за 1-й млн дол. США)	Рядок	Так	Yes, No Заповнюється, лише якщо налаштовано групу облікових записів розробника. Докладніше.
Promotion ID (Ідентифікатор рекламної акції)	Рядок	Так	PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, Points used only Заповнюється лише для продажів, пов’язаних із балами Play Points. Префікс "PP.C" позначає замовлення, під час оплати яких використано купон, а "PP.P" – ті, які оплачено з використанням промокоду на продукт, що продається через додаток. Замовлення, оплачені безпосередньо балами Play Points, також указуються у звіті. Докладніше.
Coupon Value (Номінал купона)	Ціле число	Так	3.00 Наводиться в місцевій валюті покупця. Тисячі відділяються знаком ",". Заповнюється лише для продажів, пов’язаних із купонами Play Points. Докладніше.
Discount Rate (Знижка)	Ціле число	Так	45, 55, 70 Відсоток знижки вказує, скільки користувач заощадив, витративши бали Play Points замість грошей. Заповнюється лише для продажів, пов’язаних із балами Play Points. Докладніше.
Featured Products ID (Ідентифікатор рекомендованого продукту)	Ціле число	Так	1234567891234567890 Унікальний ідентифікатор призначається рекомендованому продукту під час його створення розробником. Докладніше.

Доходи

Радимо не брати до уваги кількість стовпців у файлах CSV під час роботи з автоматизованими звітами.

Інформація

За допомогою звіту про доходи можна аналізувати виплати й трансакції. Кожний рядок звіту відповідає певному типу трансакції (наприклад, стягнення плати з клієнта чи сплата комісії Google), а також містить оригінальні й конвертовані суми.

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

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

Примітки

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

Команда

gs://[identyfikator_sehmenta]/earnings/earnings_YYYYMM.zip

Приклад

Якщо ви хочете завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета "com.example.app" у 2014 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /vash/lokalnyi/kataloh

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Description (Опис)	Рядок	Ні	GPA.1234-1234-1234-12345 Унікальний ідентифікатор цього замовлення. У кінці ідентифікатора замовлення на підписку вказується номер циклу поновлення.
Transaction Date (Дата трансакції)	Рядок	Ні	Nov 30, 2016 Дата цього замовлення за тихоокеанським часом (у форматі МММ ДД, РРРР). Зверніть увагу, що в позначці часу трансакції може бути вказано наступний місяць, оскільки звіти генеруються за фіксованими датами.
Transaction Time (Час трансакції)	Рядок	Ні	12:00:00 PM PDT
Tax Type (Тип податку)	Рядок	Так	Third-party tax Це поле порожнє для рядків, що не стосуються податків.
Transaction Type (Тип трансакції)	Рядок	Ні	Charge, Google fee, Tax, Charge refund, Google fee refund, Charge rebill, Tax rebill, Google fee rebill, Adjustment.
Refund Type (Тип відшкодування)	Рядок	Так	Full, Partial Відшкодування, де покупцеві повернули повну суму, матимуть позначку "Full". Відшкодування, де покупцеві повернули частину суми, будуть із позначкою "Partial".
Product Title (Назва продукту)	Рядок	Ні	coins, monthly subscription… Зазначена розробником назва продукту. Наводиться мовою покупця.
Product ID (Ідентифікатор продукту)	Рядок	Ні	com.example.app Назва пакета додатка, через який було придбано продукт.
Product Type (Тип продукту)	Ціле число	Ні	0,1 Використовується для ідентифікації типу проданого продукту. "0" – це продаж платного додатка, "1" – продаж контенту через додаток або підписка.
SKU ID (Артикул)	Рядок	Ні	treasure_chest_for_new_users Зазначений розробником унікальний ідентифікатор продукту.
Hardware (Апаратне забезпечення)	Рядок	Ні	mako… Модель пристрою Android, з якого здійснено покупку. У випадку підписок це стосується моделі, з якої було оформлено перше замовлення.
Buyer Country (Країна покупця)	Рядок	Ні	US, CA…
Buyer State (Штат покупця)	Рядок	Так	MA, ON…
Buyer Postcode (Поштовий індекс покупця)	Рядок	Так	02140, M5B 1L6…
Buyer Currency (Валюта покупця)	Рядок	Ні	USD, EUR, THB…
Amount (Buyer Currency) (Сума у валюті покупця)	Ціле число	Ні	12345.67 Загальна сума цього рахунка-фактури до конвертації валюти.
Currency Conversion Rate (Курс обміну валюти)	Ціле число	Ні	0.56789 Обмінний курс, який використовувався під час конвертації суми з валюти покупця у валюту продавця.
Merchant Currency (Валюта продавця)	Рядок	Ні	USD, EUR, THB… Валюта, у яку здійснено конвертацію. Це місцева валюта, яка виплачується вам.
Amount (Merchant Currency) (Сума у валюті продавця)	Ціле число	Ні	12345.67 Загальна сума цього рахунка-фактури після конвертації валюти.
Base Plan ID (Ідентифікатор базового плану)	Рядок	Так	weekly Ідентифікатор базового плану підписки. Заповнюється лише для підписок. Докладніше.
Offer ID (Ідентифікатор пропозиції)	Рядок	Так	spring-offer Ідентифікатор пропозиції підписки. Заповнюється лише для підписок. Докладніше.
Group ID (Ідентифікатор групи)	Ціле число	Так	1234567891234567890 Унікальний ідентифікатор надається під час створення групи облікових записів розробника. Докладніше.
First USD 1M Eligible (Право на комісійний збір за 1-й млн дол. США)	Рядок	Так	Yes, No Заповнюється, лише якщо налаштовано групу облікових записів розробника. Докладніше.
Service Fee % (Комісійний збір, %)	Ціле число	Так	10, 15, 30
Fee Description (Опис комісії)	Рядок	Так	SUBSCRIPTIONS Деталі обчислення комісійного збору Google.
Promotion ID (Ідентифікатор рекламної акції)	Рядок	Так	PP.C_x0a08trvC1, PP.PdYfn342Ox10, Points used only Заповнюється лише для продажів, пов’язаних із балами Play Points. Префікс "PP.C" позначає замовлення, під час оплати яких використано купон, а "PP.P" – ті, які оплачено з використанням промокоду на продукт, що продається через додаток. Замовлення, оплачені безпосередньо балами Play Points, також указуються у звіті. Докладніше.

Платежі з балансу Play у Кореї

Інформація

Продавці, які за добровільними зобов’язаннями або чинними правилами й нормами Республіки Корея мають видавати чеки, повинні на вимогу покупця виписувати чеки на платні додатки або контент у додатках, оплачені корейськими вонами (KRW) за допомогою подарункових карток Google Play.

Звіт про платежі з балансу Play у Кореї містить дані про покупки, оплачені з балансу Play у корейських вонах, на основі яких продавець може надіслати користувачу квитанцію.

Примітка. Користувачі можуть поповнювати баланс Play із різних джерел, зокрема за допомогою рекламних бонусів від Google або наших партнерів. Перш ніж видавати чек, обов’язково переконайтеся, що користувач поповнив баланс еквівалентом готівки (наприклад, з подарункової картки).

Команда

gs://[identyfikator_sehmenta]/play_balance_krw/play_balance_krw_YYYYMM.zip

Приклад

Щоб завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета "com.example.app" у 2018 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /vash/lokalnyi/kataloh

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Order Number (Номер замовлення)	Ціле число	Ні	GPA.1234-1234-1234-12345 У кінці ідентифікатора замовлення на підписку вказується номер циклу поновлення (наприклад, перше поновлення має номер GPA.1234-1234-1234-12345..0, друге поновлення – GPA.1234-1234-1234-12345..1 тощо).
Order Charged Date (Дата стягнення плати за замовлення)	Рядок	Ні	2016-11-30 Дата цього замовлення за універсальним часом UTC (у форматі РРРР-ММ-ДД).
Financial Status (Фінансовий статус)	Рядок	Ні	Charged, Refund тощо
Play Balance Funding Amount (Сума покупки з балансу Play)	Рядок	Ні	12,345.67 Сума трансакції.
Play Balance Currency (Валюта балансу Play)	Рядок	Ні	KRW У звітах про платежі з балансу Play у Кореї валютою завжди є південнокорейська вона (KRW).
Order Charged Timestamp (Позначка часу стягнення плати за замовлення)	Ціле число	Ні	1480507200 Позначка часу UNIX, коли з користувача стягнули плату за замовлення. Вимірюється в секундах за UNIX-часом.

Підписки

Відповіді на опитування про скасування

Команда

gs://[identyfikator_sehmenta]/subscriptions/cancellations/freeform_[nazva_paketa].csv

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Cancellation Date (Дата скасування)	Рядок	Ні	2016-11-30
SKU ID (Артикул)	Рядок	Так	treasure_chest_for_new_users Зазначений розробником унікальний ідентифікатор продукту.
Country (Країна)	Рядок	Ні	US, CA…
Response (Відповідь)	Рядок	Ні

Команди та формати файлів для зведених звітів

Статистика

Встановлення

Команда

gs://[identyfikator_sehmenta]/stats/installs/installs_[nazva_paketa]_yyyyMM_[parametr].csv

Формат файлу

Поле	Формат	Факультативно?	Приклад
Date (Дата)	РРРР-мм-дд	НІ	2014-06-19
Package Name (Назва пакета)	Рядок	НІ	com.my.app
Device (Пристрій) – або інший підтримуваний параметр	Рядок	ТАК	hammerhead
Current Device Installs (Поточні встановлення на пристрої)	Ціле число	НІ
Installs on active devices (Встановлення на активних пристроях)	Ціле число	НІ
Daily Device Installs (Встановлення на пристрої за день)	Ціле число	НІ
Daily Device Uninstalls (Видалення на пристрої за день)	Ціле число	НІ
Daily Device Upgrades (Оновлення на пристрої за день)	Ціле число	НІ
Current User Installs (Поточні встановлення за користувачами)	Ціле число	НІ
Total User Installs (Усі встановлення користувачами)	Ціле число	НІ
Daily User Installs (Встановлення користувачами за день)	Ціле число	НІ
Daily User Uninstalls (Видалення користувачами за день)	Ціле число	НІ

Підтримувані параметри

Параметр	Назва файлу
App Version Code (Код версії додатка)	..._app_version.csv
Carrier (Оператор)	..._carrier.csv
Country (Країна)	..._country.csv
Device (Пристрій)	..._device.csv
Language (Мова)	..._language.csv
Android OS Version (Версія ОС Android)	..._os_version.csv

Приклад

Якщо ви хочете завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета "com.example.app" у 2014 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /vash/lokalnyi/kataloh

Збої

Примітка: із січня 2018 року експортовані звіти містять дані з нового джерела та відповідають інформації на сторінці Статистика. До цього періоду експортувати можна лише дані, зібрані з попереднього джерела даних.

Команда

gs://[identyfikator_sehmenta]/stats/crashes/crashes_[nazva_paketa]_yyyyMM_[parametr].csv

Формат файлу

Поле	Формат	Факультативно?	Приклад
Date (Дата)	РРРР-мм-дд	НІ	2014-06-19
Package Name (Назва пакета)	Рядок	НІ	com.my.app
Device (Пристрій) – або інший підтримуваний параметр	Рядок	ТАК	hammerhead
Daily Crashes (Збої в роботі за день)	Ціле число	НІ
Daily ANRs (Помилки ANR за день)	Ціле число	НІ

Підтримувані параметри

Параметр	Назва файлу
App Version Code (Код версії додатка)	..._app_version.csv
Device (Пристрій)	..._device.csv
Android OS Version (Версія ОС Android)	..._os_version.csv

Приклад

Якщо ви хочете завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета "com.example.app" у 2014 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /vash/lokalnyi/kataloh

Оцінки

Команда

gs://[identyfikator_sehmenta]/stats/ratings/ratings_[nazva_paketa]_yyyyMM_[parametr].csv

Формат файлу

Поле	Формат	Факультативно?	Приклад
Date (Дата)	РРРР-мм-дд	НІ	2014-06-19
Package Name (Назва пакета)	Рядок	НІ	com.my.app
Device (Пристрій) – або інший підтримуваний параметр	Рядок	ТАК	hammerhead
Daily Average Rating (Середня оцінка за день)	%.2f	ТАК
Total Average Rating (Середня оцінка за весь час)	%.2f	ТАК	4.16

Підтримувані параметри

Параметр	Назва файлу
App Version Code (Код версії додатка)	..._app_version.csv
Carrier (Оператор)	..._carrier.csv
Country (Країна)	..._country.csv
Device (Пристрій)	..._device.csv
Language (Мова)	..._language.csv
Android OS Version (Версія ОС Android)	..._os_version.csv

Приклад

Якщо ви хочете завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета "com.example.app" у 2014 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /vash/lokalnyi/kataloh

Підписки

Команда

gs://[identyfikator_sehmenta]/financial-stats/subscriptions/subscriptions_[nazva_paketa]_[identyfikator_produktu]_yyyyMM_[parametr].csv

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Date (Дата)	РРРР-ММ-ДД	НІ	2022-01-01 Дата цього замовлення за універсальним часом UTC (у форматі РРРР-ММ-ДД)
Package Name (Назва пакета)	Рядок	НІ	com.example.app
Product ID (Ідентифікатор продукту)	Рядок	НІ	Premium access
Country (Країна)	Рядок	НІ	US, CA тощо
New Subscriptions (Нові підписки)	Число	НІ	1234
Canceled Subscriptions (Скасовані підписки)	Число	НІ	1234
Active Subscriptions (Активні підписки)	Число	НІ	1234
Base Plan ID (Ідентифікатор базового плану)	Рядок	НІ	weekly
Offer ID (Ідентифікатор пропозиції)	Рядок	НІ	spring-offer

Примітка: щоб дізнатися більше про статистику нових, скасованих і активних підписок, перегляньте дані додатка про доходи й покупців.

Підтримувані параметри

Параметр	Назва файлу
Country (Країна)	..._country.csv

 

Конверсії користувачів

Через програмний доступ до звітів про покупців і користувачів, які не видалили додаток, можна отримати дані старої версії звіту про залучення користувачів. Тепер можна використовувати програмний доступ до нового експортованого звіту, що включає дані сторінок Аналіз у Google Play і Аналіз конверсій у Play Console. Новий звіт доступний із березня 2021 року.

Старі звіти було вилучено в жовтні 2021 року.

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

Примітка: з листопада 2019 р. звіт про підписки більше не підтримується. Щоб дізнатися більше, прочитайте про джерела залучення користувачів і систему показників.

Користувачі, які не видалили додаток (старий експортований звіт – доступний до серпня 2021 р.)

Команда

gs://[identyfikator_sehmenta]/acquisition/retained_installers/retained_installers_[nazva_paketa]_yyyyMM_[parametr].csv

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Date (Дата)	РРРР-мм-дд	НІ	Дата, коли користувач відвідав сторінку додатка Примітка. Якщо переглядати параметр "Користувачі, які відкривали сторінку додатка" для кількох днів, кількість може виявитися більшою, ніж у когортах за тиждень або місяць. У когортах за тиждень або місяць кожен відвідувач враховується лише раз, навіть якщо він здійснив кілька відвідувань.
Acquisition Channel (Канал залучення)	Рядок	ТАК	Organic, Google Ads, UTM-Tagged Доступно для параметра "Канал залучення" Примітка. Канал "Play Маркет (звичайний)" містить суму значень рядків "Пошук у Play Маркеті (звичайний)" і "Перегляд у Play Маркеті (звичайний)". Щоб відвідувачі не враховувались у звіті двічі, ігноруйте підсумковий рядок "Play Маркет (звичайний)" або рядки пошуку й перегляду.
Country (Країна)	Рядок	ТАК	Доступно для параметрів "Країна" й "Країна (звичайний Play Маркет)"
UTM source/campaign (Джерело/кампанія UTM)	Рядок	ТАК	Доступно для параметра "Відстежені канали (UTM)"
Keyword (Ключове слово)	Рядок	ТАК	Приклад: "ігри" Доступно для параметра "Пошук у Play Маркеті (звичайний)"
Store Listing Visitors (Користувачі, які відкривали сторінку додатка)	Ціле число	НІ
Installers (Користувачі, які встановили додаток)	Ціле число	НІ
Visitor-to-Installer conversion rate (Коефіцієнт конверсії відвідувачів у користувачів, які встановили додаток)	Десятковий дріб	НІ
Median Visitor to Installer conversion rate benchmark (Контрольний серединний коефіцієнт конверсії відвідувачів у користувачів, які встановили додаток)	Десятковий дріб	ТАК	Не заповнюється із серпня 2019 року. Оновлений набір контрольних показників, обчислених новим способом, доступний на сторінці "Звіти про джерела трафіку". Щоб дізнатися більше, прочитайте розділ Як порівнювати коефіцієнт конверсії для трафіку Play Маркету з аналогами.
Installers retained for 1 day (Користувачі, які не видаляли додаток 1 день)	Ціле число	НІ
Installer-to-1 day retention rate (Коефіцієнт конверсії користувачів, які встановили додаток, у користувачів, які не видаляли його 1 день)	Десятковий дріб	НІ
Installers retained for 7 days (Користувачі, які не видаляли додаток 7 днів)	Ціле число	НІ
Installer-to-7 days retention rate (Коефіцієнт конверсії користувачів, які встановили додаток, у користувачів, які не видаляли його 7 днів)	Десятковий дріб	НІ
Installers retained for 15 days (Користувачі, які не видаляли додаток 15 днів)	Ціле число	НІ
Installer-to-15 days retention rate (Коефіцієнт конверсії користувачів, які встановили додаток, у користувачів, які не видаляли його 15 днів)	Десятковий дріб	НІ
Installers retained for 30 days (Користувачі, які не видаляли додаток 30 днів)	Ціле число	НІ
Installer-to-30 days retention rate (Коефіцієнт конверсії користувачів, які встановили додаток, у користувачів, які не видаляли його 30 днів)	Десятковий дріб	НІ

Підтримувані параметри

Параметр	Назва файлу
Acquisition channel (Канал залучення)*	..._channel.csv
Country (Країна)	..._country.csv
Country (Play Store organic) (Країна (звичайний Play Маркет))	..._play_country.csv
Play Store (organic) search (Пошук у Play Маркеті (звичайний))	..._play_search.csv
Tracked channels (UTM) (Відстежені канали (UTM))	..._utm_tagged.csv

* Примітка. Канал "Play Маркет (звичайний)" містить суму значень рядків "Пошук у Play Маркеті (звичайний)" і "Перегляд у Play Маркеті (звичайний)". Щоб відвідувачі не враховувались у звіті двічі, ігноруйте підсумковий рядок "Play Маркет (звичайний)" або рядки пошуку й перегляду. 

Параметр "Пошук Google (звичайний)" не підтримується з червня 2019 р.

Ефективність сторінок додатків (новий експортований звіт – доступний із березня 2021 р.)

Назви файлів CSV

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

Формат назви файлу: store_performance_[nazva_paketa]_[yyyyMM]_[rozpodil].csv

Примітки

• Назва пакета додається до назви файлу без змін з усіма спеціальними символами (наприклад, "." або "_").
• yyyyMM позначає рік і місяць, наприклад 202101.

Команда

gs://[identyfikator_sehmenta]/stats/store_performance/store_performance_[nazva_paketa]_[yyyyMM]_[rozpodil].csv

Формат файлу

Поле	Формат	Факультативно?	Приклад	Опис
Date (Дата)	РРРР-мм-дд	НІ	2021-01-01	Дата, коли користувач відвідав сторінку додатка
Package name (Назва пакета)	Рядок	НІ	com.example.app	Назва пакета, з якого походять дані звіту
Country/region (Країна або регіон)	Рядок	НІ	UK	Країна або регіон, де зареєстровано обліковий запис Google
Traffic source (Джерело трафіку)	Рядок	НІ	Google Play search	Як користувач потрапив на сторінку додатка: пошук у Google Play перенаправлення зі сторонніх ресурсів перегляд Google Play Примітка. Тут може бути вказано Other, якщо значення не відповідає певним мінімальним вимогам.
Search term (Пошуковий термін)	Рядок	ТАК	app store	Пошуковий термін, який ввів користувач, перед тим як перейшов на сторінку додатка. Доступно лише для пошуку в Google Play. Примітка. Тут може бути вказано Other, якщо значення не відповідає певним мінімальним вимогам.
UTM source (Джерело UTM)	Рядок	ТАК	google	Значення параметра utm_source у URL-адресі, що спрямовує на сторінку вашого додатка. Доступно лише для перенаправлень зі сторонніх ресурсів. Примітка. Тут може бути вказано Other, якщо значення не відповідає певним мінімальним вимогам.
UTM campaign (Кампанія UTM)	Рядок	ТАК	campaign	Значення параметра utm_campaign у URL-адресі, що спрямовує на сторінку вашого додатка. Доступно лише для перенаправлень зі сторонніх ресурсів. Примітка. Тут може бути вказано Other, якщо значення не відповідає певним мінімальним вимогам.
Store listing acquisitions (Конверсії сторінки додатка)	Ціле число	НІ	10	Кількість користувачів, які відкрили сторінку додатка й установили його, не маючи його на інших пристроях
Store listing visitors (Користувачі, які відкривали сторінку додатка)	Ціле число	НІ	100	Кількість користувачів, які відкрили сторінку додатка, не маючи його на своїх пристроях
Store listing conversion rate (Коефіцієнт конверсії сторінки додатка)	Десятковий дріб	НІ	0.1	Відсоток користувачів, які, відкривши сторінку додатка, установили його Примітка: сюди не входять відвідування та встановлення користувачами, які вже мають ваш додаток на інших пристроях

Структура доступних розподілів

Доступні наведені нижче розподіли.

Назва розподілу	Поле в кожному файлі CSV (по порядку)
country Приклад назви файлу: store_performance_com.example.app_202012_country.csv	"Дата", "Назва пакета", "Країна", "Конверсії сторінки додатка", "Користувачі, які відкривали сторінку додатка", "Коефіцієнт конверсії сторінки додатка"
traffic_source Приклад назви файлу: store_performance_com.example.app_202012_traffic_source.csv	"Дата", "Назва пакета", "Джерело трафіку", "Пошуковий термін", "Джерело UTM", "Кампанія UTM", "Конверсії сторінки додатка", "Користувачі, які відкривали сторінку додатка", "Коефіцієнт конверсії сторінки додатка"

 

Схема екранування символів

• Усі подвійні лапки потрібно подвоювати. (" -> "")
• Якщо клітинка таблиці містить символи табуляції, переходи на новий рядок, лапки чи коми, візьміть її вміст у подвійні лапки. (... -> "...")

Приклад

Щоб завантажити із сегмента з ідентифікатором pubsite_prod_rev_0123456789 усі звіти, згенеровані для додатка з назвою пакета com.example.app у 2020 році, введіть таку команду:

gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /vash/lokalnyi/kataloh

Покупці (7 днів після встановлення – звіт доступний до серпня 2021 р.)

Команда

gs://[identyfikator_sehmenta]/acquisition/buyers_7d/buyers_7d_[nazva_paketa]_yyyyMM_[parametr].csv

Формат файлу

Поле	Формат	Факультативно?	Приклади та примітки
Date (Дата)	РРРР-мм-дд	НІ	Дата, коли користувач відвідав сторінку додатка Примітка. Якщо переглядати параметр "Користувачі, які відкривали сторінку додатка" для кількох днів, кількість може виявитися більшою, ніж у когортах за тиждень або місяць. У когортах за тиждень або місяць кожен відвідувач враховується лише раз, навіть якщо він здійснив кілька відвідувань.
Acquisition Channel (Канал залучення)	Рядок	ТАК	Organic, Google Ads, UTM-Tagged Доступно для параметра "Канал залучення" Примітка. Канал "Play Маркет (звичайний)" містить суму значень рядків "Пошук у Play Маркеті (звичайний)" і "Перегляд у Play Маркеті (звичайний)". Щоб відвідувачі не враховувались у звіті двічі, ігноруйте підсумковий рядок "Play Маркет (звичайний)" або рядки пошуку й перегляду.
Country (Країна)	Рядок	ТАК	Доступно для параметрів "Країна" й "Країна (звичайний Play Маркет)"
UTM source/campaign (Джерело/кампанія UTM)	Рядок	ТАК	Доступно для параметра "Відстежені канали (UTM)"
Keyword (Ключове слово)	Рядок	ТАК	Приклад: "ігри" Доступно для параметра "Пошук у Play Маркеті (звичайний)"
Store Listing Visitors (Користувачі, які відкривали сторінку додатка)	Ціле число	НІ
Installers (Користувачі, які встановили додаток)	Ціле число	НІ
Visitor to Installer conversion rate (Коефіцієнт конверсії відвідувачів у користувачів, які встановили додаток)	Десятковий дріб	НІ
Median Visitor to Installer conversion rate benchmark (Контрольний серединний коефіцієнт конверсії відвідувачів у користувачів, які встановили додаток)	Десятковий дріб	ТАК	Не заповнюється із серпня 2019 року. Оновлений набір контрольних показників, обчислених у новий спосіб, доступний на сторінці "Звіти про конверсії користувачів". Щоб дізнатися більше, прочитайте розділ Як порівнювати коефіцієнт конверсії для трафіку Play Маркету з аналогами.
Buyers (Покупці)	Ціле число	НІ
Installer to Buyer conversion rate (Коефіцієнт конверсії користувачів, які встановили додаток, у покупців)	Десятковий дріб	НІ
Repeat Buyers (Постійні покупці)	Ціле число	НІ
Installer to Repeat Buyer conversion rate (Коефіцієнт конверсії користувачів, які встановили додаток, у постійних покупців)	Десятковий дріб	НІ
Buyer to Repeat Buyer conversion rate (Коефіцієнт конверсії покупців у постійних покупців)	Ціле число	НІ

Підтримувані параметри

Параметр	Назва файлу
Acquisition channel (Канал залучення)*	..._channel.csv
Country (Країна)	..._country.csv
Country (Play Store organic) (Країна (звичайний Play Маркет))	..._play_country.csv
Play Store (organic) search (Пошук у Play Маркеті (звичайний))	..._play_search.csv
Tracked channels (UTM) (Відстежені канали (UTM))	..._utm_tagged.csv

* Примітка. Канал "Play Маркет (звичайний)" містить суму значень рядків "Пошук у Play Маркеті (звичайний)" і "Перегляд у Play Маркеті (звичайний)". Щоб відвідувачі не враховувались у звіті двічі, ігноруйте підсумковий рядок "Play Маркет (звичайний)" або рядки пошуку й перегляду. 

Параметр "Пошук Google (звичайний)" не підтримується з червня 2019 р.