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

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

Создание событий

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

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

Настройка статистики

После создания события необходимо настроить статистику:

1. Создайте ZIP-архив, содержащий статистику, локализацию и файлы значков, в соответствии с рекомендациями по созданию ZIP-архивов для статистики .
2. В консоли Google Play выберите игру.
3. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Настроить статистику» .
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. Нажмите «Опубликовать» . Вся ваша игровая статистика будет опубликована.

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

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

Рекомендации по использованию 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)

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

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

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

Создание событий

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

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

Настройка статистики

После создания события необходимо настроить статистику:

1. Создайте ZIP-архив, содержащий статистику, локализацию и файлы значков, в соответствии с рекомендациями по созданию ZIP-архивов для статистики .
2. В консоли Google Play выберите игру.
3. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Настроить статистику» .
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. Нажмите «Опубликовать» . Вся ваша игровая статистика будет опубликована.

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

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

Рекомендации по использованию 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)

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

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

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

Создание событий

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

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

Настройка статистики

После создания события необходимо настроить статистику:

1. Создайте ZIP-архив, содержащий статистику, локализацию и файлы значков, в соответствии с рекомендациями по созданию ZIP-архивов для статистики .
2. В консоли Google Play выберите игру.
3. На странице «Статистика игр» в разделе «Сервисы игр Play Games» ( Увеличение числа пользователей > Сервисы игр Play Games > Настройка и управление > Статистика игр ) выберите «Настроить статистику» .
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. Нажмите «Опубликовать» . Вся ваша игровая статистика будет опубликована.

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

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

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

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

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

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

 Event Name,Property Name,Property Type

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

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

PlayerGameEvent.csv file requirements:

• The file supports a maximum of 20 unique event name, with up to 20 properties per event.
• The file content can't be empty and must have at least 1 row.

ZIP file guidelines for stats

You can import stats at once using a ZIP file. Refer to the table for the precise filenames to use in your ZIP file:

The ZIP file must meet the following requirements:

• ZIP file size limit: Maximum total uncompressed size is 10 MB.
• Max files: Maximum 53 (3 CSV and 50 icons) total files inside the ZIP archive.
• Max combined stats limit: Maximum 50 total stats across ProgressionStatConfig.csv and RepetitiveStatsConfig.csv .
• Supported CSV files: ProgressionStatConfig.csv , RepetitiveStatsConfig.csv , and StatLocalizations.csv (optional). If you want to upload only progression stat, don't include the repetitive stats CSV file in the ZIP; otherwise, the console emits an error. The same applies if you want to upload only repetitive stats.
• Icon image files: PNG (.png) or JPEG (.jpg, .jpeg).
  • All icons referenced in the CSVs must exist in the root of the ZIP file.
  • All image files present in the ZIP must be referenced by at least one stat.
• Directory structure: All files must reside at the root of the ZIP file. Subdirectories aren't allowed.

RepetitiveStatsConfig.csv format

The CSV contains declared event and its properties as comma separated values in the following order:

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

These fields are described in the following table:

In case you don't want to use the filter condition, keep the cell as blank.

ProgressionStatConfig.csv format

The csv contains declared event and its properties as comma separated values in the following order:

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

The progression stat will be shown as the first stat to a player in their Gamer Profile.

These fields are described in the following table:

StatLocalizations.csv format

The csv contains declared event and its properties as comma separated values in the following order:

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

These fields are described in the following table:

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

Icons you reference in CSV file must exist in the current ZIP archive you import.

Icon validation rules are:

Icon guidelines

Icons should be created as 512 x 512 PNG, JPEG, or JPG files.

The same icon is used in all locales, so we recommend against including any text or localized content in an icon.

Unit specification

The Unit columns control how raw stat values are formatted and localized for players.

Numeric stat properties (INT64, DOUBLE)

Non-Numeric Stat Properties (STRING, BOOL)

Unit columns must be left empty.