Google is committed to advancing racial equity for Black communities. See how.
Эта страница переведена с помощью Cloud Translation API.
Switch to English

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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