Начало работы с Google Аналитикой

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

Из этого краткого руководства вы узнаете, как добавить Google Analytics в свое приложение и начать регистрировать события.

Google Analytics собирает данные об использовании и поведении для вашего приложения. SDK регистрирует два основных типа информации:

• События: что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
• Свойства пользователя: Атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, например языковые предпочтения или географическое положение.

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

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

1. Если вы еще этого не сделали, добавьте Firebase в свой проект Apple и убедитесь, что в вашем проекте Firebase включен Google Analytics :

   • Если вы создаете новый проект Firebase, включите Google Analytics во время процесса создания проекта.

   • Если вы используете существующий проект Firebase, в котором не включен Google Analytics , перейдите на вкладку «Интеграции» вашего settings > Настройки проекта , чтобы включить его.

   Когда вы включаете Google Analytics в своем проекте, ваши приложения Firebase связываются с потоками данных Google Analytics .

2. (Рекомендуется) . Добавьте фреймворк AdSupport в свой проект , чтобы включить дополнительные функции, такие как аудитории и атрибуция кампаний.

Добавьте Analytics SDK в свое приложение

Используйте Swift Package Manager для установки и управления зависимостями Firebase.

1. В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .
2. При появлении соответствующего запроса добавьте репозиторий Firebase Apple platform SDK:

  https://github.com/firebase/firebase-ios-sdk.git

3. Выберите библиотеку Analytics .
4. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
5. Для оптимального опыта работы с Analytics мы рекомендуем включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать либо библиотеку без сбора IDFA, либо с сбором IDFA. Ознакомьтесь с нашими часто задаваемыми вопросами о последней организации модулей в Google Analytics для Firebase SDK .
6. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Подробнее об IDFA, рекламном идентификаторе на уровне устройства, читайте в документации Apple «Конфиденциальность данных и использование данных пользователей , а также прозрачность отслеживания приложений» .

Далее выполните некоторые шаги по настройке:

1. Импортируйте модуль FirebaseCore в ваш UIApplicationDelegate , а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Быстрый

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Настройте общий экземпляр FirebaseApp в методе делегата приложения application application(_:didFinishLaunchingWithOptions:) :

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Быстрый

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Если вы используете 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 (Boolean) в файле info.plist вашего приложения.

Начать регистрацию событий

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

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

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

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

Чтобы просмотреть это событие в консоли отладки Xcode, включите отладку Analytics:

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

Следующие шаги

• Понимание каждого отчета Analytics .
• Используйте DebugView для проверки ваших событий.
• Исследуйте свои данные в консоли Firebase .
• Изучите руководства по событиям и свойствам пользователей.
• Узнайте, как экспортировать данные в BigQuery.