Мероприятия

Сервис событий Google Play Игр позволяет собирать кумулятивные данные, генерируемые вашими игроками во время игры, и хранить их на серверах Google для аналитики. Вы можете гибко настроить, какие данные об игроках должна собирать ваша игра; это могут быть такие метрики, как частота:

  • Игроки используют определенный предмет
  • Игроки достигают определенного уровня
  • Игроки выполняют определенные игровые действия

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

Чтобы узнать, как реализовать события для вашей платформы, см. раздел Реализации клиентов .

Интегрируйте события в свою игру

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

  1. Определите события . Чтобы определить новые события для отслеживания в игре:
    1. Перейдите на страницу событий вашей игры в Google Play Console .
    2. Нажмите кнопку Добавить новое событие и настройте свойства события .
    3. Опубликуйте определения событий, выполнив шаги, описанные в разделе Публикация изменений в игре .

  2. Реализуйте перехват событий в своей игре с помощью API событий . Например, в коде Android вызывайте метод events increment каждый раз, когда игра обнаруживает, что произошло событие, которое её интересует.

  3. Просмотр данных о событиях . Перейдите на страницу «События» вашей игры в Google Play Console, чтобы просмотреть статистику зафиксированных событий.

Основы мероприятий

API событий предоставляют вам возможность определять и собирать интересные показатели игрового процесса и загружать эти показатели в Play Games SDK.

Событие Play Games SDK содержит следующие ключевые свойства:

Свойство Описание
ИДЕНТИФИКАТОР Уникальная строка, сгенерированная Google Play Console для этого события. Используйте этот уникальный идентификатор для ссылки на событие в ваших игровых клиентах.
Имя Краткое название события. Длина названия может составлять до 100 символов. Это значение используется Google Play Console и может отображаться в вашей игре.

Примеры:

  • «Зомби убиты»
  • «Собраны красные драгоценности»
Описание Более подробное описание события (например, «Количество убийств зомби игроком» или «Общее количество уничтоженных и подобранных игроком красных камней»). Описание может содержать до 500 символов. Это значение используется Google Play Console и может отображаться в вашей игре.
Тип события

Поле, в котором указывается тип данных, отслеживаемых событием. Это значение используется Google Play Console для поддержки отчётов Player Analytics.

Поддерживаются два типа событий:

Источник премиальной валюты
Выберите этот тип для событий, отслеживающих источники премиальной валюты. Например:
  • «Заработанные золотые монеты»
  • «Изумруды куплены»
Премиум-валюта
Выберите этот тип для событий, отслеживающих расход или потребление премиальной валюты. Например:
  • «Золотые монеты потрачены»
  • «Изумруды использованы»

Икона Квадратный значок, который будет связан с вашим событием.

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

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

  1. В консоли Google Play нажмите значок «Игровые сервисы» слева и выберите запись для вашей игры.
  2. Выберите вкладку «События» слева и нажмите кнопку «Добавить событие» .
  3. Заполните данные о мероприятии, которое вы хотите создать.
  4. Нажмите «Сохранить» . Если ошибок нет, ваше событие переходит в состояние «Готово к публикации». Теперь вы можете приступить к публикации изменений в игре .

Редактировать событие

Чтобы отредактировать созданное вами событие:

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

Удалить событие

Вы можете удалять события, находящиеся в стадии черновика или уже опубликованные. Чтобы удалить событие в Google Play Console, нажмите кнопку « Удалить » в нижней части формы этого события.

Сбросить данные о событиях

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

  • Чтобы сбросить черновики событий в Google Play Console, нажмите кнопку Сбросить ход события в нижней части формы для этого события.
  • Чтобы программно сбросить данные о событиях, вызовите методы Events API управления .

Клиентские реализации

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