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


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

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

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

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

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

Если вы хотите собирать данные об атрибуции кампаний, обязательно добавьте фреймворк AdSupport в свой проект .

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

После настройки экземпляра FirebaseApp вы можете начать регистрировать события с помощью метода logEvent() .

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

Подробности реализации можно найти в справочнике констант для Swift и Objective-C .

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

Быстрый 

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C 

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

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

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

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

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

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

Быстрый 

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C 

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

Задайте параметры события по умолчанию.

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

Как и в случае с пользовательскими параметрами, зарегистрируйте параметры событий по умолчанию, чтобы гарантировать их отображение в отчетах Analytics.

Быстрый 

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C 

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

Если в методе logEvent() указан параметр, то вместо значения по умолчанию используется его собственное значение.

Чтобы очистить параметр по умолчанию, вызовите метод setDefaultEventParameters , установив для параметра значение nil .

Просмотр событий в консоли отладки Xcode.

Вы можете включить подробное логирование, чтобы отслеживать события, регистрируемые SDK, и убедиться в правильности их регистрации. Это касается как автоматически, так и вручную регистрируемых событий.

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

  1. В Xcode выберите Product > Scheme > Edit scheme...
  2. Выберите пункт «Выполнить» в меню слева.
  3. Выберите вкладку «Аргументы» .
  4. В разделе «Аргументы, передаваемые при запуске» добавьте -FIRAnalyticsVerboseLoggingEnabled .

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

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

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

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