Специальные параметры и показатели: iOS SDK

Из этого руководства вы узнаете об использовании специальных параметров и показателей в SDK Google Analytics для iOS версии 3.

Обзор

Специальные параметры позволяют связывать метаданные с обращениями, пользователями и сеансами Google Analytics, а специальные показатели – создавать собственные определения для измерения данных.

  1. Настройте специальный параметр или показатель в веб-интерфейсе Google Analytics. Подробнее…
  2. Задайте и отправьте значения специального параметра или показателя из приложения.

Специальные параметры и показатели включают два поля:

  • NSNumber: порядковый номер с шагом в единицу.
  • NSString: значение. В случае показателей оно обрабатывается как целое число или, если это валюта, десятичное число с фиксированной точкой.

Установка и отправка значений

Ниже показано, как задать и отправить значение специального параметра.

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] build]];

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

Вот как задать и отправить значение специального показателя:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

О чем важно помнить

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

Особенности реализации специальных параметров

Значения с областью действия "Пользователь" и "Сеанс" применяются к предыдущим обращениям.

  • Значения специальных параметров на уровне пользователя и сеанса применяются ко всем обращениям в текущем сеансе, включая предыдущие. Чтобы этого избежать, можно начать новый сеанс, прежде чем применять значение к обращению.
  • Допустим, в качестве значения специального параметра на уровне пользователя задан тип участия. Если пользователь перейдет на следующий уровень участия в середине текущего сеанса, вам нужно будет начать другой сеанс, прежде чем устанавливать новое значение специального параметра. Благодаря этому обращения, произошедшие до перехода, будут связаны со старым типом участия, а произошедшие после него – с новым.

Влияние фильтров, установленных в представлении (профиле), на специальные параметры.

  • Значения специального параметра на уровне пользователя или сеанса по-прежнему будут применяться ко всем обращениям в текущем сеансе и/или будущих сеансах, даже если эти обращения фильтруются из представления (профиля).
  • Обращения фильтруются в соответствии с областью действия значения специального параметра. Подробнее...

Особенности реализации специальных показателей

Значения специальных показателей суммируются в отчетах.

  • Значения специальных показателей, так же как и стандартных, суммируются в отчетах Google Analytics. Таким образом, чтобы увеличить итог на единицу, необходимо задать для специального показателя значение 1.

Как влияют фильтры, заданные в представлении или профиле, на специальные показатели.

  • Как правило, значения специальных показателей можно задавать, когда это вам удобно, однако постарайтесь не делать это в обращениях, которые фильтруются из ваших представлений (профилей). Если обращение будет отфильтровано, то вместе с ним будут отфильтрованы и все значения специального показателя. Подробнее...

Установка значений при автоматическом отслеживании экранов.

  • Чтобы применить значение специального показателя к просмотру экрана, который отслеживается автоматически, задайте это значение в методе контроллера представления viewDidAppear:. К примеру, ваш файл контроллера представления .m может выглядеть так:
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

Не отправляйте в значениях идентификационные данные

  • Передавать на серверы Google Analytics информацию, позволяющую идентифицировать личность пользователя, запрещено Условиями использования сервиса. Ознакомиться с ними можно здесь.