Мероприятия

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

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

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

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

Встраивайте события в свою игру

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

  1. Определение событий . Чтобы определить новые события для отслеживания в вашей игре:
    1. Перейдите на страницу «События» для вашей игры в консоли Google Play .
    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, нажмите кнопку « Сбросить статус события» внизу формы для этого события.
  • Для программного сброса данных события вызовите методы API управления Events .

Внедрение клиентских решений

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