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

Это руководство посвящено тому, как добавить Google Analytics в приложение iOS, чтобы отслеживать действия пользователей на определенных экранах. Если у вас его нет, воспользуйтесь нашим тестовым приложением.

В Google Analytics для установки зависимостей и управления ими применяется инструмент CocoaPods. Откройте окно терминала и перейдите в папку проекта Xcode для своего приложения. Если вы ещё не создали файл контейнера для своего приложения, сделайте это сейчас.

pod init

Откройте файл контейнера и добавьте следующий код:

pod 'Google/Analytics'

Сохраните файл и выполните команду:

pod install

Будет создан файл .xcworkspace для вашего приложения. Используйте его в дальнейшей работе.

Скачайте файл конфигурации

Нажмите на кнопку ниже, чтобы получить файл конфигурации для проекта.

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

Скачать файл конфигурации

Добавьте в проект файл конфигурации

Перетащите скачанный файл GoogleService-Info.plist в корневой каталог проекта Xcode и добавьте его ко всем целям.

Инициализируйте Google Analytics для приложения

Теперь, когда у вас есть файл конфигурации, можно начинать внедрение. Для начала настройте общий объект Google Analytics внутри AppDelegate, чтобы приложение могло отправлять данные в Google Analytics. Выполните следующие действия:

  • Включите необходимые заголовки.
  • Установите счетчик Analytics внутри didFinishLaunchingWithOptions.
  • Отправьте сведения об исключениях и журналировании (необязательно).

Чтобы внести эти правки, сначала добавьте Google Analytics в AppDelegate:

#import <Google/Analytics.h>

Затем переопределите метод didFinishLaunchingWithOptions для настройки GGLContext.

// Настройка счетчика на основе данных файла GoogleService-Info.plist.
NSError *configureError;
[[GGLContext sharedInstance] configureWithError:&configureError];
NSAssert(!configureError, @"Error configuring Google services: %@", configureError);

// Настройка параметров GAI (необязательно).
GAI *gai = [GAI sharedInstance];
gai.trackUncaughtExceptions = YES;  // Сообщает о неперехваченных исключениях.
gai.logger.logLevel = kGAILogLevelVerbose;  // Удалить перед выпуском приложения. 

Добавьте отслеживание экранов

На данном этапе вы отправляете именованный вид экрана в Google Analytics, когда пользователь открывает или переключает экран в приложении. Откройте контроллер представления, которое вы хотите отслеживать. Ели это новое приложение, откройте контроллер представления по умолчанию. Код должен выполнять следующие действия:

  • добавлять заголовок <Google/Analytics.h>;
  • использовать для добавления отслеживания экрана метод viewWillAppear или переопределение функции;
  • указывать название экрана и выполнять отслеживание.
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];
[tracker set:kGAIScreenName value:name];
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];

Дополнительная информация