Начните работу с Google Analytics для iOS+

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


В этом кратком руководстве показано, как добавить 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() .

Certain events are recommended for all apps ; others are recommended for specific business types or verticals. You should send suggested events along with their prescribed parameters, to ensure maximum available detail in your reports and to benefit from future features and integrations as they become available. This section demonstrates logging a pre-defined event, for more information on logging events, see Log events .

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

Быстрый 

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

Objective-C 

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

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

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

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