В этом кратком руководстве показано, как добавить 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 для установки и управления зависимостями Firebase.
- В Xcode при открытом проекте приложения перейдите в File > Add Packages .
- При появлении запроса добавьте репозиторий SDK Firebase для платформ Apple:
- Выберите библиотеку Analytics.
- Для оптимальной работы с Analytics мы рекомендуем включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать библиотеку без коллекции IDFA или с коллекцией IDFA.
- Когда закончите, Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.
https://github.com/firebase/firebase-ios-sdk
Узнайте больше об IDFA, рекламном идентификаторе на уровне устройства, в документации Apple «Конфиденциальность пользователей и использование данных и прозрачность отслеживания приложений ».
Далее выполните несколько шагов настройки:
- Импортируйте модуль
FirebaseCore
в свойUIApplicationDelegate
, а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и аутентификацию:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Быстрый
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Цель-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Настройте общий экземпляр
FirebaseApp
в методе applicationapplication(_: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
. Вы также должны отключить swizzling делегата приложения. Дополнительные сведения см. в инструкциях 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
.
Следующие шаги
- Используйте DebugView для проверки событий.
- Исследуйте свои данные в консоли Firebase.
- Изучите руководства по событиям и свойствам пользователей.
- Узнайте, как экспортировать данные в BigQuery.