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

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

Обзор

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

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

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

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

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

Параметр Описание Пример
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 Содержание кампании. Используется при тестировании А/Б и в контекстной рекламе. Позволяет различать объявления или ссылки, ведущие на один и тот же URL. utm_content=logolink
utm_content=textlink
gclid Параметр автоматической пометки ссылок AdWords. Используется для оценки эффективности объявлений Google AdWords. Это значение генерируется динамически, и менять его нельзя.

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

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

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

/*
 * 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 Analytics, а в какой-либо другой форме, вы можете задать ее в 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 Analytics позволяет определить, из каких источников перешли пользователи, загрузившие ваше приложение iOS. У вас также есть возможность создавать собственные URL для дополнительных рекламных сетей.

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

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

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

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

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

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

  1. Нажмите на вкладку Администратор.

    Вкладка "Администратор"

  2. Выберите нужный ресурс и нажмите Настройки ресурса.

    Настройки ресурса

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

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

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

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

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

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

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

Для отслеживания кампаний iOS службе Google Analytics нужен идентификатор для рекламодателя (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 Analytics использует идентификатор IDFA при создании демографических отчетов. Войдите в Google Analytics, откройте вкладку Отчеты и выберите Аудитория > Демография > Обзор. Отображаются ли данные отчета? Если да, значит идентификаторы IDFA отправляются корректно.

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

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

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

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

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

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