Как регистрировать события

Выберите платформу: iOS+ Android Веб Flutter Unity C++


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

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

Подготовка

Убедитесь, что у вас настроен проект и есть доступ к Аналитике, как описано в статье Начало работы с Google Аналитикой.

Как регистрировать события

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

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

Подробную информацию о реализации некоторых событий и их параметров можно найти в справочной документации по событиям 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, чтобы он отображался в отчетах Аналитики, вам нужно зарегистрировать соответствующий ему параметр или показатель. Для этого в консоли Firebase выберите Analytics (Аналитика) > Custom Definitions (Специальные определения).

    Специальные параметры можно использовать в определениях аудиторий, которые можно применять к любому отчету. Если ваше приложение связано с проектом BigQuery, специальные параметры также включаются в данные, экспортируемые в BigQuery. Примеры запросов и другую информацию можно найти в статье BigQuery Export в Google Аналитике 4.

  • Параметр общего назначения 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 можно посмотреть сводную статистику по событиям. Для этого перейдите в раздел Аналитика > События.

Обратите внимание на следующее:

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

  • Она периодически обновляется в течение дня. Для оперативного тестирования используйте DebugView.