Мероприятия

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры:

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

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

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

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

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

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

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

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

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

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

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

Удалить мероприятие

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

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

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

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

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

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