В 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. Как правило, вам необходимо использовать соответствующую встроенную переменную.
Константа
Используется значение указанной строки.
Настройки Google Аналитики
Переменная настроек используется в тегах Universal Analytics, которые входят в состав контейнеров для сайтов и мобильных приложений (Firebase). Она служит для настройки конфигураций Google Аналитики, общих для нескольких тегов. Когда вы создаете тег Google Аналитики с помощью Universal Analytics, Менеджер тегов предложит вам выбрать или создать переменную настроек Google Аналитики. Подробнее…
Таблица поиска
Значение задается в соответствии с инструкциями в таблице поиска. Она содержит два столбца (в этом примере таблица не заполнена):
| Когда значение [выбранной переменной] равно | Использовать для [этой переменной] значение |
|---|---|
Таблица поиска позволяет создавать переменные, значение которых меняется в соответствии со значением другой переменной. Это может быть полезно, если конфигурация приложения позволяет привязать определенное значение (например, идентификатор отслеживания конверсий) к URL или другому элементу этого приложения. В приведенном примере создается переменная Идентификатор конверсии. Для кода версии приложения 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. Используйте ее, чтобы задать значения конфигурации для своего приложения. Например, для гоночной игры можно определить следующую переменную "Коллекция значений":
{
"max-fuel": 200,
"starting-fuel": 100,
"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).