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

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

Google Analytics автоматически регистрирует некоторые события для вас; Вам не нужно добавлять код для их получения. Если вашему приложению нужно собрать дополнительные данные, вы можете зарегистрировать до 500 различных типов событий Google Analytics в своем приложении. Нет ограничений на общий объем событий, которые регистрирует ваше приложение. Обратите внимание, что имена событий чувствительны к регистру и что регистрация двух событий, имена которых отличаются только регистром, приведет к двум отдельным событиям.

Прежде чем вы начнете

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

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

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

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

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

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

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

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

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

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

• Предлагаемые события: см. Список констант 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)
);

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

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

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

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

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

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

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

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

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

Чтобы получить доступ к этим данным в консоли Firebase:

1. В консоли Firebase откройте свой проект.
2. Выберите Analytics в меню, чтобы просмотреть панель отчетов Analytics.

На вкладке « События » отображаются отчеты о событиях , которые автоматически создаются для каждого отдельного типа события Google Analytics, зарегистрированного вашим приложением. Узнайте больше о панели инструментов отчетов Analytics в справочном центре Firebase.