В этой статье описано, как отправлять данные о событиях из приложения в Аналитику с помощью SDK Google Аналитики для Firebase. О том, как отправлять данные о событиях с сайтов, можно узнать из этой статьи. Подробнее о событиях…
Подготовка
Убедитесь, что у вас настроен проект и есть доступ к Аналитике, как описано в статье Начало работы с Google Аналитикой.
Как отправлять события
Настроив экземпляр FirebaseApp
, вы можете начать отправку событий с помощью метода logEvent()
. Этот метод работает аналогично команде event в gtag.js.
Ниже указано, где можно найти подробную информацию об использовании предлагаемых типов событий.
- Рекомендуемые события: смотрите справочное руководство по классу com.google.firebase.analytics.FirebaseAnalytics.Event.
- Предписанные параметры: смотрите справочное руководство по com.google.firebase.analytics.FirebaseAnalytics.Param.
В примере ниже показано, как отправлять рекомендуемое событие 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. Это относится к событиям, регистрируемым как автоматически, так и вручную.
Чтобы включить ведение подробных журналов:
- В Xcode выберите Product (Продукт) > Scheme (Схема) > Edit scheme (Изменить схему).
- В меню слева нажмите Run (Выполнить).
- Перейдите на вкладку Arguments (Аргументы).
- В разделе Arguments Passed On Launch (Аргументы, передаваемые при запуске) добавьте
-FIRAnalyticsDebugEnabled
.
При следующем запуске приложения ваши события отобразятся в консоли отладки Xcode. Так вы сразу сможете проверить, отправляются ли события.
Как просматривать события на панели управления
Вы можете просматривать сводную статистику о событиях на панелях управления в консоли Firebase. Они периодически обновляются в течение дня. Для оперативного тестирования используйте выходные данные Logcat, как описано в предыдущем разделе.
Эти данные доступны на панели управления Events (События) в консоли Firebase, где отображаются отчеты, которые создаются автоматически для каждого типа событий, зарегистрированных вашим приложением.