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

Выберите платформу: iOS+ Android Веб Flutter Unity C++


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

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

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

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

Подготовка

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

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

    • Если вы используете имеющийся проект Firebase, в котором не включена Google Analytics, откройте Settings (Настройки) > Integrations (Интеграция) и включите ее.

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

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

Как добавить в приложение Analytics SDK

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

  1. Откройте проект приложения в Xcode и перейдите в меню File (Файл) > Add Packages (Добавить пакеты).
  2. Когда появится запрос, добавьте хранилище Firebase SDK для платформ Apple:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Выберите библиотеку Analytics.
  4. Добавьте флаг -ObjC в раздел Other Linker Flags (Другие флаги компоновщика) в настройках сборки целевого объекта.
  5. Чтобы использовать Analytics с максимальной эффективностью, мы рекомендуем включить Google Analytics в проекте Firebase и добавить в приложение Firebase SDK для Google Аналитики. Вы можете выбрать подходящую библиотеку в зависимости от того, нужно ли собирать IDFA. Ознакомьтесь с часто задаваемыми вопросами о последней организации модулей в Google Analytics для Firebase SDK.
  6. После этого Xcode автоматически начнет распознавать и скачивать зависимости в фоновом режиме.

Подробные сведения о IDFA (рекламном идентификаторе на уровне устройства) вы найдете в документации Apple User Privacy and Data Use (Конфиденциальность пользователей и использование данных) и App Tracking Transparency (Прозрачность отслеживания приложений).

Затем выполните настройку:

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

    SwiftUI

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

    Swift

    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()

    Swift

    // 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().

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

  1. В Xcode выберите Product (Продукт) > Scheme (Схема) > Edit scheme (Изменить схему).
  2. В меню слева нажмите Run (Выполнить).
  3. Перейдите на вкладку Arguments (Аргументы).
  4. В разделе Arguments Passed On Launch (Аргументы, передаваемые при запуске) добавьте -FIRAnalyticsDebugEnabled.

Дальнейшие действия