Как регистрировать события

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

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

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

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

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

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

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

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

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

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

Как настроить параметры по умолчанию для событий

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

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

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

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

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

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

Как просматривать события в консоли отладки Xcode

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

Чтобы включить ведение подробных журналов:

1. В Xcode выберите Product (Продукт) > Scheme (Схема) > Edit scheme (Изменить схему).
2. В меню слева нажмите Run (Выполнить).
3. Перейдите на вкладку Arguments (Аргументы).
4. В разделе Arguments Passed On Launch (Аргументы, передаваемые при запуске) добавьте -FIRAnalyticsVerboseLoggingEnabled.

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

Как просматривать события на панели управления

В консоли Firebase можно просматривать сводную статистику о событиях на панели управления Аналитика > События.

Обратите внимание на следующее:

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

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