Отслеживание кампаний: SDK для iOS

В этом документе представлена основная информация об отслеживании кампаний и источников трафика с помощью SDK Google Analytics для iOS версии 3.

Обзор

Отслеживание кампаний в Google Аналитике позволяет связывать действия пользователей в вашем приложении с определенными кампаниями и источниками трафика. SDK Google Analytics для iOS дает следующие возможности:

Определение источников установки приложения iOS – узнайте, какие кампании и приложения направляют пользователей в магазин iTunes для установки вашего приложения.
Определение кампаний и источников трафика – узнайте, по ссылкам из каких кампаний и других источников запускалось ваше приложение после установки.

Из следующих разделов вы узнаете, как реализовать отслеживание кампаний в своем приложении.

Параметры кампании

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

В этой таблице перечислены параметры кампании, которые вы можете использовать:

Параметр	Описание	Пример
`utm_campaign`	Название кампании. Используется при анализе ключевых слов для идентификации определенной промоакции или кампании.	`utm_campaign=spring_sale`
`utm_source`	Источник кампании. Позволяет идентифицировать поисковую систему, электронную рассылку или другой источник перехода.	`utm_source=google`
`utm_medium`	Канал кампании. Позволяет определить канал, через который поступил трафик, например электронная почта (email) или реклама с оплатой за клик (cpc).	`utm_medium=cpc`
`utm_term`	Ключевое слово кампании. Позволяет определить ключевое слово, по которому было показано объявление в результатах поиска.	`utm_term=running+shoes`
`utm_content`	Содержание кампании. Используется при A/B-тестировании и в объявлениях с таргетингом на контент. Позволяет различать объявления или ссылки, ведущие на один и тот же URL.	`utm_content=logolink` `utm_content=textlink`
`gclid`	Параметр автоматической пометки в Google Рекламе. Используется для сбора данных по эффективности объявлений. Это значение генерируется динамически, и менять его нельзя.

Определение кампаний и источников трафика

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

Самый простой способ реализовать отслеживание кампаний – использовать [GAIDictionaryBuilder setCampaignParametersFromUrl:urlString], где urlString – строка, представляющая URL, который может содержать параметры отслеживания кампании Google Аналитики. Обратите внимание, что в приведенных далее примерах данные о кампании не задаются в трекере напрямую, так как это делается лишь один раз:

/*
 * MyAppDelegate.m
 *
 * An example of how to implement campaign and referral attribution.
 * If no Google Analytics campaign parameters are set in the referring URL,
 * use the hostname as a referrer instead.
 */

// For iOS 9.0 and later
- (BOOL)application:(UIApplication *)app openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *,id> *)options {

// For iOS versions prior to 9.0
//- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
//  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

  NSString *urlString = [url absoluteString];

  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithName:@"tracker"
                                                      trackingId:@"UA-XXXX-Y"];

  // setCampaignParametersFromUrl: parses Google Analytics campaign ("UTM")
  // parameters from a string url into a Map that can be set on a Tracker.
  GAIDictionaryBuilder *hitParams = [[GAIDictionaryBuilder alloc] init];

  // Set campaign data on the map, not the tracker directly because it only
  // needs to be sent once.
  [hitParams setCampaignParametersFromUrl:urlString];

  // Campaign source is the only required campaign field. If previous call
  // did not set a campaign source, use the hostname as a referrer instead.
  if(![hitParams get:kGAICampaignSource] && [url host].length !=0) {
    // Set campaign data on the map, not the tracker.
    [hitParams set:@"referrer" forKey:kGAICampaignMedium];
    [hitParams set:[url host] forKey:kGAICampaignSource];
  }

  NSDictionary *hitParamsDict = [hitParams build];

  // A screen name is required for a screen view.
  [tracker set:kGAIScreenName value:@"screen name"];

  // Previous V3 SDK versions.
  // [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:hitParamsDict] build]];

  // SDK Version 3.08 and up.
  [tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:hitParamsDict] build]];

Если информация о кампании передается не с помощью параметров Google Аналитики, а в какой-либо другой форме, вы можете задать ее в NSDictionary и отправить вручную:

// Assumes at least one tracker has already been initialized.
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

// Note that it's not necessary to set kGAICampaignKeyword for this email campaign.
NSDictionary *campaignData = [NSDictionary dictionaryWithObjectsAndKeys:
    @"email", kGAICampaignSource,
    @"email_marketing", kGAICampaignMedium,
    @"summer_campaign", kGAICampaignName,
    @"email_variation1", kGAICampaignContent, nil];

// A screen name is required for a screen view.
[tracker set:kGAIScreenName value:@"screen name"];

// Note that the campaign data is set on the Dictionary, not the tracker.
// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:campaignData] build]];

// SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:campaignData] build]];

Определение источников загрузок приложения iOS

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

Чтобы отслеживать источники скачивания приложения iOS, создайте целевые URL объявлений, по которым пользователи переходят в App Store. Это можно сделать с помощью специального инструмента (подробнее о нем читайте ниже). В приложении iOS уже должно быть реализовано отслеживание Google Аналитики (например, просмотров экрана или событий) и сбор рекламных идентификаторов IDFA. Для автоматического отслеживания кампаний iAd в приложение также нужно добавить дополнительный фреймворк.

Диагностика неполадок с отслеживанием конверсий в iOS

Если конверсии в результате установки приложений iOS не регистрируются, выполните следующие действия:

Убедитесь, что отслеживание кампаний для iOS включено.
Проверьте, верно ли указан идентификатор приложения.
Проверьте, отправляется ли идентификатор IDFA.
Откройте отчет по демографическим данным и убедитесь, что идентификатор IDFA отправлен.
Убедитесь в правильности URL отслеживания кампаний для iOS.

1. Убедитесь, что отслеживание кампаний для iOS включено

Выполните следующие действия:

Нажмите на вкладку Администратор.
Выберите нужный ресурс и нажмите Настройки ресурса.
Убедитесь, что переключатель Отслеживание кампаний для приложений iOS находится в положении ВКЛ.

Примечание. Если отслеживание кампаний будет выключено, Google Аналитика не сможет связать данные кампании iOS с вашим приложением.

2. Проверьте, верно ли указан идентификатор приложения

Чтобы связать кампанию с данными приложения, в URL отслеживания кампаний для приложений iOS и используемых вами средствах отслеживания нужно указать одинаковый идентификатор приложения. Чтобы определить его, создайте специальный отчет в веб-интерфейсе Google Аналитики, указав идентификатор приложения в качестве параметра и сеансы в качестве показателя.

При создании URL отслеживания кликов в кампаниях для приложений iOS укажите идентификатор приложения, приведенный в отчете.

Создание специального отчета

3. Проверьте, отправляется ли идентификатор IDFA.

Для отслеживания кампаний iOS службе Google Аналитики нужен идентификатор для рекламодателя (IDFA). Проверьте следующее:

Приложение должно использовать SDK Google Analytics для iOS версии 3.10 или выше.
Если вы используете автономную загрузку SDK:
- Приложение должно быть связано с библиотекой libAdIdAccess.a, входящей в состав Google Analytics для iOS.
- Приложение должно быть связано с AdSupport.framework.
Если вы используете CocoaPods для управления зависимыми компонентами, добавьте контейнер GoogleIDFASupport в файл контейнера:
```
pod 'GoogleIDFASupport'
```
Для каждого счетчика должен быть включен сбор IDFA.
```
tracker.allowIDFACollection = YES;
```
При возможности проверьте наличие IDFA в запросах с помощью отладочного прокси-приложения.

4. Откройте отчет по демографическим данным и убедитесь, что идентификатор IDFA отправлен.

Google Аналитика использует идентификатор IDFA при создании демографических отчетов. В Google Аналитике откройте вкладку Отчеты и выберите Аудитория > Демографические данные > Обзор. Проверьте, показаны ли демографические данные. Если да, значит идентификаторы IDFA отправляются корректно.

Специальный отчет

5. Убедитесь в правильности URL отслеживания кампаний для iOS.

С помощью Генератора URL для приложений iOS проверьте правильность URL отслеживания.

Выбирая в меню "Рекламная сеть" вариант Custom (Особая), убедитесь, что указанная вами сеть поддерживает отслеживание отдельных идентификаторов устройств при помощи URL переадресации. В противном случае вы не увидите никаких данных в отчетах Google Аналитики.

Генератор URL для приложений iOS

С помощью этого инструмента вы сможете создавать URL для регистрации источников установок вашего приложения для iOS.

Важно! В URL отслеживания Рекламы в приложении необходимо использовать параметр &hash=md5. Компоновщик URL для iOS добавляет этот параметр автоматически. Если вы создаете URL-адреса вручную, обязательно укажите этот параметр, чтобы отслеживание источников загрузок работало правильно. Если вы используете рекламные сети, отличные от Рекламы в приложении, параметр &hash=md5 не обязателен.