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

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

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

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

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

Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics, как описано в разделе Начало работы с Analytics .

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

После настройки экземпляра firebase.analytics() вы можете начать регистрировать события с помощью метода logEvent() . Если вы уже знакомы с Google Analytics , этот метод эквивалентен использованию команды event в gtag.js.

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

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

Подробную информацию о реализации нескольких событий и их параметров можно найти в справочнике событий gtag.js.

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

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});analytics_log_event_params.js

Web

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});index.js

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

Пользовательские параметры: пользовательские параметры можно использовать в качестве измерений или метрик в отчётах Analytics . Вы можете использовать пользовательские измерения для нечисловых данных параметров событий, а пользовательские метрики — для любых данных параметров, которые лучше представить в числовом виде. После регистрации пользовательского параметра с помощью SDK зарегистрируйте измерение или метрику, чтобы эти пользовательские параметры отображались в отчётах Analytics. Для этого выберите: Аналитика > События > Управление пользовательскими определениями > Создать пользовательские измерения.
Пользовательские параметры можно использовать в определениях аудитории , которые можно применять к каждому отчёту. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery. Примеры запросов и многое другое можно найти в разделе Google Analytics 4 BigQuery Export .
Параметр value : value — это параметр общего назначения, полезный для сбора ключевых показателей, относящихся к событию. Примеры включают доход, расстояние, время и баллы.

Если у вашего приложения есть особые потребности, не охватываемые рекомендуемым типом событий, вы можете регистрировать собственные события. Например, если вы разрабатываете игру и хотите отслеживать, когда игрок достигает определённой цели, вы можете регистрировать событие, подобное следующему примеру:

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});analytics_log_event_custom_params.js

Web

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});index.js

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

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

Доступ к этим данным можно получить на панели «События» в консоли Firebase . Эта панель отображает отчёты о событиях, которые автоматически создаются для каждого типа событий, регистрируемых вашим приложением.