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

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

Обзор

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

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

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

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

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

Параметр Описание Примеры
utm_campaign Название кампании. Используется при анализе ключевых слов для идентификации определенной промоакции или кампании. utm_campaign=vesna_rasprodazha
utm_source Источник кампании. Позволяет идентифицировать поисковую систему, электронную рассылку или другой источник перехода. utm_source=google
utm_medium Канал кампании. Позволяет определить канал, через который поступил трафик: например, электронная почта (email) или реклама с оплатой за клик (cpc). utm_medium=cpc
utm_term Ключевое слово кампании. Позволяет определить ключевое слово, по которому объявление было показано в результатах поиска. utm_term=obuv+dlya+bega
utm_content Содержание кампании. Используется при тестировании А/Б и в контекстной рекламе. Позволяет различать объявления или ссылки, ведущие на один и тот же URL. utm_content=logolink
utm_content=textlink
gclid Параметр автоматической пометки ссылок AdWords. Используется для оценки эффективности объявлений GoogleAdWords. Это значение генерируется динамически, и менять его нельзя.

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

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

Самый простой способ реализовать отслеживание кампаний – использовать [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.