В этом руководстве показано, как регистрировать события в вашем приложении.
События предоставляют информацию о том, что происходит в вашем приложении, например о действиях пользователя, системных событиях или ошибках.
Analytics автоматически записывает для вас некоторые события ; вам не нужно добавлять какой-либо код, чтобы получить их. Если вашему приложению необходимо собирать дополнительные данные, вы можете регистрировать до 500 различных типов событий аналитики в своем приложении. Нет ограничений на общий объем событий, регистрируемых вашим приложением. Обратите внимание, что имена событий чувствительны к регистру, и запись в журнал двух событий, имена которых различаются только регистром, приведет к возникновению двух разных событий.
Прежде чем вы начнете
Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics, как описано в разделе Начало работы с Analytics .
Журнал событий
После того, как вы настроили экземпляр FirebaseApp
, вы можете начать регистрировать события с помощью logEvent()
.
Чтобы помочь вам начать работу, Analytics SDK определяет ряд рекомендуемых событий, которые являются общими для различных типов приложений, включая приложения для розничной торговли и электронной коммерции, путешествия и игры. Чтобы узнать больше об этих событиях и о том, когда их использовать, см. Рекомендуемые события .
Подробности реализации можно найти в справочнике по константам для Swift и Objective-C .
В следующем примере показано, как зарегистрировать рекомендуемое событие kFIRSelectContent
:
Быстрый
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" }];
Помимо прописанных параметров, вы можете добавить к любому событию следующие параметры:
Специальные параметры. Специальные параметры можно использовать в качестве параметров или показателей в отчетах Google Analytics . Вы можете использовать специальные параметры для нечисловых данных параметров событий и специальные показатели для любых данных параметров, которые лучше представлены в числовом виде. Зарегистрировав настраиваемый параметр с помощью SDK, зарегистрируйте параметр или показатель, чтобы эти настраиваемые параметры отображались в отчетах Analytics. Для этого выполните следующие действия: Аналитика > События > Управление пользовательскими определениями > Создать пользовательские параметры .
Пользовательские параметры можно использовать в определениях аудитории , которые можно применять к каждому отчету. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery , если ваше приложение связано с проектом BigQuery. Найдите образцы запросов и многое другое в Google Analytics 4 BigQuery Export .
Параметр
kFIRParameterValue
:kFIRParameterValue
— это параметр общего назначения, который полезен для накопления ключевой метрики, относящейся к событию. Примеры включают доход, расстояние, время и баллы.
Если у вашего приложения есть особые потребности, которые не покрываются рекомендуемым типом события, вы можете регистрировать свои собственные пользовательские события, как показано в этом примере:
Быстрый
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.
Быстрый
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
Цель-C
[FIRAnalytics setDefaultEventParameters:
@{
@"level_name": "Caverns01",
@"level_difficulty": @(4)
}];
Если параметр указан в logEvent()
, вместо значения по умолчанию используется это значение.
Чтобы очистить параметр по умолчанию, вызовите метод setDefaultEventParameters
с параметром, установленным на nil
.
Просмотр событий в консоли отладки Xcode
Вы можете включить подробное ведение журнала, чтобы отслеживать регистрацию событий с помощью SDK, чтобы убедиться, что события регистрируются правильно. Это включает в себя как автоматически, так и вручную регистрируемые события.
Вы можете включить подробное ведение журнала следующим образом:
- В Xcode выберите Продукт > Схема > Редактировать схему...
- Выберите « Выполнить» в меню слева.
- Выберите вкладку « Аргументы ».
- В разделе « Аргументы , передаваемые при запуске» добавьте
-FIRAnalyticsDebugEnabled
.
В следующий раз, когда вы запустите свое приложение, ваши события отобразятся в консоли отладки Xcode, что поможет вам сразу же убедиться, что события отправляются.
Просмотр событий в панели управления
Вы можете просматривать сводную статистику о ваших событиях на информационных панелях консоли Firebase. Эти информационные панели периодически обновляются в течение дня. Для немедленного тестирования используйте выходные данные logcat, как описано в предыдущем разделе.
Вы можете получить доступ к этим данным на панели управления событиями в консоли Firebase. На этой панели отображаются отчеты о событиях, которые автоматически создаются для каждого отдельного типа событий, зарегистрированных вашим приложением.