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

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

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

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

Прежде чем вы начнете

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

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

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

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

Вы можете найти детали реализации в задании констант для Swift и Objective-C .

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

Быстрый

Примечание: Этот продукт Firebase не доступен на целевом MacOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Цель-C

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

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

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

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

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

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

Быстрый

Примечание: Этот продукт Firebase не доступен на целевом MacOS.
Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Цель-C

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

Установить параметры события по умолчанию

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

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

Быстрый

Примечание: Этот продукт Firebase не доступен на целевом MacOS.
Analytics.setDefaultEventParameters([ "level_name": "Caverns01", "level_difficulty": 4 ])

Цель-C

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

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

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

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

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

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

  1. В Xcode, выберите продукт> Схема> Изменить схему ...
  2. Выберите Выполнить в меню слева.
  3. Выберите вкладку Аргументы.
  4. В аргументах , передаваемых на раздел Launch, добавить -FIRAnalyticsDebugEnabled .

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

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

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

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