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

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

Обзор

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

  1. Настройте специальный параметр или показатель с помощью веб-интерфейса Google Analytics. Узнайте, как настроить специальный параметр или показатель (Справочный центр) .
  2. Устанавливайте и отправляйте значения специальных параметров и показателей из приложения.

Специальные параметры и показатели состоят из двух полей:

  • NSNumber Index – индекс специального параметра или метрики. Этот индекс основан на 1.
  • NSString Value — значение специального параметра или метрики. В этом случае метрика будет анализироваться как целое число или десятичное значение с фиксированной запятой, если метрика настроена для типа валюты.

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

Чтобы установить и отправить значение специального параметра:

// 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.

Не отправляйте личную информацию (PII) в качестве значений.