В этом кратком руководстве показано, как добавить Google Analytics в свое приложение и начать регистрировать события.
Google Analytics собирает данные об использовании и поведении вашего приложения. SDK регистрирует два основных типа информации:
- События. Что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
- Свойства пользователя: атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, например языковые предпочтения или географическое местоположение.
Analytics автоматически регистрирует некоторые события и свойства пользователей ; вам не нужно добавлять какой-либо код, чтобы включить их.
Прежде чем начать
Если вы еще этого не сделали, добавьте Firebase в свой проект Apple и убедитесь, что Google Analytics включен в вашем проекте Firebase:
Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
Если вы используете существующий проект Firebase, в котором не включен Google Analytics , перейдите на вкладку «Интеграции» вашего
Когда вы включаете Google Analytics в своем проекте, ваши приложения Firebase связаны с потоками данных Google Analytics .
(Рекомендуется) . Добавьте в свой проект платформу AdSupport , чтобы включить дополнительные функции, такие как аудитория и атрибуция кампании.
Добавьте Analytics SDK в свое приложение
Используйте Swift Package Manager для установки зависимостей Firebase и управления ими.
- В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .
- При появлении запроса добавьте репозиторий Firebase SDK для платформ Apple:
- Выберите библиотеку Analytics .
- Добавьте флаг
-ObjC
в раздел «Другие флаги компоновщика» настроек сборки вашей цели. - Для оптимальной работы с Analytics мы рекомендуем включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать библиотеку без коллекции IDFA или с коллекцией IDFA.
- По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.
https://github.com/firebase/firebase-ios-sdk.git
Узнайте больше об IDFA, рекламном идентификаторе на уровне устройства, в документации Apple по конфиденциальности пользователей, использованию данных и прозрачности отслеживания приложений .
Далее выполните несколько шагов настройки:
- Импортируйте модуль
FirebaseCore
в свойUIApplicationDelegate
, а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Быстрый
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Цель-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Настройте общий экземпляр
FirebaseApp
в методеapplication(_:didFinishLaunchingWithOptions:)
делегата вашего приложения:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Быстрый
// Use Firebase library to configure APIs FirebaseApp.configure()
Цель-C
// Use Firebase library to configure APIs [FIRApp configure];
- Если вы используете SwiftUI, вам необходимо создать делегат приложения и прикрепить его к структуре вашего
App
черезUIApplicationDelegateAdaptor
илиNSApplicationDelegateAdaptor
. Вы также должны отключить переключение делегатов приложений. Дополнительную информацию смотрите в инструкциях SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(Необязательно) Отключите регистрацию атрибуции рекламной сети Apple.
Для вашего удобства SDK автоматически регистрирует ваше приложение в Apple для атрибуции рекламной сети с помощью SKAdNetwork . Если вы хотите отключить эту функцию, установите для параметра GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
значение NO
(логическое значение) в файле info.plist вашего приложения.
Начните регистрировать события
После того, как вы настроили экземпляр FirebaseApp
, вы можете начать регистрировать события с помощью метода logEvent()
.
Определенные события рекомендуются для всех приложений ; другие рекомендуются для конкретных типов бизнеса или вертикалей. Вам следует отправлять предлагаемые события вместе с предписанными для них параметрами, чтобы обеспечить максимально подробную информацию в ваших отчетах и воспользоваться преимуществами будущих функций и интеграций по мере их появления. В этом разделе демонстрируется регистрация предварительно определенного события. Дополнительную информацию о регистрации событий см. в разделе Журнал событий .
В следующем примере показано, как зарегистрировать рекомендуемое событие, указывающее, что пользователь нажал на определенный элемент в вашем приложении:
Быстрый
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" }];
Чтобы просмотреть это событие в консоли отладки Xcode, включите отладку Analytics:
- В Xcode выберите «Продукт» > «Схема» > «Редактировать схему»...
- Выберите «Выполнить» в меню слева.
- Выберите вкладку Аргументы .
- В разделе «Аргументы, передаваемые при запуске» добавьте
-FIRAnalyticsDebugEnabled
.
Следующие шаги
- Понимание каждого отчета Google Analytics .
- Используйте DebugView для проверки ваших событий.
- Изучите свои данные в консоли Firebase .
- Изучите руководства по событиям и свойствам пользователя.
- Узнайте, как экспортировать данные в BigQuery.
В этом кратком руководстве показано, как добавить Google Analytics в свое приложение и начать регистрировать события.
Google Analytics собирает данные об использовании и поведении вашего приложения. SDK регистрирует два основных типа информации:
- События. Что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
- Свойства пользователя: атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, например языковые предпочтения или географическое местоположение.
Analytics автоматически регистрирует некоторые события и свойства пользователей ; вам не нужно добавлять какой-либо код, чтобы включить их.
Прежде чем начать
Если вы еще этого не сделали, добавьте Firebase в свой проект Apple и убедитесь, что Google Analytics включен в вашем проекте Firebase:
Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
Если вы используете существующий проект Firebase, в котором не включена Google Analytics , перейдите на вкладку «Интеграции» вашего
Когда вы включаете Google Analytics в своем проекте, ваши приложения Firebase связаны с потоками данных Google Analytics .
(Рекомендуется) . Добавьте в свой проект платформу AdSupport , чтобы включить дополнительные функции, такие как аудитория и атрибуция кампании.
Добавьте Analytics SDK в свое приложение
Используйте Swift Package Manager для установки зависимостей Firebase и управления ими.
- В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .
- При появлении запроса добавьте репозиторий Firebase SDK для платформ Apple:
- Выберите библиотеку Analytics .
- Добавьте флаг
-ObjC
в раздел «Другие флаги компоновщика» настроек сборки вашей цели. - Для оптимальной работы с Analytics мы рекомендуем включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать библиотеку без коллекции IDFA или с коллекцией IDFA.
- По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.
https://github.com/firebase/firebase-ios-sdk.git
Узнайте больше об IDFA, рекламном идентификаторе на уровне устройства, в документации Apple по конфиденциальности пользователей, использованию данных и прозрачности отслеживания приложений .
Далее выполните несколько шагов настройки:
- Импортируйте модуль
FirebaseCore
в свойUIApplicationDelegate
, а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Быстрый
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Цель-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Настройте общий экземпляр
FirebaseApp
в методеapplication(_:didFinishLaunchingWithOptions:)
делегата вашего приложения:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Быстрый
// Use Firebase library to configure APIs FirebaseApp.configure()
Цель-C
// Use Firebase library to configure APIs [FIRApp configure];
- Если вы используете SwiftUI, вам необходимо создать делегат приложения и прикрепить его к структуре вашего
App
черезUIApplicationDelegateAdaptor
илиNSApplicationDelegateAdaptor
. Вы также должны отключить переключение делегатов приложений. Дополнительную информацию смотрите в инструкциях SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(Необязательно) Отключите регистрацию атрибуции рекламной сети Apple.
Для вашего удобства SDK автоматически регистрирует ваше приложение в Apple для атрибуции рекламной сети с помощью SKAdNetwork . Если вы хотите отключить эту функцию, установите для параметра GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
значение NO
(логическое значение) в файле info.plist вашего приложения.
Начните регистрировать события
После того, как вы настроили экземпляр FirebaseApp
, вы можете начать регистрировать события с помощью метода logEvent()
.
Определенные события рекомендуются для всех приложений ; другие рекомендуются для конкретных типов бизнеса или вертикалей. Вам следует отправлять предлагаемые события вместе с предписанными для них параметрами, чтобы обеспечить максимально подробную информацию в ваших отчетах и воспользоваться преимуществами будущих функций и интеграций по мере их появления. В этом разделе демонстрируется регистрация предварительно определенного события. Дополнительную информацию о регистрации событий см. в разделе Журнал событий .
В следующем примере показано, как зарегистрировать рекомендуемое событие, указывающее, что пользователь нажал на определенный элемент в вашем приложении:
Быстрый
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" }];
Чтобы просмотреть это событие в консоли отладки Xcode, включите отладку Analytics:
- В Xcode выберите «Продукт» > «Схема» > «Редактировать схему»...
- Выберите «Выполнить» в меню слева.
- Выберите вкладку Аргументы .
- В разделе «Аргументы, передаваемые при запуске» добавьте
-FIRAnalyticsDebugEnabled
.
Следующие шаги
- Понимание каждого отчета Google Analytics .
- Используйте DebugView для проверки ваших событий.
- Изучите свои данные в консоли Firebase .
- Изучите руководства по событиям и свойствам пользователя.
- Узнайте, как экспортировать данные в BigQuery.