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

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

Обзор

Ты можешь:

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

Имя поля Тип Описание
Индекс 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) в качестве значений.