Это руководство посвящено тому, как добавить 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]];
Дополнительная информация
- Подробнее о том, как использовать Google Analytics для анализа действий пользователей, читайте в руководстве по внедрению для мобильных приложений.
- Ознакомьтесь с дополнительными параметрами конфигурации, такими как образцы, тестирование и отладка, а также настройки отключения и т. п.
- Если необходимо, включите дополнительные функции, такие как расширенная электронная торговля, IDFA (идентификатор для рекламодателей), и решение для размещения рекламы iAd.