Специальные параметры и показатели – Android SDK версии 2 (устаревшая версия)

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

Обзор

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

Чтобы реализовать специальный параметр или показатель, необходимо выполнить два основных шага:

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

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

Пользовательские размеры

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

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

Эти поля необходимы для установки значения специального параметра:

  • Integer индекс – индекс определения специального измерения. Этот индекс основан на 1.
  • String значение – значение специального параметра.

Установка значения специального параметра

Чтобы установить значение специального измерения, вызовите setCustomDimension перед вызовом отправки, с которым вы хотите связать это значение:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

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

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

Области уровня пользователя и сеанса являются жадными

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

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

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

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

При фильтрации по значению специального параметра обращения фильтруются в соответствии с областью действия этого значения специального параметра.

Узнайте больше о том, как фильтры и значения специальных параметров взаимодействуют при обработке ваших данных.

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

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

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

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

Условия использования Google Analytics запрещают отправку любой личной информации (PII) на серверы Google Analytics. Для получения дополнительной информации ознакомьтесь с Условиями обслуживания .

Пользовательские метрики

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

Эти поля необходимы для установки значения специального показателя:

  • Integer индекс – индекс определения пользовательской метрики.
  • Integer значение – значение пользовательской метрики. Значения могут быть отрицательными.

Установка значения специального показателя

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

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Или чтобы установить специальную метрику валюты:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

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

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

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

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

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

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