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

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

Обзор

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

Чтобы реализовать специальный параметр или показатель, необходимо выполнить два основных шага:

  1. Определите специальный параметр или показатель с помощью веб-интерфейса Google Analytics.
    Задайте индекс, имя и область действия специального параметра или показателя в разделе настроек свойств веб-интерфейса.
    Узнайте, как определить специальный параметр или показатель .
  2. Внедрите код для установки и сбора значений специальных параметров и показателей.
    Добавьте в свое приложение код, чтобы установить значения специального параметра или показателя для обращений Google Analytics по индексам, которые вы определили на предыдущем шаге.

В оставшейся части этой статьи будет описано, как реализовать код для установки и отправки значений специальных параметров или показателей в Google Analytics.

Пользовательские размеры

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

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

Эти поля необходимы для установки значения специального параметра:

  • NSNumber Index – индекс определения специального измерения. Этот индекс основан на 1.
  • NSString Value – значение специального измерения.

Установка значения специального параметра

Чтобы установить значение специального измерения, вызовите setCustom:dimension: перед вызовом отправки, с которым вы хотите связать значение:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

Рекомендации по реализации

В этом разделе приводятся дополнительные соображения, которые следует учитывать при реализации специального параметра.

Области уровня пользователя и сеанса являются жадными

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

Например, если вы используете тип членства в качестве специального измерения на уровне пользователя, а пользователь обновляет свое членство в середине сеанса, вы можете начать новый сеанс, прежде чем устанавливать новое значение специального измерения. Это гарантирует, что обращения до обновления будут связаны со старым значением членства, а новые обращения будут связаны с новым значением.

Пользовательские размеры и фильтры просмотра (профиля)

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

При фильтрации по значению специального параметра обращения фильтруются в соответствии с областью действия этого значения специального параметра.

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

Настройка значений с помощью автоматического измерения экрана

Чтобы применить значение специального размера к виду экрана, отправленному посредством автоматического измерения экрана, установите значение во время метода viewDidAppear: контроллера представления. Например, файл .m вашего контроллера представления может выглядеть так:

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [super viewDidAppear:animated]   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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

Условия использования Google Analytics запрещают отправку любой личной информации (PII) на серверы Google Analytics. Для получения дополнительной информации ознакомьтесь с Условиями обслуживания .

Пользовательские метрики

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

Эти поля необходимы для установки значения специального показателя:

  • NSInteger Index — индекс определения пользовательской метрики.
  • NSNumber Value – значение пользовательской метрики. Значения могут быть отрицательными.

Установка значения специального показателя

Чтобы установить значение пользовательской метрики, вызовите setCustom:metric: перед следующим вызовом отправки:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

Или чтобы установить специальную метрику валюты:

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params:params];

Рекомендации по реализации

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

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

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

Пользовательские метрики и фильтры представления (профиля)

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