Начало работы с 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.

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