Как скачивать и экспортировать ежемесячные отчеты

Возможно, требуется действие: предстоящие изменения в отчетах о доходах и предполагаемых продажах

 

С декабря 2025 года отчеты о доходах и предполагаемых продажах изменятся:

1. В конце обоих документов появится столбец Канал продаж. Так вы сможете получать больше информации о том, где начинаются продажи. Новое поле будет содержать пять следующих значений:
   • In-app – для стандартных транзакций в приложении. Это значение также используется для покупок, сделанных в других приложениях.
   • Play store – для транзакций в Google Play, а также совершенных с помощью программ и инструментов для оплаты.
   • Outside Play store – для транзакций за пределами Google Play.
   • PC emulator – для транзакций в игре, запущенной через эмулятор ПК.
   • Native PC – для всех транзакций, связанных с играми, доступными только на компьютере.
2. Будут переименованы поля и обновлены значения в соответствии с моделью данных контента для однократных покупок. Изменения перечислены ниже:
   • Поле Base Plan ID будет переименовано в Base Plan or Purchase Option ID.
   • В поле Product Type в отчете о доходах целое число будет заменено на строку и будут добавлены следующие значения: Subscription, One-time product и Paid app. Эти значения также появятся в отчете о предполагаемых продажах.
   • Поле Product ID в обоих отчетах будет переименовано в Package ID.

Обновления могут повлиять на автоматизированные процессы работы с данными. Чтобы избежать этого, внимательно ознакомьтесь с информацией об изменениях.

 

В Play Console можно скачивать ежемесячные отчеты со статистикой по каждому приложению.

Типы отчетов

Подробные отчеты

Подробные отчеты содержат данные об отдельных событиях:

• Отзывы.
• Финансы: предполагаемые продажи, доходы, бонусные товары и покупки с баланса Google Play пользователями из Кореи.

Сводные отчеты

Сводные отчеты содержат статистические данные приложения (средние значения, суммарные показатели за день и т. д.):

• Статистика: установки, сбои, оценки и подписки.
• Источники трафика: пользователи, не удалившие приложение или купившие в нем контент в течение семи дней после установки, и подписчики.

Как скачать отчеты

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

Примечание. Финансовые отчеты включают данные обо всех приложениях в аккаунте.

Как скачать отчеты из Google Cloud Storage

Отчеты доступны в Google Cloud Storage. Они создаются ежедневно, и накопленные за месяц данные записываются в CSV-файлы. Отчеты хранятся в закрытом сегменте Google Cloud Storage вашего аккаунта разработчика Google Play.

Отчеты в Google Cloud Storage можно открыть через браузер, а также с помощью приложения gsutil или других инструментов.

Совет. Чтобы импортировать отчеты из Google Cloud Storage в BigQuery, конвертируйте CSV-файлы из UTF-16 в UTF-8.

Где найти Google Cloud Storage URI

Вы можете скопировать Google Cloud Storage URI, нажав кнопку Копировать Cloud Storage URI рядом с нужным заголовком в разделе Скачивание отчетов.

Cloud Storage URI начинается с pubsite_prod_rev (пример: pubsite_prod_rev_01234567890987654321).

Как скачать отчеты с помощью инструмента командной строки

1. Установите инструмент gsutil.
   • Для аутентификации используйте аккаунт с доступом к Play Console.
   • Если вы впервые используете инструмент gsutil и ещё не размещали проекты в Google Cloud Storage, во время настройки вместо идентификатора проекта введите название приложения.
2. Найдите идентификатор сегмента, нажав кнопку Копировать Cloud Storage URI рядом с нужным заголовком в разделе Скачивание отчетов.
   • Cloud Storage URI начинается с pubsite_prod_rev (пример: pubsite_prod_rev_01234567890987654321).
3. Чтобы скачать отчеты, используйте команду gsutil cp.
   • Другие команды для доступа к отчетам можно найти в документации gsutil.

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

Как скачать отчеты с помощью клиентской библиотеки и сервисного аккаунта

Шаг 1. Создайте сервисный аккаунт

1. Откройте Google Developers Console.
2. Выберите проект из раскрывающегося списка или нажмите Создать проект.
3. Нажмите на значок "Меню" > Разрешения > Сервисные аккаунты > Создать сервисный аккаунт.
4. Следуйте инструкциям на экране, а затем выберите Создать.
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 = 'путь к файлу JSON, полученный при создании сервисного аккаунта'

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://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Название пакета	Строка	Нет	com.company.app
Код версии приложения	Целое число	Да	Только рабочие версии APK-файлов
Название версии приложения	Строка	Да
Язык отзыва	Строка (ISO 639-1, двухбуквенная аббревиатура)	Да	ru
Устройство	Строка	Да	hammerhead
Дата и время публикации отзыва	ISO_8601, включая время, часовой пояс UTC	Нет	2014-06-19T19:12:32Z
Миллисекунды UNIX-времени публикации отзыва	Целое число, миллисекунды UNIX-времени	Нет
Дата и время последнего обновления отзыва	ISO_8601, включая время, часовой пояс UTC	Да	2014-06-19T19:12:32Z
Миллисекунды UNIX-времени последнего обновления отзыва	Целое число, миллисекунды UNIX-времени	Да
Оценка	Целое число (от 1 до 5)	Нет
Название отзыва	Строка на родном языке пользователя (исключение символа перевода строки)	Да
Текст отзыва	Строка на родном языке пользователя (исключение символа перевода строки)	Да
Дата и время ответа разработчика	ISO_8601, включая время, часовой пояс UTC	Да	2014-06-19T19:12:32Z
Миллисекунды UNIX-времени ответа разработчика	Целое число, миллисекунды UNIX-времени	Да
Текст ответа разработчика	Строка (исключение символа перевода строки и уплотнение пробела)	Да
Ссылка на отзыв	Строка	Да	https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>

Пример

Чтобы скачать все отчеты за 2014 год из сегмента с идентификатором pubsite_prod_rev_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /vash/localny/katalog

Финансовые отчеты

Предполагаемый объем продаж

Мы не рекомендуем учитывать количество столбцов в CSV-файле при работе с автоматизированными отчетами.

Описание

В отчете о предполагаемых продажах приведены свежие данные о продажах приложения, контента или подписки. Он содержит суммы, уплаченные покупателями (без вычета налогов и комиссионных сборов Google).

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

Отчеты о предполагаемых продажах и о доходах отличаются по ряду критериев. Например, в отчете о предполагаемых продажах не учитываются налоги, удерживаемые у источника выплаты дохода, и возвратные платежи. Кроме того, он содержит только суммы, уплаченные покупателями в их местной валюте (без конвертации в валюту выплаты).

Примечание. Получить информацию о заказе также можно с помощью Orders API.

Команда

gs://[identifikator_segmenta]/sales/salesreport_GGGGMM.zip

Пример

Чтобы скачать все отчеты за 2014 год из сегмента с идентификатором pubsite_prod_rev_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /vash/localny/katalog

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Номер заказа	Строка	Нет	GPA.1234-1234-1234-12345 Идентификаторы заказа на подписку в конце содержат номер цикла продления, например: GPA.1234-1234-1234-12345..0 для первого цикла, GPA.1234-1234-1234-12345..1 для второго и т. д.
Дата списания средств	Строка	Нет	2016-11-30 Дата заказа (часовой пояс: UTC; формат: ГГГГ-ММ-ДД).
Время списания средств	Целое число	Нет	1480507200 Временная метка UNIX для списания средств за заказ с пользователя. Измеряется в секундах UNIX-времени.
Финансовый статус	Строка	Нет	charged, refund, partial refund и т. д. Если вы возвращаете всю сумму заказа после частичного возврата средств: Частичный возврат средств отобразится в отдельной строке. В строке полного возврата будет указан остаток средств.
Модель устройства	Строка	Нет	mako и т. д. Модель устройства Android, на котором была совершена покупка. Для заказов на подписку это устройство, используемое для первоначальной покупки.
Название товара	Строка	Нет	coins, monthly subscription и т. д. Выбранное разработчиком название товара. Показывается на языке покупателя.
Идентификатор пакета	Строка	Нет	com.example.app Название пакета приложения, в котором был продан товар.
Тип товара	Строка	Нет	Subscription, One-time product, Paid app Тип товара.
Код товара	Строка	Нет	treasure_chest_for_new_users Указанный разработчиком уникальный идентификатор товара.
Валюта продажи	Строка	Нет	USD, EUR, THB и т. д.
Цена товара	Целое число	Нет	12,345.67 Отображается в местной валюте покупателя. Запятая (,) – это разделитель тысяч.
Удержанные налоги	Целое число	Да	12,345.67 Отображается в местной валюте покупателя. Запятая (,) – это разделитель тысяч.
Списанная сумма	Целое число	Нет	12,345.67 Отображается в местной валюте покупателя. Это сумма цены товара и удержанных налогов. Запятая (,) – это разделитель тысяч.
Город покупателя	Строка	Да	Boston, Toronto и т. д. Эти данные приводятся только для продаж, по которым вы являетесь зарегистрированным продавцом.
Штат покупателя	Строка	Да	MA, ON и т. д.
Почтовый индекс покупателя	Строка	Да	02140, M5B 1L6 и т. д. Эти данные приводятся только для продаж, по которым вы являетесь зарегистрированным продавцом.
Страна покупателя	Строка	Нет	US, CA и т. д.
Идентификатор основного плана или способа покупки	Строка	Да	weekly Идентификатор основного тарифного плана. Подробнее… Идентификатор способа, которым приобретается контент для однократных покупок. Подробнее…
Идентификатор предложения	Строка	Да	spring-offer Идентификатор предложения, относящегося к подписке. Подробнее… Идентификатор предложения, относящегося к контенту для однократных покупок. Подробнее…
Идентификатор группы	Целое число	Да	1234567891234567890 Уникальный идентификатор присваивается при создании группы аккаунтов. Подробнее…
Первый допустимый миллион долларов США	Строка	Да	Да, Нет Заполняется только после создания группы аккаунтов. Подробнее…
Идентификатор промоакции	Строка	Да	PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, Points used only Эти данные приводятся только для продаж по программе Play Points. Пометка "PP.C" обозначает заказы, оплаченные с помощью купона, а "PP.P" – заказы с использованием промоакций на контент в приложении. Заказы, оплаченные баллами Play Points напрямую, также указываются в отчете. Подробнее…
Стоимость купона	Целое число	Да	3,00 Отображается в местной валюте покупателя. Запятая (,) – это разделитель тысяч. Эти данные приводятся только для продаж по программе Play Points с помощью купонов. Подробнее…
Скидка	Целое число	Да	45, 55, 70 Процент скидки показывает, сколько экономит пользователь, оплачивая покупку баллами Play Points по сравнению с оплатой деньгами. Эти данные приводятся только для продаж по программе Play Points. Подробнее…
Идентификатор рекомендуемого товара	Целое число	Да	1234567891234567890 Уникальный идентификатор присваивается при создании рекомендуемого товара. Подробнее…
Идентификатор эксперимента с ценами	Строка	Да	5697329857888256 (вариант B) Идентификатор ценового эксперимента и группа эксперимента.
Канал продаж	Строка	Да	In-app, PC emulator, Native PC, Play store, Outside Play store Где была совершена транзакция. Для возобновляемых платных подписок это поле будет пустым.

Доходы

Мы не рекомендуем учитывать количество столбцов в CSV-файле при работе с автоматизированными отчетами.

Описание

В отчете о доходах приведены данные о выплатах и транзакциях. Каждая строка отчета содержит сумму транзакции определенного типа (например, сумму, уплаченную покупателем, или оплату комиссии Google) в валюте оплаты и конвертированную.

В отчетах о доходах указаны транзакции за предыдущий месяц. Выплата по счету производится через несколько недель после получения отчета о доходах.

Отчеты создаются ежемесячно и обычно становятся доступны 5-го числа следующего месяца. Иногда Google может вносить корректировки в отчет о доходах, чтобы исправлять ошибки в вычислениях. Мы сообщим вам, если сделаем это, и создадим дополнительный файл с информацией о доходах. Он будет содержать сведения только об исправленных транзакциях.

Примечания

• Информация о комиссии Google теперь доступна для всех транзакций вне зависимости от того, является ли компания Google зарегистрированным продавцом продуктов.
• В отчет о доходах не включаются возвратные платежи.
• Каждый месяц для отчета о доходах создается отдельный файл.
• Налог, удерживаемый у источника выплаты дохода, на Тайване должен быть оплачен за месяц до того, как о нем будет заявлено.

Команда

gs://[identifikator_segmenta]/earnings/earnings_GGGGMM.zip

Пример

Чтобы скачать все отчеты за 2014 год из сегмента с идентификатором pubsite_prod_rev_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /vash/localny/katalog

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Описание	Строка	Нет	GPA.1234-1234-1234-12345 Идентификаторы заказа на подписку в конце содержат номер цикла продления. Например, GPA.1234-1234-1234-12345..0 для первого цикла, GPA.1234-1234-1234-12345..1 для второго и т. д.
Дата транзакции	Строка	Нет	Nov 30, 2016 Дата этого заказа по тихоокеанскому времени (в формате МММ ДД, ГГГГ). В дате транзакции может быть указан следующий месяц, так как отчетам присваивается время выпуска.
Время транзакции	Строка	Нет	12:00:00 PDT
Тип налога	Строка	Да	Third-party tax Не заполняется для строк, которые не относятся к налогам.
Тип транзакции	Строка	Нет	Charge, Google fee, Tax, Charge refund, Google fee refund, Charge rebill, Tax rebill, Google fee rebill, Adjustment
Тип возврата	Строка	Да	Full, Partial Возврат, при котором покупателю возмещается полная стоимость, будет отмечен как Full. Возврат, при котором пользователю возмещается только часть стоимости, будет отмечен как Partial.
Название товара	Строка	Нет	coins, monthly subscription и т. д. Выбранное разработчиком название товара. Показывается на языке покупателя.
Идентификатор пакета	Строка	Нет	com.example.app Название пакета приложения, в котором был продан товар.
Тип товара	Строка	Нет	Subscription, One-time product, Paid app Тип товара.
Код товара	Строка	Нет	treasure_chest_for_new_users Указанный разработчиком уникальный идентификатор товара.
Аппаратное обеспечение	Строка	Нет	mako и т. д. Модель устройства Android, на котором была совершена покупка. Для заказов на подписку это устройство, используемое для первоначальной покупки.
Страна покупателя	Строка	Нет	US, CA и т. д.
Штат покупателя	Строка	Да	MA, ON и т. д.
Почтовый индекс покупателя	Строка	Да	02140, M5B 1L6 и т. д.
Валюта покупателя	Строка	Нет	USD, EUR, THB и т. д.
Сумма (в валюте покупателя)	Целое число	Нет	12345.67 Общая сумма строки этого счета до конвертации валюты.
Курс обмена валюты	Целое число	Нет	0.56789 Валютный курс, используемый для конвертации сумм покупателя в суммы выплат (в валюте продавца).
Валюта продавца	Строка	Нет	USD, EUR, THB и т. д. Валюта, в которую был конвертирован заказ. Это местная валюта, в которой производится выплата.
Сумма (в валюте продавца)	Целое число	Нет	12345.67 Общая сумма строки этого счета после конвертации валюты.
Идентификатор основного плана или способа покупки	Строка	Да	weekly Идентификатор основного тарифного плана. Подробнее… Идентификатор способа, которым приобретается контент для однократных покупок. Подробнее…
Идентификатор предложения	Строка	Да	spring-offer Идентификатор предложения, относящегося к подписке. Подробнее… Идентификатор предложения, относящегося к контенту для однократных покупок. Подробнее…
Идентификатор группы	Целое число	Да	1234567891234567890 Уникальный идентификатор присваивается при создании группы аккаунтов. Подробнее…
Первый допустимый миллион долларов США	Строка	Да	Да, Нет Заполняется только после создания группы аккаунтов. Подробнее…
Процент комиссионного сбора	Целое число	Да	15, 30
Описание комиссионного сбора	Строка	Да	SUBSCRIPTIONS Информация для расчета комиссионного сбора Google.
Идентификатор промоакции	Строка	Да	PP.C_x0a08trvC1, PP.PdYfn342Ox10, pass-QbTfn350O810 (для Play Points и Play Pass) Эти данные приводятся только для продаж в рамках программы Play Points и подписки Play Pass. Пометка "PP.C" обозначает заказы, оплаченные с помощью купона Play Points, а "PP.P" – заказы с использованием промоакций на контент в приложении. Заказы, оплаченные баллами Play Points напрямую, также указываются в отчете. Пометка "pass" означает, что заказ был оплачен с помощью подарочного сертификата, предоставленного по подписке Play Pass.
Канал продаж	Строка	Да	In-app, PC emulator, Native PC, Play store, Outside Play store Где была совершена транзакция. Для возобновляемых платных подписок это поле будет пустым.

Оплата по выставленным счетам

Мы не рекомендуем учитывать количество столбцов в CSV-файле при работе с автоматизированными отчетами.

Описание

Если вы зарегистрированы в программе альтернативных платежных систем или внешних предложений и уже отправляли данные о транзакциях в Google Play, то можете найти подробную информацию об этих операциях и взимаемом комиссионном сборе Google в отчетах об оплате по выставленным счетам.

Отчет об оплате по выставленным счетам – это CSV-файл со сведениями о транзакциях за предыдущий месяц, для каждой из которых указан платеж пользователя, размер комиссионного сбора Google и налог (если применимо). Информация о проценте комиссионного сбора и курсе обмена валюты приводится для того, чтобы было понятнее, как рассчитывается приведенная в счете сумма.

Примечания

• Отчеты создаются ежемесячно и обычно становятся доступны 5-го числа следующего месяца.
• Из отчетов исключается информация о комиссионном сборе Google и налогах, размер которых после округления равен нулю в валюте платежей.

Команда

gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory

Пример

Чтобы скачать все отчеты за 2024 год из сегмента с идентификатором pubsite_prod_rev_0123456789, используйте следующую команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory

Формат файла

Даты транзакций указываются по тихоокеанскому времени.

Поле	Формат	Необязательное поле	Примеры и примечания
Идентификатор счета	Строка	Нет	1234567890 Этот идентификатор совпадает с номером счета.
Программа	Строка	Да	User Choice Billing, Alternative Billing Only, External Offers Эти значения есть только у строк с информацией о комиссионном сборе Google.
Идентификатор внешней транзакции	Строка	Нет	com.example.app:1a2b3c4e5f
Дата транзакции	Строка	Нет	July 1, 2024 Дата транзакции указывается по тихоокеанскому времени.
Временная метка транзакции	Целое число	Нет	1719849600 Временная метка Unix для транзакции. Измеряется в секундах от начала отсчета.
Тип транзакции	Строка	Нет	User charge, Google fee, Tax, User charge refund, Google fee refund, Tax refund, User charge partial refund, Google fee partial refund, Tax partial refund
Тип налога	Строка	Да	VAT / GST Это значение есть только у строк с информацией о налоге.
Тип SKU	Строка	Нет	In-app product, Subscription
Идентификатор пакета	Строка	Нет	com.example.app Название пакета приложения, в котором был продан контент.
Страна продажи	Строка	Нет	US, KR и т. д.
Цена контента без учета налога (в валюте продажи)	Десятичное число	Да	12.34 Цена контента в валюте продажи без учета налога. Это значение есть только у строк с информацией о платежах пользователей.
Валюта продажи	Строка	Нет	USD, KRW и т. д. Местная валюта покупателя.
Сумма к оплате (в валюте продажи)	Десятичное число	Да	1.23 или -1.23 Сумма к оплате в валюте продажи. Это значение есть только у строк с информацией о комиссионном сборе Google и налоге. Для списанных сумм число будет положительным, а для возвратов, в том числе частичных, – отрицательным.
Курс обмена валюты	Десятичное число	Нет	1.076 Курс, по которому сумма к оплате конвертируется из валюты продажи в валюту платежей.
Валюта платежей	Строка	Нет	USD, EUR и т. д.
Сумма к оплате (в валюте платежей)	Десятичное число	Да	1.32 Сумма к оплате в валюте платежей. Это значение есть только у строк с информацией о комиссионном сборе Google и налоге. Для списанных сумм число будет положительным, а для возвратов, в том числе частичных, – отрицательным.
Идентификатор группы	Целое число	Да	1234567891234567890 Уникальный идентификатор присваивается при создании группы аккаунтов. Подробнее…
Первый допустимый миллион долларов США	Строка	Да	Yes, No Заполняется только после создания группы аккаунтов. Подробнее…
Процент комиссионного сбора	Целое число	Да	11, 26 и т. д.
Описание комиссионного сбора	Строка	Да	SUBSCRIPTIONS, MEDIA_PARTNERSHIPS и т. д. Информация для расчета комиссионного сбора Google.

Покупки с баланса Google Play пользователями из Кореи

Описание

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

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

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

Команда

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

Пример

Чтобы скачать все отчеты за 2018 год из сегмента с идентификатором pubsite_prod_rev_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Номер заказа	Целое число	Нет	GPA.1234-1234-1234-12345 Идентификаторы заказа на подписку в конце содержат номер цикла продления, например: GPA.1234-1234-1234-12345..0 для первого цикла, GPA.1234-1234-1234-12345..1 для второго и т. д.
Дата списания средств	Строка	Нет	2016-11-30 Дата заказа (часовой пояс: UTC; формат: ГГГГ-ММ-ДД).
Финансовый статус	Строка	Нет	Charged, Refund и т. д.
Сумма покупки с баланса Google Play	Строка	Нет	12,345.67 Сумма транзакции.
Валюта баланса Google Play	Строка	Нет	KRW Для отчетов о покупках с баланса Google Play пользователями из Кореи это всегда южнокорейская вона (KRW).
Время списания средств	Целое число	Нет	1480507200 Временная метка UNIX для списания средств за заказ с пользователя. Измеряется в секундах от начала отсчета.

Подписки

Ответы на вопросы при отмене подписки

Команда

gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Дата отмены	Строка	Нет	2016-11-30
Идентификатор SKU	Строка	Да	treasure_chest_for_new_users Указанный разработчиком уникальный идентификатор товара.
Страна	Строка	Нет	US, CA и т. д.
Ответ	Строка	Нет

Команды и форматы файлов для сводных отчетов

Статистика

Установки

Команда

gs://[identifikator_segmenta]/stats/installs/installs_[nazvanie_paketa]_ggggMM_[parametr].csv

Формат файла

Поле	Формат	Необязательное поле	Пример
Дата	ГГГГ-мм-дд	Нет	2014-06-19
Название пакета	Строка	Нет	com.my.app
Устройство (или другой поддерживаемый параметр)	Строка	Да	hammerhead
Установки на данный момент (устройства)	Целое число	Нет
Установки на активных устройствах	Целое число	Нет
Установки за день (все устройства)	Целое число	Нет
Удаления за день (все устройства)	Целое число	Нет
Обновления за день (все устройства)	Целое число	Нет
Установки на данный момент (пользователи)	Целое число	Нет
Общее количество установок (все пользователи)	Целое число	Нет
Установки за день (все пользователи)	Целое число	Нет
Удаления за день (все пользователи)	Целое число	Нет

Поддерживаемые параметры

Параметр	Имя файла
Код версии приложения	..._app_version.csv
Оператор	..._carrier.csv
Страна	…_country.csv
Устройство	..._device.csv
Язык	..._language.csv
Версия Android	..._os_version.csv

Пример

Чтобы скачать все отчеты за 2014 год из сегмента с идентификатором pubsite_prod_rev_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

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

Сбои

Примечание. С января 2018 года в экспорт включаются сведения из нового источника данных, которые соответствуют информации на странице Статистика. До января 2018 года были доступны только сведения из предыдущего источника данных.

Команда

gs://[identifikator_segmenta]/stats/crashes/crashes_[nazvanie_paketa]_ggggMM_[parametr].csv

Формат файла

Поле	Формат	Необязательное поле	Пример
Дата	ГГГГ-мм-дд	Нет	2014-06-19
Название пакета	Строка	Нет	com.my.app
Устройство (или другой поддерживаемый параметр)	Строка	Да	hammerhead
Сбои за день	Целое число	Нет
ANR за день	Целое число	Нет

Поддерживаемые параметры

Параметр	Имя файла
Код версии приложения	..._app_version.csv
Устройство	..._device.csv
Версия Android	..._os_version.csv

Пример

Чтобы скачать все отчеты за 2014 год из сегмента с идентификатором pubsite_prod_rev_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

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

Оценки

Команда

gs://[identifikator_segmenta]/stats/ratings/ratings_[nazvanie_paketa]_ggggMM_[parametr].csv

Формат файла

Поле	Формат	Необязательное поле	Пример
Дата	ГГГГ-мм-дд	Нет	2014-06-19
Название пакета	Строка	Нет	com.my.app
Устройство (или другой поддерживаемый параметр)	Строка	Да	hammerhead
Средняя оценка за день	%.2f	Да
Общая средняя оценка	%.2f	Да	4,16

Поддерживаемые параметры

Параметр	Имя файла
Код версии приложения	..._app_version.csv
Оператор	..._carrier.csv
Страна	…_country.csv
Устройство	..._device.csv
Язык	..._language.csv
Версия Android	..._os_version.csv

Пример

Чтобы скачать все отчеты за 2014 год из сегмента с идентификатором pubsite_prod_rev_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

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

Подписки

Команда

gs://[identifikator_segmenta]/financial-stats/subscriptions/subscriptions_[nazvanie_paketa]_[identifikator_tovara]_ggggMM_[parametr].csv

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Дата	ГГГГ-ММ-ДД	Нет	2022-01-01 Дата заказа (часовой пояс: UTC; формат: ГГГГ-ММ-ДД).
Название пакета	Строка	Нет	com.example.app
Идентификатор продукта	Строка	Нет	Premium access
Страна	Строка	Нет	US, CA и т. д.
Новые подписки	Число	Нет	1234
Отмененные подписки	Число	Нет	1234
Действующие подписки	Число	Нет	1234
Идентификатор основного плана	Строка	Нет	weekly
Идентификатор предложения	Строка	Нет	spring-offer

Примечание. Дополнительную информацию о новых, отмененных и действующих подписках можно найти в данных о доходах и покупателях.

Поддерживаемые параметры

Параметр	Имя файла
Страна	…_country.csv

Источники трафика

Отчеты о пользователях, установивших и не удаливших приложение, а также о покупателях поддерживались в старой версии отчета об источниках трафика. Теперь вместо нее можно использовать программный доступ к новой версии отчета, в которую включены данные страниц Анализ источников трафика и Анализ конверсии в Play Console. Эта версия стала доступна в марте 2021 года.

Старые отчеты были удалены в октябре 2021 года.

Узнайте, как скачать данные об источниках трафика.

Примечание. Поддержка отчета "Подписчики" прекращена с ноября 2019 года. Подробнее об источниках трафика и их показателях…

Пользователи, установившие и не удалившие приложение (экспорт в старой версии доступен до августа 2021 года)

Команда

gs://[identifikator_segmenta]/acquisition/retained_installers/retained_installers_[nazvanie_paketa]_ggggMM_[parametr].csv

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Дата	ГГГГ-мм-дд	Нет	Дата посещения страницы покупателем Примечание. Если уникальные посетители добавляются в список в течение нескольких дней, число просмотров страницы приложения будет больше, чем в недельной и месячной когортах. В недельной и месячной когортах каждый посетитель учитывается один раз, даже если он посещает страницу несколько раз.
Источник трафика	Строка	Да	Обычный поиск, Google Реклама, UTM-ссылка Для параметра "Источник трафика" Примечание. Значение для канала "Google Play (обычный)" – это сумма значений "Обычный поиск в Google Play" и "Обычный просмотр в Google Play". Чтобы посетители учитывались только по одному разу, исключите строку "Google Play (обычный)" или строки со значениями для поиска и обзора.
Страна	Строка	Да	Для параметров "Страна" и "Страна (Google Play, обычный)"
Источник/кампания UTM	Строка	Да	Для параметра "Отслеживаемые каналы (UTM)"
Ключевое слово	Строка	Да	Например, "игры" Для параметра "Обычный поиск в Google Play"
Посетители страницы приложения	Целое число	Нет
Установки	Целое число	Нет
Коэффициент конверсии посетителей в пользователей, установивших приложение	Десятичное число	Нет
Контрольный медианный коэффициент конверсии посетителей в пользователей, установивших приложение	Десятичное число	Да	По состоянию на август 2019 года данные не сформированы. Обновленный набор контрольных показателей на базе новых расчетов доступен на странице отчетов об источниках трафика. Дополнительную информацию можно найти в статье Сравнение коэффициента конверсии с группой аналогов в Google Play.
Количество пользователей, установивших приложение и не удаливших его в течение 1 дня	Целое число	Нет
Соотношение количества пользователей, установивших приложение, и пользователей, не удаливших его в течение 1 дня	Десятичное число	Нет
Количество пользователей, установивших приложение и не удаливших его в течение 7 дней	Целое число	Нет
Соотношение количества пользователей, установивших приложение, и пользователей, не удаливших его в течение 7 дней	Десятичное число	Нет
Количество пользователей, установивших приложение и не удаливших его в течение 15 дней	Целое число	Нет
Соотношение количества пользователей, установивших приложение, и пользователей, не удаливших его в течение 15 дней	Десятичное число	Нет
Количество пользователей, установивших приложение и не удаливших его в течение 30 дней	Целое число	Нет
Соотношение количества пользователей, установивших приложение, и пользователей, не удаливших его в течение 30 дней	Десятичное число	Нет

Поддерживаемые параметры

Параметр	Имя файла
Источник трафика*	..._channel.csv
Страна	…_country.csv
Страна (Google Play, обычный)	..._play_country.csv
Обычный поиск в Google Play	..._play_search.csv
Отслеживаемые каналы (UTM)	..._utm_tagged.csv

*Примечание. Значение для канала "Google Play (обычный)" – это сумма значений "Обычный поиск в Google Play" и "Обычный просмотр в Google Play". Чтобы посетители учитывались только по одному разу, исключите строку "Google Play (обычный)" или строки со значениями для поиска и просмотра.

Поддержка параметра "Google Поиск (обычный)" прекращена с июня 2019 года.

Эффективность страницы приложения (отчет в новой версии доступен с марта 2021 года)

Названия файлов CSV

Каждый файл CSV содержит информацию за один месяц с разбивкой по различным параметрам. Названия файлов отражают то, за какой год и месяц в них представлены данные, а также то, по какому параметру разбит отчет. Названия составляются по следующей схеме:

Формат названия файла: store_performance_[package_name]_[yyyyMM]_[breakdown].csv

Примечания

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

Команда

gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv

Формат файла

Поле	Формат	Необязательное поле	Пример	Описание
Дата	ГГГГ-мм-дд	Нет	2021-01-01	Дата посещения страницы покупателем
Название пакета	Строка	Нет	com.example.app	Название пакета, содержащего данные отчета
Страна/регион	Строка	Нет	Великобритания	Страна или регион, где зарегистрирован аккаунт Google пользователя.
Источник трафика	Строка	Нет	Поиск в Google Play	Показывает, как пользователь попал на страницу приложения. Поиск в Google Play Сторонние рефералы Интересное в Google Play Примечание. Если показатели не достигают минимальных пороговых значений, будет показан вариант Другое.
Поисковый запрос	Строка	Да	магазин приложений	Поисковый запрос пользователя, который привел его на страницу приложения. Доступно только для поиска в Google Play. Примечание. Если показатели не достигают минимальных пороговых значений, будет показан вариант Другое.
Источник UTM	Строка	Да	Google	Значение параметра URL "utm_source" в ссылках на контент страницы приложения. Доступно только для сторонних рефералов. Примечание. Если показатели не достигают минимальных пороговых значений, будет показан вариант Другое.
Кампания UTM	Строка	Да	кампания	Значение параметра URL "utm_campaign" в ссылках на контент страницы приложения. Доступно только для сторонних рефералов. Примечание. Если показатели не достигают минимальных пороговых значений, будет показан вариант Другое.
Источники трафика со страницы приложения	Целое число	Нет	10	Количество пользователей, посетивших страницу вашего приложения в Google Play и установивших его (при условии, что в этот момент оно не было установлено на другом устройстве этого же пользователя).
Посетители страницы приложения	Целое число	Нет	100	Количество пользователей, посетивших страницу вашего приложения в Google Play, у которых оно не было установлено ни на одном из устройств.
Коэффициент конверсии страницы приложения	Десятичное число	Нет	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, Источники трафика со страницы приложения, Число просмотров страницы приложения, Коэффициент конверсии страницы приложения

 

Схема экранирования

• Удвоить двойные кавычки (" -> "").
• Если ячейка содержит табуляцию, переносы строк, двойные кавычки или запятые, поставить двойные кавычки вокруг нее (... -> "...").

Пример

Чтобы скачать все отчеты за 2020 год из сегмента с идентификатором pubsite_prod_0123456789 для приложения с названием пакета com.example.app, используйте следующую команду:

gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory

Покупатели (7 дней после установки — доступно до августа 2021 года)

Команда

gs://[identifikator_segmenta]/acquisition/buyers_7d/buyers_7d_[nazvanie_paketa]_ggggMM_[parametr].csv

Формат файла

Поле	Формат	Необязательное поле	Примеры и примечания
Дата	ГГГГ-мм-дд	Нет	Дата посещения страницы покупателем Примечание. Если уникальные посетители добавляются в список в течение нескольких дней, число просмотров страницы приложения будет больше, чем в недельной и месячной когортах. В недельной и месячной когортах каждый посетитель учитывается один раз, даже если он посещает страницу несколько раз.
Источник трафика	Строка	Да	Обычный поиск, Google Реклама, UTM-ссылка Для параметра "Источник трафика" Примечание. Значение для канала "Google Play (обычный)" – это сумма значений "Обычный поиск в Google Play" и "Обычный просмотр в Google Play". Чтобы посетители учитывались только по одному разу, исключите строку "Google Play (обычный)" или строки со значениями для поиска и обзора.
Страна	Строка	Да	Для параметров "Страна" и "Страна (Google Play, обычный)"
Источник/кампания UTM	Строка	Да	Для параметра "Отслеживаемые каналы (UTM)"
Ключевое слово	Строка	Да	Например, "игры" Для параметра "Обычный поиск в Google Play"
Посетители страницы приложения	Целое число	Нет
Установки	Целое число	Нет
Коэффициент конверсии посетителей в пользователей, установивших приложение	Десятичное число	Нет
Контрольный медианный коэффициент конверсии посетителей в пользователей, установивших приложение	Десятичное число	Да	По состоянию на август 2019 года данные не сформированы. Обновленный набор контрольных показателей на базе новых расчетов доступен на странице отчетов об источниках трафика. Дополнительную информацию можно найти в статье Сравнение коэффициента конверсии с группой аналогов в Google Play.
Покупатели	Целое число	Нет
Коэффициент конверсии пользователей, установивших приложение, в покупателей	Десятичное число	Нет
Повторные покупатели	Целое число	Нет
Коэффициент конверсии пользователей, установивших приложение, в повторных покупателей	Десятичное число	Нет
Коэффициент конверсии покупателей в повторных покупателей	Целое число	Нет

Поддерживаемые параметры

Параметр	Имя файла
Источник трафика*	..._channel.csv
Страна	…_country.csv
Страна (Google Play, обычный)	..._play_country.csv
Обычный поиск в Google Play	..._play_search.csv
Отслеживаемые каналы (UTM)	..._utm_tagged.csv

*Примечание. Значение для канала "Google Play (обычный)" – это сумма значений "Обычный поиск в Google Play" и "Обычный просмотр в Google Play". Чтобы посетители учитывались только по одному разу, исключите строку "Google Play (обычный)" или строки со значениями для поиска и просмотра.

Поддержка параметра "Google Поиск (обычный)" прекращена с июня 2019 года.