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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

Прежде чем начать

Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics как описано в разделе «Начало работы с Analytics .

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

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

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

Подробности реализации можно найти в справочнике по константам для Swift и Objective-C .

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

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

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

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

• Специальные параметры. Специальные параметры можно использовать в качестве параметров или показателей в отчетах 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,
])
PatternTabBarController.swift

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Прежде чем начать

Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics как описано в разделе «Начало работы с Analytics .

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

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

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

Подробности реализации можно найти в справочнике по константам для Swift и Objective-C .

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

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

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

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

• Специальные параметры. Специальные параметры можно использовать в качестве параметров или показателей в отчетах 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,
])
PatternTabBarController.swift

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Прежде чем начать

Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics , как описано в начале работы с Analytics .

События журнала

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

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

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

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

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

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

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

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

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

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

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

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

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
PatternTabBarController.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 выберите «Продукт»> «Схема»> «Редактировать схему ...
2. Выберите запустить из левого меню.
3. Выберите вкладку «Аргументы» .
4. В аргументах, принятых в разделе запуска , добавить -FIRAnalyticsVerboseLoggingEnabled .

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

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

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

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

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

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

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

Прежде чем начать

Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics , как описано в начале работы с Analytics .

События журнала

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

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

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

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

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

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

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

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

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

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

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

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

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
PatternTabBarController.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 выберите «Продукт»> «Схема»> «Редактировать схему ...
2. Выберите запустить из левого меню.
3. Выберите вкладку «Аргументы» .
4. В аргументах, принятых в разделе запуска , добавить -FIRAnalyticsVerboseLoggingEnabled .

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

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

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

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