Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

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

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

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

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

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

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

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

Web version 9

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

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

Web version 8

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 version 9

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

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

Web version 8

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

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

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

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