Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

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

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

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

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

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

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

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

Веб-версия 9

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

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

Веб-версия 8

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

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

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

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

Веб-версия 9

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

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

Веб-версия 8

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

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

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

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