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


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

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

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

Прежде чем начать

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

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

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

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

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

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

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

Web 

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 

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

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

  • Пользовательские параметры: Пользовательские параметры можно использовать в качестве измерений или метрик в отчетах Analytics . Вы можете использовать пользовательские измерения для нечисловых данных параметров событий и пользовательские метрики для любых данных параметров, которые лучше представить в числовом виде. После регистрации пользовательского параметра с помощью SDK зарегистрируйте измерение или метрику, чтобы эти пользовательские параметры отображались в отчетах Analytics. Сделайте это через: Analytics > События > Управление пользовательскими определениями > Создать пользовательские измерения

    Пользовательские параметры можно использовать в определениях аудитории , которые могут применяться к каждому отчету. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery. Примеры запросов и многое другое можно найти в разделе «Экспорт в Google Analytics 4 BigQuery» .

  • Параметр value : value — это универсальный параметр, полезный для накопления ключевого показателя, относящегося к событию. Примеры включают доход, расстояние, время и баллы.

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

Web 

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

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

Web 

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

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

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

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