В Google Менеджере тегов можно создавать пользовательские переменные для мобильных устройств. Они нужны в тех случаях, когда встроенных переменных недостаточно.
Чтобы создать пользовательскую переменную, выполните следующие действия:
- Откройте нужный контейнер Менеджера тегов.
- На вкладке "Рабочая область" на панели навигации слева нажмите Переменные.
- В разделе "Пользовательские переменные" нажмите кнопку Создать.
- Нажмите Конфигурация переменной и выберите нужный тип.
- Укажите параметры для переменной.
- Укажите имя переменной. Рекомендуем задавать переменным названия, описывающие их предназначение, например Уровень данных – Название продукта.
- Нажмите Сохранить.
В Менеджере тегов поддерживаются следующие типы пользовательских переменных для мобильных устройств:
Firebase
Название события
Используется значение eventNameXYZ при выполнении в приложении следующего кода:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
Как правило, вам необходимо использовать соответствующую встроенную переменную.
Параметр события
В качестве значения указывается параметр события Google Аналитики (Firebase) для указанного ключа.
Ресурс пользователя Firebase
В качестве значения указывается ресурс пользователя Google Аналитики (Firebase) для указанного ключа.
Утилиты
Отслеживание рекламодателей включено
Для Android возвращает значение true, если включено отслеживание рекламы, и значение false, если пользователь отключил объявления на основе интересов. Подробнее об этом рассказано в документации для разработчиков Android. SDK более ранней версии, чем версия 4, всегда возвращает false. Для iOS версии 6 и выше используется значение свойства advertisingTrackingEnabled, В остальных случаях используется значение true. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Константа
Используется значение указанной строки.
Таблица поиска
Значение задается в соответствии с инструкциями в таблице поиска. Она содержит два столбца (в этом примере таблица не заполнена):
| Когда значение [выбранной переменной] равно | Какое значение присвоить [этой переменной] |
|---|
Таблица поиска позволяет создавать переменные, значения которых будут меняться вслед за значением другой переменной. Это может быть полезно, если конфигурация сайта позволяет привязать определенное значение (например, идентификатор отслеживания конверсий) к коду версии или другому аспекту приложения. В нашем примере создается переменная с названием Идентификатор конверсии. Для кода версии приложения 1.0, используется значение 12345, а для кода 1.1 – значение 34567. Таблица поиска может содержать неограниченное число строк. Данные в полях вводятся с учетом регистра.
| Если {{Код версии приложения}} равен | Использовать для {{Идентификатор конверсии}} значение |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Случайное значение
Случайное число в диапазоне от 0 до 2 147 483 647. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Данные контейнера
Идентификатор контейнера
Общедоступный идентификатор контейнера (например, GTM-ABC42). Как правило, вам необходимо использовать соответствующую встроенную переменную.
Номер версии контейнера
Номер предварительной версии, если контейнер находится в режиме предварительного просмотра. В противном случае – номер опубликованной версии. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Приложение
Идентификатор приложения
Название пакета (Android) или идентификатор пакета (iOS). Как правило, вам необходимо использовать соответствующую встроенную переменную.
Название приложения
В качестве значения используется название приложения. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Код версии приложения
Версия текущего приложения. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Рекламный идентификатор
Для Android используется значение рекламного идентификатора. SDK более ранней версии, чем версия 4, всегда возвращает пустую строку. Для iOS версии 6 и выше используется значение рекламного идентификатора (IDFA), в остальных случаях – пустая строка.
Версия SDK
Версия SDK операционной системы, в которой установлено приложение. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Устройство
Название устройства
Значением является название устройства, на котором запущено текущее приложение (например, Samsung Android, Pixel 2). Как правило, вам необходимо использовать соответствующую встроенную переменную.
Язык
Двухбуквенный код языка, соответствующий заданному пользователем языку устройства. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Версия операционной системы
Версия операционной системы, в которой установлено приложение. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Платформа
Значением является название платформы текущего приложения (например, Android, iOS). Как правило, вам необходимо использовать соответствующую встроенную переменную.
Разрешение экрана
В качестве значения используется разрешение экрана устройства, на котором выполняется приложение, Формат: "ширина x высота", например: "1920 x 1080". Как правило, вам необходимо использовать соответствующую встроенную переменную.
Другое
Вызов функции
Используется возвращаемое значение предварительно заданной функции. Подробнее об этом рассказано в документации к SDK для Android или iOS.
Коллекция значений (только для устаревших контейнеров)
Переменная этого типа содержит набор пар "ключ-значение" в формате JSON. Используйте ее, чтобы задать значения конфигурации для своего приложения. Например, для гоночной игры можно определить следующую переменную "Коллекция значений":
{
"fuel-burn-rate": 20
}
Мобильное приложение может извлечь значение из переменной, предоставив ключ. Например:
public class MainActivity {
// Добавьте идентификатор контейнера.
private static final String CONTAINER_ID = "XXX-YYY";
// Ключи, которые будут использоваться
// для получения значений конфигурации контейнера.
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// Остальной код onCreate.
}
}
/*
* Метод, используемый для обновления значений конфигурации игры
* с помощью контейнера Google Менеджера тегов.
*/
public void updateConfigurationFromContainer(Container container) {
// Получение ссылки на контейнер.
Container container = mFutureContainer.get();
// Обновление настроек игры с помощью
// ключей к значениям конфигурации.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
С переменной "Коллекция значений" связаны триггеры. Для значений конфигурации, которые относятся ко всем версиям приложения, используйте вариант "Всегда" (условие по умолчанию). Подробнее об использовании переменной "Коллекция значений" читайте в документации для разработчиков (Android или iOS).