Журнал событий

Выберите платформу: iOS+ Android Web Flutter Unity C++


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

Google Analytics automatically logs some events for you; you don't need to add any code to receive them. If your app needs to collect additional data, you can log up to 500 different Analytics event types in your app. There is no limit on the total volume of events your app logs. Note that event names are case-sensitive and that logging two events whose names differ only in case results in two distinct events.

Прежде чем начать

Прежде чем начать использовать Google Analytics , вам необходимо:

  • Зарегистрируйте свой проект Unity и настройте его для использования Firebase.

    • Если ваш проект Unity уже использует Firebase, значит, он уже зарегистрирован и настроен для работы с Firebase.

    • Если у вас нет проекта Unity, вы можете скачать пример приложения .

  • Добавьте Firebase Unity SDK (в частности, FirebaseAnalytics.unitypackage ) в свой проект Unity.

Обратите внимание, что добавление Firebase в ваш проект Unity включает в себя действия как в консоли Firebase , так и в открытом проекте Unity (например, вы загружаете файлы конфигурации Firebase из консоли, а затем перемещаете их в свой проект Unity).

Журнал событий

После инициализации модуля Firebase.Analytics.FirebaseAnalytics вы можете использовать его для регистрации событий с помощью метода LogEvent() .

Чтобы помочь вам начать работу, SDK Analytics определяет ряд рекомендуемых событий, общих для различных типов приложений, включая приложения для розничной торговли и электронной коммерции, путешествий и игр. Чтобы узнать больше об этих событиях и о том, когда их использовать, см. статьи о рекомендуемых событиях в Справочном центре Google Analytics.

Подробную информацию о реализации рекомендуемых событий можно найти в следующих местах:

  • Рекомендуемые события: см. список констант Event .
  • Заданные параметры: см. список констант Parameters .

В следующем примере показано, как зарегистрировать предлагаемое событие SELECT_CONTENT :

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

В дополнение к предписанным параметрам, к любому событию можно добавить следующие параметры:

  • Пользовательские параметры: Пользовательские параметры не отображаются напрямую в отчетах Analytics , но их можно использовать в качестве фильтров в определениях аудитории , которые применяются ко всем отчетам. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery.

  • Параметр VALUE : VALUE — это универсальный параметр , полезный для сбора ключевых показателей, относящихся к Analytics событию. Примеры включают доход, расстояние, время и баллы.

Если у вашего приложения есть специфические потребности, не охватываемые предлагаемым типом Analytics событий, вы можете регистрировать собственные пользовательские Analytics события, как показано в этом примере:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Просмотрите события в журнале событий.

iOS+

События записываются в консоль и могут быть просмотрены во время запуска приложения через Xcode.

Android

В отладочном журнале Android Studio можно включить подробное логирование, чтобы убедиться в корректной регистрации событий SDK. Это касается как автоматически, так и вручную регистрируемых событий.

Включить подробное логирование можно с помощью ряда команд adb: 

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Эта команда отображает ваши события в logcat Android Studio, помогая вам немедленно убедиться в том, что события отправляются.

Просматривайте аналитические события на панели управления.

В консоли Firebase вы можете просмотреть сводную статистику по вашим событиям на панели мониторинга «Аналитика > События» .

Обратите внимание на следующие особенности этой панели мониторинга:

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

  • Панель мониторинга периодически обновляется в течение дня. Для немедленного тестирования используйте консоль отладки Xcode или вывод logcat, как описано в предыдущем разделе этого руководства.

Подробнее о панели управления можно прочитать здесь.