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


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

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

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

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

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