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


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

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

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

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

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

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

    • При создании нового проекта Firebase включите Google Analytics в процессе создания проекта.

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

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

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

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

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

  1. В Xcode, открыв проект приложения, перейдите в меню File > Add Packages .
  2. При появлении запроса добавьте репозиторий Firebase Apple Platforms SDK: 
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Выберите библиотеку Analytics .
  4. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» в настройках сборки вашей целевой системы.
  5. Для оптимальной работы с Analytics мы рекомендуем включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать библиотеку без сбора данных IDFA или с сбором данных IDFA. См. раздел часто задаваемых вопросов (FAQ) о последней организации модулей в 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(_: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 . Также необходимо отключить подмену делегатов приложения. Для получения дополнительной информации см. инструкции 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() .

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

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

Быстрый

Примечание: Данный продукт Firebase недоступен на целевой платформе macOS. 
Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C

Примечание: Данный продукт Firebase недоступен на целевой платформе macOS. 
[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

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

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

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