В этом руководстве разработчика описывается, как использовать Google Analytics SDK 4 для Android для реализации специальных параметров и показателей.
Обзор
Ты можешь:
- Используйте веб-интерфейс Google Analytics для настройки специального параметра или показателя. Узнайте, как настроить специальный параметр или показатель (Справочный центр) .
- Устанавливайте и отправляйте значения специальных параметров и показателей из приложения.
Специальные параметры и показатели состоят из двух полей:
Имя поля | Тип | Описание |
---|---|---|
Индекс | Integer | Индекс специального параметра или показателя. Этот индекс основан на 1. |
Ценить | String | Значение специального параметра или показателя. В этом случае метрика будет анализироваться как целое число или десятичное значение с фиксированной запятой, если метрика настроена для типа валюты. |
Установка и отправка значений
Чтобы установить и отправить значение специального параметра:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomDimension(1, "premiumUser") .build() );
Значения специальных параметров можно отправлять с любым типом обращения Google Analytics, включая просмотры экрана, события, транзакции электронной торговли, время пользователя и социальные взаимодействия. Определенная область специального измерения будет определять во время обработки, какие обращения связаны со значением измерения.
Чтобы установить и отправить значение пользовательской метрики:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomMetric(1, 5) .build() );
Подробную информацию о методе getTracker
см. в разделе «Расширенная настройка» .
Рекомендации по реализации
В этом разделе приводятся дополнительные рекомендации, которые следует учитывать при внедрении специальных параметров и показателей.
Рекомендации по использованию специальных размеров
Значения с областями действия на уровне пользователя и сеанса применяются к прошлым попаданиям
- Значения специальных параметров с областью действия на уровне пользователя или сеанса будут применяться ко всем обращениям в текущем сеансе, включая прошлые обращения. Если вы не хотите, чтобы значение специального измерения с областью действия на уровне сеанса или пользователя применялось к прошлым обращениям в текущем сеансе, начните новый сеанс, прежде чем применять значение к обращению.
- Например, если вы используете тип членства в качестве специального измерения на уровне пользователя, а пользователь обновляет свое членство в середине сеанса, вы можете начать новый сеанс, прежде чем устанавливать новое значение специального измерения. Это гарантирует, что обращения до обновления будут связаны со старым значением членства, а новые обращения будут связаны с новым значением.
Пользовательские размеры и фильтры просмотра (профиля)
- Значения специальных параметров на уровне пользователя или сеанса по-прежнему будут применяться ко всем обращениям в текущем и/или будущих сеансах, даже если обращение, с которым они отправляются, отфильтровано из представления (профиля) .
- При фильтрации по значению специального параметра обращения фильтруются в соответствии с областью действия этого значения специального параметра. Узнайте больше о том, как фильтры и значения специальных параметров взаимодействуют при обработке ваших данных.
Рекомендации по использованию специальных показателей
Значения специальных показателей агрегируются в отчетах
- Значения специальных показателей агрегируются в отчетах так же, как и другие предопределенные показатели в Google Analytics. В результате вы установите значение пользовательской метрики, равное
1
, чтобы увеличить совокупную сумму метрики в ваших отчетах.
Пользовательские метрики и фильтры представления (профиля)
- Хотя значения специальных показателей обычно можно устанавливать в любое удобное время, избегайте установки значений специальных показателей для обращений, которые могут быть отфильтрованы из ваших представлений (профилей). Если обращение фильтруется фильтром представления (профиля), все связанные значения специальных показателей также будут отфильтрованы. Узнайте больше о специальных параметрах и показателях, а также фильтрах представлений (профилей) .
Настройка значений с помощью автоматического измерения экрана
- Чтобы применить значение специального размера к виду экрана, отправленному посредством автоматического измерения экрана, установите значение до вызова
activityStart()
во времяonStart()
. Обратите внимание, что в случаях, когда значение неизвестно во время выполненияonStart()
, вместо этого рекомендуется измерить экран вручную.
Не отправляйте личную информацию (PII) в качестве значений.
- Условия использования Google Analytics запрещают отправку любой личной информации (PII) на серверы Google Analytics. Для получения дополнительной информации ознакомьтесь с Условиями обслуживания .