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

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

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

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

Прежде чем вы начнете

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

Web namespaced API

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

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

Специальные параметры. Специальные параметры можно использовать в качестве параметров или показателей в отчетах 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'});analytics_log_event_custom_params.js

Web namespaced API

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

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

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

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