В этом руководстве для разработчиков описывается, как реализовать специальные параметры и показатели с помощью Google Analytics SDK для iOS версии 3.
Обзор
Специальные параметры позволяют связать метаданные с обращениями, пользователями и сеансами в Google Analytics, а специальные показатели позволяют создавать и увеличивать собственные показатели в Google Analytics.
- Настройте специальный параметр или показатель с помощью веб-интерфейса Google Analytics. Узнайте, как настроить специальный параметр или показатель (Справочный центр) .
- Устанавливайте и отправляйте значения специальных параметров и показателей из приложения.
Специальные параметры и показатели состоят из двух полей:
-
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) в качестве значений.
- Условия использования Google Analytics запрещают отправку любой личной информации (PII) на серверы Google Analytics. Для получения дополнительной информации ознакомьтесь с Условиями обслуживания .