В этом руководстве показано, как регистрировать события в вашем приложении.
События предоставляют информацию о том, что происходит в вашем приложении, например о действиях пользователя, системных событиях или ошибках.
Analytics автоматически записывает для вас некоторые события ; вам не нужно добавлять какой-либо код, чтобы получить их. Если вашему приложению необходимо собирать дополнительные данные, вы можете регистрировать до 500 различных типов событий аналитики в своем приложении. Нет ограничений на общий объем событий, регистрируемых вашим приложением. Обратите внимание, что имена событий чувствительны к регистру, и запись в журнал двух событий, имена которых различаются только регистром, приведет к двум различным событиям.
Прежде чем вы начнете
Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics, как описано в разделе Начало работы с Analytics .
Журнал событий
После того, как вы настроили экземпляр firebase.analytics()
, вы можете начать регистрировать события с помощью метода logEvent()
. Если вы уже знакомы с Google Analytics, этот метод эквивалентен использованию команды event
в gtag.js .
Чтобы помочь вам начать работу, Analytics SDK определяет ряд рекомендуемых событий, которые являются общими для различных типов приложений, включая приложения для розничной торговли и электронной коммерции, путешествия и игры. Чтобы узнать больше об этих событиях и о том, когда их использовать, см. Рекомендуемые события .
Примечание. Чтобы получить максимальную информацию в отчетах, регистрируйте рекомендуемые события, которые имеют смысл для вашего приложения, и их заданные параметры. Это также гарантирует, что вы сможете пользоваться новейшими функциями Google Analytics по мере их появления.
Подробнее о реализации нескольких событий и их параметрах можно узнать в справочнике по событиям gtag.js .
В следующем примере показано, как зарегистрировать событие select_content
:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'select_content', { content_type: 'image', content_id: 'P12453' });
Web namespaced API
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
Помимо прописанных параметров, вы можете добавить к любому событию следующие параметры:
Специальные параметры. Специальные параметры можно использовать в качестве параметров или показателей в отчетах Google Analytics . Вы можете использовать специальные параметры для нечисловых данных параметров событий и специальные показатели для любых данных параметров, которые лучше представлены в числовом виде. Зарегистрировав настраиваемый параметр с помощью SDK, зарегистрируйте параметр или показатель, чтобы эти настраиваемые параметры отображались в отчетах Analytics. Для этого выполните следующие действия: Аналитика > События > Управление пользовательскими определениями > Создать пользовательские параметры.
Пользовательские параметры можно использовать в определениях аудитории , которые можно применять к каждому отчету. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery. Найдите примеры запросов и многое другое в Google Analytics 4 BigQuery Export .
параметр
value
:value
— это параметр общего назначения, который полезен для накопления ключевой метрики, относящейся к событию. Примеры включают доход, расстояние, время и баллы.
Если у вашего приложения есть особые потребности, которые не покрываются рекомендуемым типом события, вы можете регистрировать свои собственные настраиваемые события. Например, если вы разрабатываете игру и хотите отслеживать, когда игрок достигает определенной цели, вы можете зарегистрировать событие, подобное следующему примеру:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
Web namespaced API
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
Просмотр событий в панели управления
Вы можете просматривать сводную статистику о ваших событиях на информационных панелях консоли Firebase. Эти информационные панели периодически обновляются в течение дня. Для немедленного тестирования используйте выходные данные logcat, как описано в предыдущем разделе.
Вы можете получить доступ к этим данным на панели управления событиями в консоли Firebase. На этой панели отображаются отчеты о событиях, которые автоматически создаются для каждого отдельного типа событий, зарегистрированных вашим приложением.