Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Начните работу с 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 в свой проект , чтобы включить дополнительные функции, такие как аудитории и атрибуция кампании.

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

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

  1. В Xcode при открытом проекте приложения перейдите в File > Add Packages .
  2. При появлении запроса добавьте репозиторий SDK Firebase для платформ Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Выберите библиотеку Analytics.
  5. Для оптимальной работы с Analytics мы рекомендуем включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать библиотеку без коллекции IDFA или с коллекцией IDFA.
  6. Когда закончите, Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

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

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

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

    Быстрый

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Цель-C

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

    Быстрый

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

    Цель-C

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


(Необязательно) Отключите регистрацию атрибуции рекламной сети Apple.

Для вашего удобства SDK автоматически регистрирует ваше приложение в Apple для атрибуции рекламной сети с помощью SKAdNetwork . Если вы хотите отключить эту функцию, установите для параметра GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED значение NO (логическое значение) в файле info.plist вашего приложения.

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

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

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

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

Быстрый

Примечание. Этот продукт Firebase недоступен для macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Цель-C

Примечание. Этот продукт Firebase недоступен для macOS.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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

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

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