Check out what’s new from Firebase at Google I/O 2022. Learn more

Начните работу с 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
  3. Выберите библиотеку Analytics.
  4. Для оптимальной работы с Analytics мы рекомендуем включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать библиотеку без коллекции IDFA или с коллекцией IDFA.
  5. Когда закончите, Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

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

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

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

    Быстрый

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Цель-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Настройте общий экземпляр FirebaseApp , как правило, в методе инициализатора App или делегата 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 .

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