В этом документе объясняется, как интегрировать игровую статистику в вашу игру с помощью Google Play Console. В нем рассматриваются основные форматы файлов CSV и ZIP, а также описывается, как создавать, импортировать и управлять ими.
Создание событий
Чтобы создать событие для новой, ещё не опубликованной игры, выполните следующие шаги:
- Создайте CSV-файл с событиями PlayerGameEvent.csv.
- В консоли Google Play выберите игру.
- На странице «Статистика игр» в разделе «Службы Play Games» ( Увеличение числа пользователей > Службы Play Games > Настройка и управление > Статистика игр ) выберите «Настройка событий» .
- На странице настроек событий перетащите CSV-файл для загрузки.
- После создания события необходимо настроить статистику.
Настройка статистики
После создания события необходимо настроить статистику:
- Создайте ZIP-файл, содержащий статистику, локализацию и файлы значков . Рекомендации по созданию ZIP-файла для статистики .
- В консоли Google Play выберите игру.
- На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Настроить статистику» .
- На странице настроек игровой статистики перетащите ZIP-файл для загрузки.
- После загрузки всей статистики вы можете опубликовать свою игру.
Статистика тестовой игры
Чтобы убедиться, что игровая статистика работает должным образом, выполните следующие шаги для ее проверки:
- Создайте внутренний тестовый полигон .
- Добавьте тестовые аккаунты в свой игровой проект для тестировщиков.
- Создайте профиль Play Games Services для одной из тестовых учетных записей с помощью приложения Play Games.
- Запустите игру, используя ту же тестовую учетную запись, для которой вы создали профиль в сервисах Play Games.
- Убедитесь, что на экране отображается всплывающее сообщение «Добро пожаловать» от Play Games Services, подтверждающее успешную автоматическую аутентификацию при запуске игры.
- Пользователь тестовой учетной записи может играть в игру, чтобы инициировать события. Проверьте ответ API, чтобы узнать, были ли события зарегистрированы.
Опубликовать статистику игры
После завершения тестирования необходимо опубликовать игру. Все события и статистика игры будут опубликованы вместе с ней.
Для публикации выполните следующие шаги:
- В консоли Google Play выберите игру.
- На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) нажмите «Проверить и опубликовать» .
- На странице «Публикация» в разделе «Службы Play Games» ( Увеличение числа пользователей > Службы Play Games > Настройка и управление > Публикация ) проверьте выполненные действия и устраните возникшие проблемы.
- Нажмите «Опубликовать» . Вся ваша игровая статистика будет опубликована.
Удалить игровую статистику
После публикации игровая статистика не может быть удалена.
Рекомендации по использованию CSV-файлов для организации мероприятий
Первая строка CSV-файла — это строка заголовка. Необходимо импортировать события, используя CSV-файл с событиями, например, PlayerGameEvent.csv .
Формат файла PlayerGameEvent.csv
CSV-файл содержит объявленное событие и его свойства в виде значений, разделенных запятыми, в следующем порядке:
Event Name,Property Name,Property Type
Если вы отправляете событие progressUpdate для progressionStat , добавьте строку для этого события. Это событие должно содержать как минимум свойство currentProgress типа INT или STRING, а также любые другие свойства, которые вы хотите отправить.
Эти поля описаны в следующей таблице:
| Заголовки столбцов CSV | Обязательный или необязательный | Принятые значения |
|---|---|---|
| Название мероприятия | Необходимый | Максимальное количество символов: 50 Должно состоять только из букв, цифр и символов подчеркивания. Если используется специальное имя события |
| Название объекта недвижимости | Необходимый | Максимальное количество символов: 50 Должно состоять только из букв, цифр и символов подчеркивания. Уникальность для каждого мероприятия: названия объектов должны быть уникальными в рамках одного мероприятия. Не используйте следующие зарезервированные ключевые слова: |
| Тип недвижимости | Необходимый | Перечисляемая строка с учетом регистра, соответствующая одному из поддерживаемых типов данных: INT64 , DOUBLE , STRING , BOOL |
Требования к файлу PlayerGameEvent.csv:
- Файл поддерживает максимум 20 уникальных имен событий и до 20 свойств для каждого события.
- Содержимое файла не может быть пустым и должно содержать как минимум одну строку.
Пример таблицы
| Название мероприятия | Название объекта недвижимости | Тип недвижимости |
|---|---|---|
| матч завершен | продолжительность | ДВОЙНОЙ |
| матч завершен | убивает | INT64 |
| матч завершен | isWinner | БУЛ |
| матч завершен | matchType | НИТЬ |
| itemCollected | количество монет | INT64 |
| itemCollected | тип оружия | НИТЬ |
| прогрессОбновление | текущий прогресс | INT64 |
Рекомендации по архивированию ZIP-файлов для статистики
Вы можете импортировать статистику сразу, используя ZIP-файл. Точные имена файлов для ZIP-архива указаны в таблице:
| Имя файла | Обязательный или необязательный | Принятые значения |
|---|---|---|
RepetitiveStatsConfig.csv | Необходимый | Повторяющаяся статистика отражает регулярно повторяющиеся действия, совершаемые игроками в игре. |
ProgressionStatConfig.csv | Необходимый | Показатель прогресса отражает успех игрока в игре. |
StatLocalizations.csv | Необязательный | Предоставляет перевод названий и описаний игровой статистики. |
| Файлы значков | Необходимый | Иконки в формате PNG, JPEG или JPG размером 512 x 512 пикселей. |
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
Эти поля описаны в следующей таблице:
| Заголовки столбцов CSV | Обязательный или необязательный | Принятые значения |
|---|---|---|
| Идентификатор статистики | Необходимый | Максимальное количество символов: 100 Должно состоять только из букв, цифр и символов подчеркивания. Должно быть уникальным для всех статистических данных в игре. |
| Название свойства события | Необходимый | Максимальное количество символов: 50 |
| Статистическое отображаемое имя | Необходимый | Максимальное количество символов: 50 Название, отображаемое по умолчанию для статистики (локаль по умолчанию). Должно быть уникальным для всех статистических данных. |
| Описание характеристик | Необходимый | Максимальное количество символов: 500 Описание по умолчанию для этого параметра. |
| Тип агрегации | Необходимый | Максимальное количество символов: 50 Сумма, Максимум, Минимум, Количество. |
| Фильтр свойств | Необязательный | Максимальное количество символов: 50 Должно быть именем свойства, определенным в файле PlayerGameEvent.csv . |
| Оператор фильтра | Необязательный | =, !=, >, <, >=, <=Операторы сравнения фильтров. |
| Значение фильтра | Необязательный | Сравнивается со свойством Filter. Значение фильтра должно быть INT64, DOUBLE, BOOL, STRING . |
| Конкурентоспособен | Необходимый | true, false |
| Минимальный лимит | Требуется, когда условие "Is Competitive" выполняется. | Минимально допустимый балл для оценки спортивных результатов. |
| Максимальный лимит | Требуется, когда условие "Is Competitive" выполняется. | Максимально допустимый балл для соревновательной статистики. |
| Имя файла значка | Необходимый | Имя файла изображения значка, находящегося в корневом каталоге ZIP-архива. Не должно конфликтовать с именами файлов значков, используемыми в повторяющихся статистических данных. |
| Выгодное направление | Необходимый | Указывает, какие значения лучше: более высокие INCREASING или более низкие ( DECREASING ). |
| Единица | Необязательный | Единица измерения для числовых значений или продолжительности. Например, КИЛОМЕТР, СЕКУНДА, ПРОЦЕНТ, БЕЗ ЕДИНИЦЫ ИЗМЕРЕНИЯ. |
Если вы не хотите использовать условие фильтрации, оставьте ячейку пустой.
Пример таблицы
| Идентификатор статистики | Название мероприятия | Название объекта недвижимости | Агрегация | Статистическое отображаемое имя | Описание характеристик | Свойство фильтра (необязательно) | Оператор фильтра (опционально) | Значение фильтра (необязательно) | Конкурентоспособен | минЛимит | maxLimit | имя файла значка | Порядковый номер | Выгодное направление | единица |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | матч завершен | продолжительность | МАКС | Самый долгий матч на выживание | Это показатель времени выживания игрока в любом матче. | isWinner | = | истинный | истинный | 0 | 50 | stat1.png | 1 | Снижение | секунд |
| 2 | матч завершен | isWinner | СЧИТАТЬ | Выигранные матчи | Это обозначает количество выигранных игроком матчей. | isWinner | = | истинный | истинный | 0 | 50 | stat3.png | 2 | Увеличение | |
| 3 | матч завершен | убивает | СУММА | убийства в матче 1 на 1 | Количество убийств, совершенных в матчах 1 на 1. | matchType | = | "1 на 1" | ЛОЖЬ | stat4.png | 4 | Увеличение | |||
| 4 | itemCollected | количество монет | СУММА | Общее количество собранного золота | Игрок собирает монеты во время игры в матче. | тип оружия | = | "меч" | ЛОЖЬ | stat2.png | 3 | Увеличение |
Формат ProgressionStatConfig.csv
CSV-файл содержит объявленное событие и его свойства в виде значений, разделенных запятыми, в следующем порядке:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
Статистика прогресса будет отображаться в качестве первой статистики в профиле игрока.
Эти поля описаны в следующей таблице:
| Заголовки столбцов CSV | Обязательный или необязательный | Принятые значения |
|---|---|---|
| Идентификатор статистики | Необходимый | Максимальное количество символов: 100 Должно состоять только из букв, цифр и символов подчеркивания. Должно быть уникальным для всех статистических данных в игре. |
| Название мероприятия | Необходимый | Максимальное количество символов: 50 Необходимо указать имя события, определенное в формате PlayerGameEvent.csv . |
| Название свойства события | Необходимый | Максимальное количество символов: 50 Должно быть именем свойства, определенным в файле PlayerGameEvent.csv . |
| Статистическое отображаемое имя | Необходимый | Имя должно быть уникальным. |
| Описание характеристик | Необходимый | Максимальное количество символов: 50 Описание по умолчанию для этого параметра. |
| Имя файла значка | Необходимый | Имя файла изображения значка, находящегося в корневом каталоге ZIP-архива. Не должно конфликтовать с именами файлов значков, используемыми в повторяющихся статистических данных. |
| Выгодное направление | Необходимый | Указывает, какие значения лучше: более высокие INCREASING или более низкие ( DECREASING ). |
| Единица | Необязательный | Единица измерения для числовых значений или продолжительности. Например, КИЛОМЕТР, СЕКУНДА, ПРОЦЕНТ, БЕЗ ЕДИНИЦЫ ИЗМЕРЕНИЯ. |
Пример таблицы
| Идентификатор статистики | Название свойства события | Статистическое отображаемое имя | Описание характеристик | Имя файла значка | Выгодное направление |
|---|---|---|---|---|---|
| 5 | текущий прогресс | Уровень | Игроки накапливают опыт, участвуя в матчах, и повышают свой уровень. | Level.png | увеличение |
Формат StatLocalizations.csv
CSV-файл содержит объявленное событие и его свойства в виде значений, разделенных запятыми, в следующем порядке:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
Эти поля описаны в следующей таблице:
| Заголовки столбцов CSV | Обязательный или необязательный | Принятые значения |
|---|---|---|
| Идентификатор статистики | Необходимый | Максимальное количество символов: 100 Должно состоять только из букв, цифр и символов подчеркивания. Должно быть уникальным для всех статистических данных в игре. |
| Статистическое отображаемое имя | Необходимый | Имя должно быть уникальным. |
| Местоположение | Необходимый | Код локали, например, en-US. Добавьте переводы для вашей игры перед указанием локали. Обратите внимание, что вы не можете указать локаль по умолчанию. Список поддерживаемых языковых кодов можно найти в списке поддерживаемых языков . |
| Название для отображения локализованной статистики | Необязательный | Максимум 50 символов. Переведённое название отображаемой статистики для данной локали. |
| Локализованное описание статистики | Необязательный | Максимум 500 символов. Переведенное описание характеристик для данной локали. |
Пример таблицы
| Идентификатор статистики | Статистическое отображаемое имя | Языковой код | Локализованное название статистики (UTF-8) | Локализованное описание статистики (UTF-8) | 1 | Самый долгий матч на выживание | эс | Supervivencia más larga en partidos | Это означает время выживания юной юной южанки в какой-то партии. | 1 | Самый долгий матч на выживание | фр | Survie du match le plus long | Cela indique la durée de survie d'un joueur dans n'importe quel match. | 4 | Общее количество собранного золота | эс | Oro total recolectado | La jugadora признает монеты в период игры в партии | 4 | Общее количество собранного золота | фр | Или полная коллекция | Le joueur Collecte des Pièces en Jouant Un Match |
Файлы значков
Значки, на которые вы ссылаетесь в файле .csv , должны присутствовать в текущем импортируемом ZIP-архиве.
Правила проверки значков следующие:
| Свойство проверки | Принудительное ограничение / правило |
|---|---|
| Максимальный размер файла | Максимальный размер файла значка — 1 МБ (1 048 576 байт). |
| Размеры | Ровно 512 × 512 пикселей (ширина = 512, высота = 512) |
| Соотношение сторон | Строго 1:1 (квадратное соотношение сторон) |
| Допустимые форматы | PNG (.png) и JPEG (.jpg, .jpeg) |
| Размещение в почтовом индексе | Должен находиться в корневом каталоге ZIP-архива. |
| Ссылка на чек | Все имена файлов значков, указанные в столбце «Имя файла значка», должны присутствовать в ZIP-архиве. |
| Проверка на наличие сирот | Все файлы изображений внутри ZIP-архива должны быть проиндексированы как минимум одним статистическим параметром. |
| Проверка на конфликт интересов | Имена файлов значков в ProgressionStatConfig.csv не должны конфликтовать с именами RepetitiveStatsConfig.csv . |
| Визуальные дубликаты | Повторяющиеся значки помечены. |
рекомендации по использованию иконок
Иконки следует создавать в формате PNG, JPEG или JPG размером 512 x 512 пикселей.
Во всех языковых версиях используется одна и та же иконка, поэтому мы не рекомендуем включать в нее какой-либо текст или локализованный контент.
Технические характеристики модуля
Столбцы «Единицы измерения» определяют, как форматируются и локализуются исходные значения статистических данных для игроков.
Числовые характеристики (INT64, DOUBLE)
| Допустимая стоимость единицы | Пример исходного значения |
| (Пусто) / БЕЗ ЕДИНИЦ / НЕТ | 1234567 |
| % / ПРОЦЕНТ / ПРОЦЕНТ | 0,857 |
| Расстояние/Длина : сантиметр, метр, километр, фут, дюйм, миля, ярд, миллиметр, нанометр | 15 (КИЛОМЕТРОВ) |
| Скорость : КИЛОМЕТРЫ В ЧАС, МЕТРЫ В СЕКУНДУ, МИЛИ В ЧАС | 60 (миль в час) |
Нечисловые статистические свойства (строка, логическое значение)
Столбцы с единицами измерения необходимо оставить пустыми.