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

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

Обзор

Вам доступны следующие возможности:

  • В веб-интерфейсе Google Analytics можно настроить специальные параметры и показатели. Подробнее…
  • Задайте и отправьте значения специального параметра или показателя из приложения.

Специальные параметры и показатели включают два поля:

Название поля Тип Описание
Index Integer Индекс специального параметра (с шагом в единицу).
Value 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() значение неизвестно, экраны рекомендуется отслеживать вручную.

Не отправляйте в значениях идентификационные данные