События предоставляют информацию о том, что происходит в вашем приложении, например о действиях пользователя, системных событиях или ошибках.
Google Analytics автоматически регистрирует для вас некоторые события ; вам не нужно добавлять какой-либо код, чтобы получить их. Если вашему приложению необходимо собирать дополнительные данные, вы можете регистрировать в нем до 500 различных типов событий 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) );
Помимо прописанных параметров, вы можете добавить к любому событию следующие параметры:
Пользовательские параметры. Пользовательские параметры не представлены непосредственно в отчетах Analytics, но их можно использовать в качестве фильтров в определениях аудитории , которые можно применять к каждому отчету. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery , если ваше приложение связано с проектом BigQuery.
Параметр
VALUE
:VALUE
— это параметр общего назначения, который полезен для накопления ключевой метрики, относящейся к событию Analytics. Примеры включают доход, расстояние, время и очки.
Если у вашего приложения есть особые потребности, которые не покрываются предлагаемым типом события Analytics, вы можете регистрировать свои собственные настраиваемые события Analytics, как показано в этом примере:
Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);
Просмотр событий в выводе журнала
Андроид
Вы можете включить подробное ведение журнала в журнале отладки 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
Эта команда отображает ваши события в логарифме Android Studio, помогая вам сразу убедиться, что события отправляются.
iOS+
События регистрируются в консоли, и их можно просмотреть во время запуска приложения через XCode.
Просмотр событий аналитики на панели инструментов
Вы можете просмотреть сводную статистику о ваших событиях Analytics на информационных панелях консоли Firebase. Эти информационные панели периодически обновляются в течение дня. Для немедленного тестирования используйте выходные данные logcat, как описано в предыдущем разделе.
Чтобы получить доступ к этим данным в консоли Firebase:
- В консоли Firebase откройте свой проект.
- Выберите Analytics в меню, чтобы просмотреть панель отчетов Analytics.
На вкладке « События » отображаются отчеты о событиях , которые автоматически создаются для каждого отдельного типа события аналитики, зарегистрированного вашим приложением. Узнайте больше о панели управления отчетами Analytics в Справочном центре Firebase.