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