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

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

Обзор

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

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

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

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

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

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

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();

// 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.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .set(Fields.customDimension(1), "premiumUser");
    .build()
);

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

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

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();


// Set the custom metric to be incremented by 5 using its index.
easyTracker.set(Fields.customMetric(1), 5);


// Custom metric value sent is with this screen view.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .build()
);

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

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

Рекомендации по использованию специальных размеров

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

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

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

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

Рекомендации по использованию специальных показателей

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

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

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

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

  • Чтобы применить значение специального размера к виду экрана, отправленному через автоматическое измерение экрана EasyTracker, установите значение до вызова activityStart() во время onStart() . Обратите внимание, что в случаях, когда значение неизвестно во время выполнения onStart() , вместо этого рекомендуется измерить экран вручную.

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