Типи користувацьких змінних для мобільних додатків

Створіть користувацькі змінні для мобільних додатків у Менеджері тегів Google відповідно до особливих вимог, які не задовольняють вбудовані змінні.

Щоб створити нову користувацьку змінну:

1. На навігаційній панелі ліворуч натисніть Змінні.
2. У розділі "Користувацькі змінні" виберіть Створити.
3. Натисніть Конфігурація змінної та виберіть потрібний тип змінної.
4. Укажіть параметри вибраного типу змінної.
5. Укажіть назву змінної. Використовуйте описові назви, які вказують на функції змінної, як-от "Змінна рівня даних – назва продукту".
6. Натисніть Зберегти.

Менеджер тегів підтримує такі типи визначених користувачем змінних для мобільних пристроїв:

• Firebase
  • Назва події
  • Параметр події
  • Ресурс користувача Firebase
• Службові програми
  • Відстеження реклами ввімкнено
  • Константа
  • Налаштування Google Analytics
  • Таблиця пошуку
  • Випадкове число
• Дані контейнера
  • Ідентифікатор контейнера
  • Номер версії контейнера
• Додаток
  • Ідентифікатор додатка
  • Назва додатка
  • Код версії додатка
  • Ідентифікатор для рекламування
  • Версія пакета SDK
• Пристрій
  • Назва пристрою
  • Мова
  • Версія операційної системи
  • Платформа
  • Роздільна здатність екрана
• Інше
  • Виклик функції
  • Колекція значень (застарілий)

Firebase

Назва події

Значення eventNameXYZ встановлюється, коли у вашому додатку виконується такий код:

Для Android
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);

Для iOS
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];

У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Параметр події

Використовується значення параметра події Firebase Google Analytics для вказаного ключа.

Ресурс користувача Firebase

Використовується значення ресурсу користувача Firebase Google Analytics для вказаного ключа.

Службові програми

Відстеження реклами ввімкнено

Для додатків Android змінна повертає значення "true", якщо ввімкнено відстеження оголошень, або "false", якщо користувач вимкнув оголошення на основі інтересів. Докладніше про це в Центрі розробників для Android. Версії SDK, старіші за 4, завжди повертатимуть значення "false". Для iOS 6 і новіших версій значенням є ресурс advertisingTrackingEnabled. В інших випадках установлюється значення "true". У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Константа

Як значення використовується вказаний рядок.

Налаштування Google Analytics

Змінні налаштувань Google Analytics застосовують у тегах Universal Analytics у контейнерах веб-сайтів і мобільних додатків (Firebase), щоб централізовано змінювати й надсилати налаштування Google Analytics, які використовуються в кількох тегах. Коли ви створюєте тег Google Analytics за допомогою Universal Analytics, Менеджер тегів пропонує вам вибрати або створити змінну налаштувань Google Analytics. Докладніше

Таблиця пошуку

Значення встановлюється відповідно до інструкцій у таблиці пошуку. Таблиця пошуку містить два стовпці (таблиця пуста, щоб показати, як дані використовуються потім):

Якщо [вибрана змінна] дорівнює	Установити для [цієї змінної] значення

Таблиця пошуку дає змогу створити змінну, значення якої залежить від значення іншої змінної. Її доцільно використовувати, якщо ваш додаток налаштовано так, що потрібне значення (наприклад, ідентифікатор відстеження конверсій) може зіставлятися з кодом версії додатка чи іншим компонентом додатка. У цьому прикладі створюється змінна з назвою Ідентифікатор конверсії. Якщо код версії додатка – 1.0, установлюється значення "12345"; якщо код версії додатка – 1.1, тоді встановлюється значення "34567". Кількість рядків у таблиці пошуку необмежена. Значення в полях чутливі до регістру.

Якщо умова {{App Version Code}} дорівнює	Установити для параметра {{Conversion ID}} значення
1.0	12345
1.1	34567
1.2	56789

Випадкове число

Як значення встановлюється випадкове число від 0 до 2147483647. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Дані контейнера

Ідентифікатор контейнера

Значення – загальнодоступний ідентифікатор контейнера (наприклад, GTM-ABC42). У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Номер версії контейнера

Коли контейнер відкрито в режимі попереднього перегляду, це значення змінної є номером версії контейнера для попереднього перегляду. В інших випадках ця змінна буде номером опублікованої версії контейнера. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Додаток

Ідентифікатор додатка

Значенням є назва пакета (для Android) або ідентифікатор додатка (для iOS). У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Назва додатка

Значенням є назва додатка. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Код версії додатка

Значенням є версія поточного запущеного додатка. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Ідентифікатор для рекламування

Для ОС Android значенням є рекламний ідентифікатор. Версії SDK, старіші за 4, завжди повертатимуть порожній рядок. Для iOS 6 і новіших версій значенням є ідентифікатор для рекламування (IDFA). Інакше як значення встановлюється порожній рядок.

Версія пакета SDK

Як значення використовується версія пакета SDK операційної системи, у якій установлено додаток. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Пристрій

Назва пристрою

Значенням є назва пристрою, на якому запущено додаток (наприклад, Samsung Android, Pixel 2). У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Мова

Використовується двобуквений код мови, що відповідає вибраній користувачем мові пристрою. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Версія операційної системи

Як значення використовується версія операційної системи, у якій установлено додаток. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Платформа

Значенням є платформа, на якій запущено додаток (наприклад, Android або iOS). У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Роздільна здатність екрана

Значенням є роздільна здатність екрана пристрою, на якому запущено додаток, у форматі "ширина x висота", наприклад 1920x1080. У більшості випадків слід використовувати еквівалентну вбудовану змінну.

Інше

Виклик функції

Використовується значення, отримане у відповідь на виклик попередньо зареєстрованої функції. Докладніші відомості наведено в документації 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).