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


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

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

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

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

Убедитесь, что вы настроили свой проект и можете получить доступ к 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'
});

Web

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

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

  • Пользовательские параметры: пользовательские параметры можно использовать в качестве измерений или метрик в отчётах 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'});

Web

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

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

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

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