Интеграция игровой статистики

В этом документе объясняется, как интегрировать игровую статистику в вашу игру с помощью Google Play Console. В нем рассматриваются основные форматы файлов CSV и ZIP, а также описывается, как создавать, импортировать и управлять ими.

Создание или импорт событий

Существует два способа впервые добавить события с помощью Google Play Console:

• Создание события : добавляйте по одному событию за раз.
• Импорт событий : Импорт нескольких событий.

Создать событие

Чтобы создать событие для игры, выполните следующие шаги:

1. В консоли Google Play выберите игру.
2. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Добавить событие» > «Создать событие» .
3. На странице «Создать мероприятие» заполните форму.
4. Нажмите «Сохранить изменения» .

Импорт событий

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

1. Создайте CSV-файл с событиями PlayerGameEvent.csv .
2. В консоли Google Play выберите игру.
3. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Добавить событие» > «Импорт через CSV» .
4. На странице настроек событий перетащите CSV-файл для загрузки.
5. После создания события настройте статистику .

Создать или импортировать статистику

В Google Play Console можно впервые добавить статистику двумя способами:

• Создание статистики : добавляйте статистику по одной за раз.
• Импорт статистики : Импорт нескольких статистических данных.

Создать статистику

Чтобы создать статистику для игры, выполните следующие шаги:

1. В консоли Google Play выберите игру.
2. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Добавить статистику» > «Создать статистику» .
3. На странице «Создать статистику» заполните форму.
4. Нажмите «Сохранить изменения» .
5. После создания статистики опубликуйте свою игру.

Импорт статистики

Для импорта статистики выполните следующие действия:

1. Создайте ZIP-архив, содержащий статистику, локализацию и файлы значков, в соответствии с рекомендациями по созданию ZIP-архивов для статистики .
2. В консоли Google Play выберите игру.
3. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Добавить статистику» > «Импорт через ZIP-архив» .
4. На странице настроек игровой статистики перетащите ZIP-файл для загрузки.
5. После загрузки всей статистики опубликуйте свою игру.

Статистика тестовой игры

Чтобы убедиться, что игровая статистика работает должным образом, выполните следующие шаги для ее проверки:

• В консоли Play настройте внутренний тестовый трек .
• Добавьте тестовые аккаунты в свой игровой проект для тестировщиков.
• Создайте профиль Play Games Services для одной из тестовых учетных записей с помощью приложения Play Games.
• Запустите игру, используя ту же тестовую учетную запись, для которой вы создали профиль в сервисах Play Games.
• Убедитесь, что на экране отображается всплывающее сообщение «Добро пожаловать» от Play Games Services, подтверждающее успешную автоматическую аутентификацию при запуске игры.
• Пользователь тестовой учетной записи может играть в игру, чтобы инициировать события. Проверьте ответ API, чтобы узнать, были ли события зарегистрированы.

Настройте отображение игровой статистики на вашем устройстве для тестирования.

Как только игра станет доступна вашим тестировщикам на консоли Play Console, выполните следующие действия, чтобы просмотреть статистику игры на вашем устройстве:

1. Очистите кэш Google Play Store:

   1. Откройте приложение «Настройки» на своем устройстве.
   2. Перейдите в раздел Приложения > Google Play Store .
   3. Нажмите «Хранилище и кэш» , а затем нажмите «Очистить кэш» .

2. Откройте приложение Google Play Store .

3. Просматривайте свою игровую статистику, используя раздел «Отслеживание игрового времени» или свой профиль игрока :

Способ 1: Воспользуйтесь разделом «Отслеживайте время игры».

Перейдите в раздел «Отслеживайте время игры» , а затем нажмите на него, чтобы просмотреть статистику игры.

Способ 2: Используйте свой игровой профиль.

1. Нажмите вкладку «Вы» , а затем выберите свой игровой профиль.
2. Перейдите в раздел «Статистика игры» .
3. Для указания временного диапазона выберите «Все» .
4. Если ваша игра не отображается, нажмите « Посмотреть все игры» .
5. Выберите свою игру, чтобы просмотреть её статистику.

Просмотрите журналы на вашем устройстве.

Чтобы убедиться, что игровая статистика работает должным образом, включите ведение журналов на вашем устройстве:

1. Включите отладку adb на вашем устройстве и выполните следующие команды в терминале:

   adb shell setprop log.tag.Games INFO
   adb logcat -s "PlayGamesServices[GameStatsAgent]:I"

2. Убедитесь, что в журнале отображается сообщение об успешном завершении, как показано в следующем примере:

   Successfully uploaded batch of X events.
   

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

3. Если какой-либо из отправленных событий не пройдет проверку, вы увидите сообщение об ошибке с подробным описанием причины сбоя:

   BatchRecordEvents validation failed for X event(s): ...
   

Опубликовать статистику игры

После завершения тестирования необходимо опубликовать игру. Все события и статистика игры будут опубликованы вместе с ней.

Для публикации выполните следующие шаги:

1. В консоли Google Play выберите игру.
2. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) нажмите «Проверить и опубликовать» .
3. На странице «Публикация» в разделе «Службы Play Games» ( Увеличение числа пользователей > Службы Play Games > Настройка и управление > Публикация ) проверьте выполненные действия и устраните возникшие проблемы.
4. Нажмите «Опубликовать» . Вся ваша игровая статистика будет опубликована.

Редактировать игровую статистику

Если у вас уже есть игровая статистика и вы хотите её отредактировать:

1. В консоли Google Play выберите игру.
2. Перейдите на страницу «Статистика игр» в сервисе Play Games ( Увеличение числа пользователей > Сервис Play Games > Настройка и управление > Статистика игр ).
3. Чтобы отредактировать событие :
   1. В разделе «Настройка событий» выберите событие.
   2. Вы можете добавлять или удалять свойства событий .
      • Вы не можете изменить название мероприятия .
   3. Нажмите «Сохранить изменения» .
4. Чтобы отредактировать статистику :
   1. В разделе «Настройка игровой статистики» выберите нужный показатель.
   2. Вы можете редактировать поля «Название статистики» , «Описание статистики» и «Имя файла значка» .
      • Вы не можете редактировать идентификатор статистики (Stat ID) , направление прогресса (Progression direction ), единицу измерения статистики (Stat unit ) и сведения о связанных событиях .
   3. Нажмите «Сохранить изменения» .
5. На странице «Статистика игр» в сервисах Play Games отредактированная статистика находится в статусе «Доступно для тестировщиков ».
6. После проверки статистики нажмите «Проверить и опубликовать» . Это повторно опубликует вашу игру вместе со всей обновленной статистикой.

Удалить игровую статистику

После публикации статистики игры её нельзя удалить.

Вы можете удалить событие или статистику в статусе «Доступно для тестировщиков» .

1. В консоли Google Play выберите игру.
2. Перейдите на страницу «Статистика игр» в сервисе Play Games ( Увеличение числа пользователей > Сервис Play Games > Настройка и управление > Статистика игр ).
3. Чтобы удалить событие :
   1. В разделе «Настройка событий» выберите событие.
   2. Нажмите «Удалить событие» .
4. Чтобы удалить статистику :
   1. В настройках игровой статистики выберите параметр, который хотите удалить.
   2. Нажмите «Удалить игровую статистику» .

Рекомендации по использованию CSV-файлов для организации мероприятий

Первая строка CSV-файла — это строка заголовка. Необходимо импортировать события, используя CSV-файл с событиями, например, PlayerGameEvent.csv .

Формат файла PlayerGameEvent.csv

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

 Event Name,Property Name,Property Type

Если вы отправляете событие progressUpdate для progressionStat , добавьте строку для этого события. Это событие должно содержать как минимум свойство currentProgress типа INT или STRING, а также любые другие свойства, которые вы хотите отправить.

Эти поля описаны в следующей таблице:

Требования к файлу PlayerGameEvent.csv:

• Файл поддерживает максимум 20 уникальных имен событий и до 20 свойств для каждого события.
• Содержимое файла не может быть пустым и должно содержать как минимум одну строку.

Рекомендации по архивированию ZIP-файлов для статистики

Вы можете импортировать статистику сразу, используя ZIP-файл. Точные имена файлов для ZIP-архива указаны в таблице:

ZIP-файл должен соответствовать следующим требованиям:

• Ограничение на размер ZIP-файла: максимальный общий размер в несжатом виде составляет 10 МБ.
• Максимальное количество файлов: 53 (3 CSV-файла и 50 значков) всего в ZIP-архиве.
• Максимальное общее количество статистических данных: максимум 50 показателей в файлах ProgressionStatConfig.csv и RepetitiveStatsConfig.csv .
• Поддерживаемые CSV-файлы: ProgressionStatConfig.csv , RepetitiveStatsConfig.csv и StatLocalizations.csv (необязательно). Если вы хотите загрузить только статистику прогресса, не включайте CSV-файл с повторяющейся статистикой в ​​ZIP-архив; в противном случае в консоли появится ошибка. То же самое относится и к случаю, если вы хотите загрузить только повторяющуюся статистику.
• Файлы изображений значков: PNG (.png) или JPEG (.jpg, .jpeg).
  • Все значки, указанные в CSV-файлах, должны находиться в корневом каталоге ZIP-архива.
  • Все файлы изображений, находящиеся в ZIP-архиве, должны быть проиндексированы как минимум одним статистическим параметром.
• Структура каталогов: Все файлы должны находиться в корневом каталоге ZIP-архива. Подкаталоги не допускаются.

Формат RepetitiveStatsConfig.csv

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

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

Эти поля описаны в следующей таблице:

Если вы не хотите использовать условие фильтрации, оставьте ячейку пустой.

Формат ProgressionStatConfig.csv

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

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

Статистика прогресса будет отображаться в качестве первой статистики в профиле игрока.

Эти поля описаны в следующей таблице:

Формат StatLocalizations.csv

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

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

Эти поля описаны в следующей таблице:

Файлы значков

Значки, на которые вы ссылаетесь в CSV-файле, должны присутствовать в текущем ZIP-архиве, который вы импортируете.

Правила проверки значков следующие:

рекомендации по использованию иконок

Иконки следует создавать в формате PNG, JPEG или JPG размером 512 x 512 пикселей с прозрачным фоном.

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

Технические характеристики модуля

Столбцы «Единицы измерения» определяют, как форматируются и локализуются исходные значения статистических данных для игроков.

Числовые характеристики (INT64, DOUBLE)

Свойства статистики длительности (DURATION)

Нечисловые статистические свойства (строка, логическое значение)

Столбцы с единицами измерения необходимо оставить пустыми.