Типы отчетов
Подробные отчеты содержат данные об отдельных событиях:
- Отзывы.
- Финансы: предполагаемые продажи, доходы, бонусные товары и покупки с баланса Google Play пользователями из Кореи.
Сводные отчеты содержат статистические данные приложения (средние значения, суммарные показатели за день и т. д.):
- Статистика: установки, сбои, оценки и подписки.
- Источники трафика: пользователи, не удалившие приложение или купившие в нем контент в течение 7 дней после установки, и подписчики.
Как скачать отчеты
- Откройте Play Console.
- Нажмите Скачивание отчетов
и выберите Отзывы, Статистика или Финансы.
- В раскрывающемся меню выберите нужное приложение.
- Укажите год и месяц, за который вам нужен отчет.
и выберите Отзывы, Статистика или Финансы.Примечание. Финансовые отчеты включают данные обо всех приложениях в аккаунте.
Как скачать отчеты из 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).
- Установите инструмент gsutil.
- Для аутентификации используйте аккаунт с доступом к Play Console.
- Если вы впервые используете инструмент gsutil и ещё не размещали проекты в Google Cloud Storage, во время настройки вместо идентификатора проекта введите название приложения.
- Найдите идентификатор сегмента, нажав кнопку Копировать Cloud Storage URI рядом с нужным заголовком в разделе Скачивание отчетов.
- Cloud Storage URI начинается с
pubsite_prod_rev(пример:pubsite_prod_rev_01234567890987654321).
- Cloud Storage URI начинается с
- Чтобы скачать отчеты, используйте команду
gsutil cp.- Другие команды для доступа к отчетам можно найти в документации gsutil.
Отчеты хранятся в каталогах, названных по типу представленных данных. Наименование CSV-файла включает тип отчета, название пакета, период создания и параметр (если применимо).
Шаг 1. Создайте сервисный аккаунт
- Откройте Google Developers Console.
- Выберите проект из раскрывающегося списка или нажмите Создать проект.
- Нажмите на значок "Меню"
> Разрешения > Сервисные аккаунты > Создать сервисный аккаунт.
- Следуйте инструкциям на экране, а затем выберите Создать.
- Скопируйте полученный адрес электронной почты.
- Пример:
accountName@project.iam.gserviceaccount.com.
- Пример:
> Разрешения > Сервисные аккаунты > Создать сервисный аккаунт.Шаг 2. Добавьте созданный аккаунт в Play Console
- Откройте Play Console.
- Нажмите на значок "Настройки"
> Аккаунты и права доступа > Пригласить пользователя.
- Укажите адрес электронной почты, связанный с сервисным аккаунтом.
- Выберите разрешения в зависимости от нужного типа отчетов.
- Совет. Чтобы узнать о разных уровнях доступа и правах пользователей, прочитайте статью Как добавлять пользователей и управлять разрешениями.
- Нажмите Добавить. Созданный аккаунт будет добавлен к основному.
> Аккаунты и права доступа > Пригласить пользователя.Шаг 3. Получите отчеты с помощью вызова API
- Установите клиентскую библиотеку API для нужного языка программирования.
- Включите в код вызов API для межсерверной аутентификации с использованием
OAuth2и запроса разрешений дляOAuth2(https://www.googleapis.com/auth/devstorage.read_only). - Выполните вызовы API, чтобы собрать отчеты.
Ниже приведен пример кода 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).
Этот отчет можно использовать для анализа статистики или тенденций, но не для бухгалтерского учета. В последнем случае вам подойдет отчет о доходах.
Отчеты о предполагаемых продажах и о доходах отличаются по ряду критериев. Например, в отчете о предполагаемых продажах не учитываются налоги, удерживаемые у источника выплаты дохода, и возвратные платежи. Кроме того, он содержит только суммы, уплаченные покупателями в их местной валюте (без конвертации в валюту выплаты).
Команда
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
Формат файла
| Поле | Формат | Необязательное поле | Примеры и примечания |
|---|---|---|---|
|
Номер заказа |
Строка |
Нет |
Идентификаторы заказа на подписку в конце содержат номер цикла продления, например: |
|
Дата списания средств |
Строка |
Нет |
Дата заказа (часовой пояс: UTC; формат: ГГГГ-ММ-ДД). |
|
Время списания средств |
Целое число |
Нет |
Временная метка UNIX для списания средств за заказ с пользователя. Измеряется в секундах UNIX-времени. |
|
Финансовый статус |
Строка |
Нет |
Если вы возвращаете всю сумму заказа после частичного возврата средств:
|
|
Модель устройства |
Строка |
Нет |
Модель устройства Android, на котором была совершена покупка. Для заказов на подписку это устройство, используемое для первоначальной покупки. |
|
Название товара |
Строка |
Нет |
Указанное разработчиком название товара. Отображается на языке покупателя. |
|
Идентификатор продукта |
Строка |
Нет |
Название пакета приложения, в котором был продан товар. |
|
Тип товара |
Строка |
Нет |
|
|
Идентификатор товара |
Строка |
Нет |
Указанный разработчиком уникальный идентификатор товара. |
|
Валюта продажи |
Строка |
Нет |
|
|
Цена товара |
Целое число |
Нет |
Отображается в местной валюте покупателя. Запятая (,) – это разделитель тысяч. |
|
Удержанные налоги |
Целое число |
Да |
Отображается в местной валюте покупателя. Запятая (,) – это разделитель тысяч. |
|
Списанная сумма |
Целое число |
Нет |
Отображается в местной валюте покупателя. Это сумма цены товара и удержанных налогов. Запятая (,) – это разделитель тысяч. |
|
Город покупателя |
Строка |
Да |
Эти данные приводятся только для продаж, по которым вы являетесь зарегистрированным продавцом. |
|
Штат покупателя |
Строка |
Да |
|
|
Почтовый индекс покупателя |
Строка |
Да |
Эти данные приводятся только для продаж, по которым вы являетесь зарегистрированным продавцом. |
|
Страна покупателя |
Строка |
Нет |
|
|
Идентификатор основного плана |
Строка |
Да |
Идентификатор основного плана. Заполняется только для подписок. Подробнее… |
|
Идентификатор предложения |
Строка |
Да |
Идентификатор предложения. Заполняется только для подписок. Подробнее… |
| Идентификатор группы | Целое число | Да |
Уникальный идентификатор присваивается при создании группы аккаунтов. Подробнее… |
| Первый допустимый миллион долларов США | Строка | Да |
Заполняется только после создания группы аккаунтов. Подробнее… |
| Идентификатор промоакции | Строка | Да |
|
| Стоимость купона | Целое число | Да |
Отображается в местной валюте покупателя. Запятая (,) – это разделитель тысяч. Эти данные приводятся только для продаж по программе Play Points с помощью купонов. Подробнее… |
| Скидка | Целое число | Да |
Процент скидки показывает, сколько экономит пользователь, оплачивая покупку баллами Play Points по сравнению с оплатой деньгами. Эти данные приводятся только для продаж по программе Play Points. Подробнее… |
|
Идентификатор рекомендуемого товара |
Целое число |
Да |
Уникальный идентификатор присваивается при создании рекомендуемого товара. Подробнее… |
| Идентификатор эксперимента с ценами | Строка | Да |
Идентификатор эксперимента с ценами и группа эксперимента |
Мы не рекомендуем учитывать количество столбцов в 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
Формат файла
| Поле | Формат | Необязательное поле | Примеры и примечания |
|---|---|---|---|
|
Описание |
Строка |
Нет |
Идентификаторы заказа на подписку в конце содержат номер цикла продления. Например, |
|
Дата транзакции |
Строка |
Нет |
Дата этого заказа по тихоокеанскому времени (в формате МММ ДД, ГГГГ). В дате транзакции может быть указан следующий месяц, так как отчетам присваивается время выпуска. |
|
Время транзакции |
Строка |
Нет |
|
|
Тип налога |
Строка |
Да |
Не заполняется для строк, которые не относятся к налогам. |
|
Тип транзакции |
Строка |
Нет |
|
|
Тип возврата |
Строка |
Да |
Возврат, при котором покупателю возмещается полная стоимость, будет отмечен как Full. Возврат, при котором пользователю возмещается только часть стоимости, будет отмечен как Partial. |
|
Название товара |
Строка |
Нет |
Указанное разработчиком название товара. Отображается на языке покупателя. |
|
Идентификатор продукта |
Строка |
Нет |
Название пакета приложения, в котором был продан товар. |
|
Тип товара |
Целое число |
Нет |
Идентифицирует тип продаваемого товара. 0 – продажа платного приложения, 1 – продажа контента или подписки. |
|
Идентификатор SKU |
Строка |
Нет |
Указанный разработчиком уникальный идентификатор товара. |
|
Аппаратное обеспечение |
Строка |
Нет |
Модель устройства Android, на котором была совершена покупка. Для заказов на подписку это устройство, используемое для первоначальной покупки. |
|
Страна покупателя |
Строка |
Нет |
|
|
Штат покупателя |
Строка |
Да |
|
|
Почтовый индекс покупателя |
Строка |
Да |
|
|
Валюта покупателя |
Строка |
Нет |
|
|
Сумма (в валюте покупателя) |
Целое число |
Нет |
Общая сумма строки этого счета до конвертации валюты. |
|
Курс обмена валюты |
Целое число |
Нет |
Валютный курс, используемый для конвертации сумм покупателя в суммы выплат (в валюте продавца). |
| Валюта продавца | Строка | Нет |
Валюта, в которую был конвертирован заказ. Это местная валюта, в которой производится выплата. |
| Сумма (в валюте продавца) | Целое число | Нет |
Общая сумма строки этого счета после конвертации валюты. |
|
Идентификатор основного плана |
Строка |
Да |
Идентификатор основного плана. Заполняется только для подписок. Подробнее… |
|
Идентификатор предложения |
Строка |
Да |
Идентификатор предложения. Заполняется только для подписок. Подробнее… |
| Идентификатор группы | Целое число | Да |
Уникальный идентификатор присваивается при создании группы аккаунтов. Подробнее… |
| Первый допустимый миллион долларов США | Строка | Да |
Заполняется только после создания группы аккаунтов. Подробнее… |
|
Процент комиссионного сбора |
Целое число |
Да |
|
| Описание комиссионного сбора | Строка | Да |
Информация для расчета комиссионного сбора Google. |
| Идентификатор промоакции | Строка | Да |
Эти данные приводятся только для продаж в рамках программы Play Points и подписки Play Pass. Пометка "PP.C" обозначает заказы, оплаченные с помощью купона Play Points, а "PP.P" – заказы с использованием промоакций на контент в приложении. Заказы, оплаченные баллами Play Points напрямую, также указываются в отчете. Пометка "pass" означает, что заказ был оплачен с помощью подарочного сертификата, предоставленного по подписке Play Pass. |
Мы не рекомендуем учитывать количество столбцов в 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
Формат файла
Даты транзакций указываются по тихоокеанскому времени.
| Поле | Формат | Необязательное поле | Примеры и примечания |
|---|---|---|---|
|
Идентификатор счета |
Строка |
Нет |
Этот идентификатор совпадает с номером счета. |
|
Программа |
Строка |
Да |
Эти значения есть только у строк с информацией о комиссионном сборе Google. |
|
Идентификатор внешней транзакции |
Строка |
Нет |
|
|
Дата транзакции |
Строка |
Нет |
Дата транзакции указывается по тихоокеанскому времени. |
|
Временная метка транзакции |
Целое число |
Нет |
Временная метка 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 |
|
Тип налога |
Строка |
Да |
Это значение есть только у строк с информацией о налоге. |
|
Тип SKU |
Строка |
Нет |
|
|
Идентификатор пакета |
Строка |
Нет |
Название пакета приложения, в котором был продан контент. |
|
Страна продажи |
Строка |
Нет |
|
|
Цена контента без учета налога (в валюте продажи) |
Десятичное число |
Да |
Цена контента в валюте продажи без учета налога. Это значение есть только у строк с информацией о платежах пользователей. |
|
Валюта продажи |
Строка |
Нет |
Местная валюта покупателя. |
|
Сумма к оплате (в валюте продажи) |
Десятичное число |
Да |
Сумма к оплате в валюте продажи. Это значение есть только у строк с информацией о комиссионном сборе Google и налоге. Для списанных сумм число будет положительным, а для возвратов, в том числе частичных, – отрицательным. |
|
Курс обмена валюты |
Десятичное число |
Нет |
Курс, по которому сумма к оплате конвертируется из валюты продажи в валюту платежей. |
|
Валюта платежей |
Строка |
Нет |
|
|
Сумма к оплате (в валюте платежей) |
Десятичное число |
Да |
Сумма к оплате в валюте платежей. Это значение есть только у строк с информацией о комиссионном сборе Google и налоге. Для списанных сумм число будет положительным, а для возвратов, в том числе частичных, – отрицательным. |
|
Идентификатор группы |
Целое число |
Да |
Уникальный идентификатор присваивается при создании группы аккаунтов. Подробнее… |
|
Первый допустимый миллион долларов США |
Строка |
Да |
Заполняется только после создания группы аккаунтов. Подробнее… |
|
Процент комиссионного сбора |
Целое число |
Да |
|
|
Описание комиссионного сбора |
Строка |
Да |
Информация для расчета комиссионного сбора Google. |
Описание
Продавцы в Южной Корее, которые по закону обязаны предоставлять квитанции или самостоятельно зарегистрировались для их выдачи, должны по запросу выписывать квитанции о покупках приложений или контента в них, совершенных с использованием подарочных карт 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
Формат файла
| Поле | Формат | Необязательное поле | Примеры и примечания |
|---|---|---|---|
|
Номер заказа |
Целое число |
Нет |
Идентификаторы заказа на подписку в конце содержат номер цикла продления. Например, |
|
Дата списания средств |
Строка |
Нет |
Дата заказа (часовой пояс: UTC; формат: ГГГГ-ММ-ДД). |
|
Финансовый статус |
Строка |
Нет |
|
|
Сумма покупки с баланса Google Play |
Строка |
Нет |
Сумма транзакции. |
| Валюта баланса 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
Формат файла
| Поле | Формат | Необязательное поле | Примеры и примечания |
|---|---|---|---|
| Дата | ГГГГ-ММ-ДД | Нет |
Дата заказа (часовой пояс: UTC; формат: ГГГГ-ММ-ДД). |
| Название пакета | Строка | Нет | com.example.app |
| Идентификатор продукта | Строка | Нет | Premium access |
| Страна | Строка | Нет |
|
| Новые подписки | Число | Нет | 1234 |
| Отмененные подписки | Число | Нет | 1234 |
| Действующие подписки | Число | Нет | 1234 |
| Идентификатор основного плана | Строка | Нет | weekly |
| Идентификатор предложения | Строка | Нет | spring-offer |
Примечание. Дополнительную информацию о новых, отмененных и действующих подписках можно найти в данных о доходах и покупателях.
Поддерживаемые параметры
| Параметр | Имя файла |
|---|---|
| Страна | …_country.csv |
Источники трафика
Отчеты о пользователях, установивших и не удаливших приложение, а также о покупателях поддерживались в старой версии отчета об источниках трафика. Теперь вместо нее можно использовать программный доступ к новой версии отчета, в которую включены данные страниц Анализ источников трафика и Анализ конверсии в Play Console. Эта версия стала доступна в марте 2021 года.
Старые отчеты были удалены в октябре 2021 года.
Узнайте, как скачать данные об источниках трафика.
Примечание. Поддержка отчета "Подписчики" прекращена с ноября 2019 года. Подробнее об источниках трафика и их показателях…
Команда
gs://[identifikator_segmenta]/acquisition/retained_installers/retained_installers_[nazvanie_paketa]_ggggMM_[parametr].csv
Формат файла
| Поле | Формат | Необязательное поле | Примеры и примечания |
|---|---|---|---|
| Дата | ГГГГ-мм-дд | Нет |
Дата посещения страницы покупателем Примечание. Если уникальные посетители добавляются в список в течение нескольких дней, число просмотров страницы приложения будет больше, чем в недельной и месячной когортах. В недельной и месячной когортах каждый посетитель учитывается один раз, даже если он посещает страницу несколько раз. |
| Источник трафика | Строка | Да |
Для параметра "Источник трафика" Примечание. Значение для канала "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 года.
Названия файлов 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. Примечание. Если показатели не достигают минимальных пороговых значений, будет показан вариант |
| Источник UTM | Строка | Да | Google |
Значение параметра URL "utm_source" в ссылках на контент страницы приложения. Доступно только для сторонних рефералов. Примечание. Если показатели не достигают минимальных пороговых значений, будет показан вариант |
| Кампания UTM | Строка | Да | кампания |
Значение параметра URL "utm_campaign" в ссылках на контент страницы приложения. Доступно только для сторонних рефералов. Примечание. Если показатели не достигают минимальных пороговых значений, будет показан вариантДругое. |
| Источники трафика со страницы приложения | Целое число | Нет | 10 |
Количество пользователей, посетивших страницу вашего приложения в Google Play и установивших его (при условии, что в этот момент оно не было установлено на другом устройстве этого же пользователя). |
| Посетители страницы приложения | Целое число | Нет | 100 |
Количество пользователей, посетивших страницу вашего приложения в Google Play, у которых оно не было установлено ни на одном из устройств. |
| Коэффициент конверсии страницы приложения | Десятичное число | Нет | 0,1 |
Процент посетителей страницы приложения, которые установили его. Примечание. Посещения и установки пользователями, у которых приложение уже есть на другом устройстве, не учитываются. |
Доступная структура разбивки
Доступны следующие варианты:
| Название параметра разбивки | Поля в каждом файле 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
Команда
gs://[identifikator_segmenta]/acquisition/buyers_7d/buyers_7d_[nazvanie_paketa]_ggggMM_[parametr].csv
Формат файла
| Поле | Формат | Необязательное поле | Примеры и примечания |
|---|---|---|---|
| Дата | ГГГГ-мм-дд | Нет |
Дата посещения страницы покупателем Примечание. Если уникальные посетители добавляются в список в течение нескольких дней, число просмотров страницы приложения будет больше, чем в недельной и месячной когортах. В недельной и месячной когортах каждый посетитель учитывается один раз, даже если он посещает страницу несколько раз. |
| Источник трафика | Строка | Да |
Для параметра "Источник трафика" Примечание. Значение для канала "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 года.