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

Выберите платформу: 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 выберите Аналитика > Специальные определения.

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

  • Параметр общего назначения 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.