Catch up on everthing we announced at this year's Firebase Summit. Learn more

Начать работу с Google Analytics

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

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

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

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

Прежде чем вы начнете

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

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

    • Если вы используете существующий проект Firebase , который не включен Google Analytics, перейдите на интеграциях вкладку ваших > Настройка проекта , чтобы включить его.

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

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

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

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

  1. В Xcode, с приложением проекта открыто, перейдите в меню Файл> Swift пакеты> Добавить пакет Завис.
  2. При появлении запроса добавьте репозиторий Firebase Apple Platform SDK:
  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. Импорт модуля Firebase в вашем UIApplicationDelegate :

    Быстрый

    import Firebase

    Цель-C

    @import Firebase;
  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 (Boolean) в 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. В аргументах , передаваемых на раздел Launch, добавить -FIRAnalyticsDebugEnabled .

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