События дают представление о том, что происходит в вашем приложении, например, действия пользователя, системные события или ошибки.
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 определяет ряд рекомендуемых событий, которые являются общими для различных типов приложений, включая приложения для розничной торговли и электронной коммерции, путешествий и игр. Чтобы узнать больше об этих событиях и о том, когда их использовать, см. статьи Рекомендуемые события в Справочном центре 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);
Просмотр событий в журнале вывода
андроид
Вы можете включить подробное ведение журнала в журнале отладки 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 console. Эти панели управления периодически обновляются в течение дня. Для немедленного тестирования используйте вывод logcat, как описано в предыдущем разделе.
Чтобы получить доступ к этим данным в консоли Firebase :
- В консоли Firebase откройте свой проект.
- Выберите в меню Analytics , чтобы просмотреть панель отчетов Analytics .
Вкладка «События» показывает отчеты о событиях, которые автоматически создаются для каждого отдельного типа событий Analytics , зарегистрированных вашим приложением. Подробнее о панели мониторинга .