Как отправлять события

В этой статье описано, как отправлять данные о событиях из приложения в Аналитику с помощью SDK Google Аналитики для Firebase. О том, как отправлять данные о событиях с сайтов, можно узнать из этой статьи. Подробнее о событиях

Подготовка

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

Как отправлять события

Настроив экземпляр FirebaseApp, вы можете начать отправку событий с помощью метода logEvent(). Этот метод работает аналогично команде event в gtag.js.

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

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

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Objective-C

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

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

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

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

Swift

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. В меню слева нажмите Run (Выполнить).
  3. Перейдите на вкладку Arguments (Аргументы).
  4. В разделе Arguments Passed On Launch (Аргументы, передаваемые при запуске) добавьте -FIRAnalyticsDebugEnabled.

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

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

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

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