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


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

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

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'
});

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, как описано в предыдущем разделе.

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