Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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. На этой панели отображаются отчеты о событиях, которые автоматически создаются для каждого отдельного типа событий, зарегистрированных вашим приложением.