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

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

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

Аналитика автоматически регистрирует некоторые события для вас; вам не нужно добавлять какой-либо код, чтобы получить их. Если ваше приложение необходимо собрать дополнительные данные, вы можете войти до 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' }]
});

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

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

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