Из этого руководства вы узнаете об использовании специальных параметров и показателей в SDK Google Analytics для iOS версии 3.
Обзор
Специальные параметры позволяют связывать метаданные с обращениями, пользователями и сеансами Google Аналитики, а специальные показатели – создавать собственные определения для измерения данных.
- Настройте специальный параметр или показатель в веб-интерфейсе Google Аналитики. Подробнее…
- Задайте и отправьте значения специального параметра или показателя из приложения.
Специальные параметры и показатели включают два поля:
-
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 Аналитику с обращениями любого типа, включая просмотры экрана, события, транзакции электронной торговли, пользовательское время и социальные взаимодействия. Область действия специального параметра определяет, какие обращения будут связываться с его значением.
Вот как задать и отправить значение специального показателя:
// 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 Аналитики. Таким образом, чтобы увеличить итог на единицу, необходимо задать для специального показателя значение
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 Аналитики информацию, позволяющую идентифицировать личность пользователя, запрещено Условиями использования сервиса. Ознакомьтесь с ними.