События

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

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

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

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

Интеграция событий в вашу игру

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

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

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

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

Основы событий

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

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

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

Примеры:

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

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

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

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

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

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

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

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

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

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

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

Удаление события

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

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

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

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

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

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