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

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

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

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

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

• Навігація
  • Напрямок переходу HTTP
  • URL-адреса
• Змінні сторінки
  • Власний файл cookie
  • Спеціальний скрипт JavaScript
  • Рівень даних
• Елементи сторінки
  • Змінна автоматичної події
  • Елемент DOM
  • Видимість елемента
• Утиліти
  • Константа
  • Спеціальна подія
  • Назва середовища
  • Налаштування Google Analytics
  • Налаштування конфігурації тегу Google
  • Налаштування події тегу Google
  • Таблиця пошуку
  • Випадкове число
  • Таблиця RegEx
• Дані, надані користувачами
• Дані контейнера
  • Ідентифікатор контейнера
  • Номер версії контейнера
  • Режим налагодження

Навігація

Напрямок переходу HTTP

Використовується значення напрямку переходу HTTP, тобто URL-адреси попередньої сторінки, яку відвідав користувач. Наприклад, якщо він переходить із головної сторінки на сторінку продукту, то напрямком переходу буде головна сторінка. Менеджер тегів автоматично створює екземпляр цього типу змінної, проте ви можете створити додаткові екземпляри, якщо потрібно відобразити різні частини URL-адреси напрямку переходу.

URL-адреса

Цей тип змінної дає змогу аналізувати й показувати компоненти URL-адреси. Можна створити додаткові екземпляри, щоб відобразити різні частини URL-адреси. Для вибору доступні такі компоненти URL-адреси: повна URL-адреса, протокол, ім’я хосту, порт, шлях, розширення назви файлу, запит і фрагмент. Для вхідного значення змінних цього типу використовується URL-адреса поточної сторінки, на якій перебуває користувач (отримана через document.location). Змініть джерело URL-адреси, якщо потрібно, щоб Менеджер тегів використовував іншу змінну як джерело значення URL-адреси.

Змінні сторінки

Власний файл cookie

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

Спеціальний скрипт JavaScript

Використовується значення результату функції JavaScript. Функція JavaScript має бути анонімною функцією, що повертає значення. Наприклад, за допомогою спеціальної змінної JavaScript можна змінити регістр усіх стандартних змінних {{url}} на нижній:

function () {
  return {{url}}.toLowerCase();
}

Рівень даних

Значення призначається, коли дані надсилаються на відповідний рівень за допомогою виклику dataLayer.push():
dataLayer.push({"Data Layer Name": "value"}).

У Менеджері тегів можна вказати, як слід тлумачити крапки (".") у назві ключа.

• Варіант 1: дозволити використовувати крапки в назвах ключів. Наприклад, для dataLayer.push("a.b.c": "value") назва ключа тлумачитиметься як a.b.c (тобто {"a.b.c": "value"}).
• Варіант 2: тлумачити крапки як вкладені значення. Наприклад, dataLayer.push({"abc": "value"}) тлумачитиметься як три вкладені рівні: {a: {b: {c: "value"}}}.

Змінна JavaScript

Використовується значення глобальної змінної JavaScript, указаної користувачем. Якщо потрібне значення недоступне на рівні даних (перегляньте змінну рівня даних) і в моделі DOM (перегляньте також змінну елемента DOM), імовірно, його можна отримати зі змінної JavaScript. Використовуйте цей тип змінної, якщо потрібне значення міститься у вихідному коді сторінки у вигляді глобальної змінної JavaScript.

Елементи сторінки

Змінна автоматичної події

Ця змінна реєструє інформацію про елемент, який ініціював подію (наприклад, кліки, надсилання форми, видимість елемента тощо).

• Елемент: повертає об’єкт елемента. Можна використовувати як об’єкт для спеціального скрипта JavaScript, як-от {{Element}}.title, або в селекторах CSS, наприклад {{Element}} відповідає селектору CSS div.foo.
• Тип елемента: повертає значення element.tagName, наприклад A, BUTTON, IMG.
• Атрибут елемента: якщо вказати назву атрибута, цей параметр повертатиме значення відповідного атрибута.
• Клас елемента: повертає список класів, виявлених в атрибуті class елемента.
• Ідентифікатор елемента: повертає значення атрибута id.
• Ціль елемента: повертає значення атрибута target, наприклад _blank.
• Текст елемента: повертає значення текстового вмісту елемента.
• URL-адреса елемента: повертає URL-адресу елемента, зібрану за допомогою атрибута href або action.
• Новий фрагмент URL-адреси історії: повертає новий фрагмент URL-адреси з історії веб-переглядача, наприклад #summary".
• Старий фрагмент URL-адреси історії: повертає старий фрагмент URL-адреси з історії веб-переглядача, наприклад #intro.
• Новий стан історії: новий об’єкт стану історії, що контролюється викликами pushState із сайту.
• Старий стан історії: старий об’єкт стану історії, що контролюється викликами pushState із сайту.
• Джерело змінення історії: повертає подію, яка спричинила зміну історії, наприклад pushState, replaceState тощо.

Елемент DOM

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

Якщо вказано додаткову назву атрибута, значення змінної поверне значення, указане в атрибуті (наприклад, data-food="cupcake"). Інакше значенням буде текст у межах елемента DOM.

Видимість елемента

Значення встановлюється на основі видимого статусу вказаного елемента DOM. На відміну від активатора видимості елемента, одна змінна видимості елемента може реєструвати видимість лише одного елемента. Виберіть, як потрібно вибирати елемент: на основі ідентифікатора або засобу вибору CSS. Якщо вказаний засіб вибору CSS виявляє збіги кількох елементів, буде використано перший збіг.

Для цієї змінної можна вибрати тип вихідних даних.

• Правда/неправда: логічне значення, що позначає видимість вибраного елемента під час звернення до змінної.
• Відсоток: відсоткове значення (0–100), що вказує, яка частина вибраного елемента видима на екрані під час звернення до змінної.

Якщо вибрати Правда/неправда як тип вихідних даних, можна також визначити мінімальний відсоток видимості, щоб указати частину вибраного елемента, яка має бути видимою на екрані, щоб змінна повертала значення "true".

Утиліти

Константа

Значенням є вказаний вами сегмент. Постійні змінні сегмента використовуються за умовчанням, коли в кількох тегах застосовується той самий номер облікового запису. Додаткову інформацію наведено в розділі налаштувань Google Analytics.

Спеціальна подія

Значенням є назва спеціальної події, яку передано на рівень даних.

Назва середовища

Повертає назву середовища в режимі попереднього перегляду.

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

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

Налаштування конфігурації тегу Google

Ця змінна дає змогу встановлювати параметри рівня конфігурації під час завантаження тегу Google.

Наприклад, ваш веб-сайт має версії кількома мовами, і ви хочете сегментувати аудиторію за мовами, які вибирають ваші користувачі. Ви можете створити змінну конфігурації з параметром language і використовувати її для всіх тегів Google, щоб не оновлювати кожен тег вручну.

Дізнайтесь, як повторно використовувати налаштування конфігурації.

Налаштування події тегу Google

Ця змінна дає змогу встановлювати параметри на рівні події і надсилати додаткові дані з подією GA4.

Уявімо, що ви власник онлайн-магазину, який проводить розпродаж і хоче відстежувати, скільки користувачів застосовують наданий вами код знижки. Щоб не додавати параметр discount у кожен тег вручну, ви можете скористатися змінною Налаштування події тегу Google.

Дізнайтесь, як повторно використовувати налаштування конфігурації.

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

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

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

Таблиця пошуку дає змогу створити змінну, значення якої залежить від значення іншої змінної. Це може стати в пригоді, якщо ваш веб-сайт налаштований так, що потрібне значення (наприклад, ідентифікатор конверсії) можна зіставити з URL-адресою, елементом DOM або іншою частиною сторінки. У цьому прикладі створюється змінна з назвою Ідентифікатор конверсії. Для URL-адреси, що містить /thanks/buy1.html, встановлюється значення 12345, а для URL-адреси з компонентом thanks/buy2.html – 34567.

Коли {{url}} містить	Установити для параметра {{Conversion ID}} значення
/dyakuyu/pokupka1.html	12345
/dyakuyu/pokupka2.html	34567
/dyakuyu/pokupka3.html	56789

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

Як значення встановлюється випадкове число від 0 до 2147483647.

Таблиця RegEx

Змінна таблиці RegEx працює подібно до змінної таблиці пошуку, але додатково може виконувати шаблони регулярних виразів для елементів, з якими потрібно знайти збіг.

Приклад конфігурації таблиці RegEx:

Шаблон	Вихідні дані
.*/page[1-3]\.html.*	foo
.*/page[4-6]\.html.*	bar
.*/page[7-9]\.html.*	baz

Вихідне значення змінної для цієї конфігурації матиме такий вигляд:

Відповідний результат	Ціна
http://example.com/page1.html	foo
http://www.example.com/page1.html	foo
http://example.com/page2.html#detail	foo
http://example.com/page5.html	bar
http://example.com/page5.html?status=new	bar
http://example.com/page6.html	bar
https://example.com/page9.html	baz

Таблиця RegEx виконує пошук, починаючи згори списку. Якщо збіг знайдено, повертається відповідне вихідне значення.

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

За умовчанням шаблони мають відповідати цілому вхідному рядку (без урахування регістра). Таку поведінку можна відкоригувати в розділі Додаткові налаштування.

• Ігнорувати регістр клавіатури: під час пошуку збігів регістр не враховується, тому немає потреби спеціально зазначати це в регулярному виразі.

• Лише повні збіги: якщо ввімкнути це налаштування, шаблони матимуть збігатися з цілим вхідним рядком. Це наче вставити прив’язки початку (^) і завершення ($) навколо шаблона. Якщо вимкнути налаштування, шаблони відповідатимуть збігам у будь-якій частині рядка.

• Групи вибірки та функція заміни: якщо ввімкнути це налаштування, можна використовувати знак долара як елемент синтаксису заміни, щоб включити частини вхідного рядка (зокрема, з груп вибірки у відповідному шаблоні) у вихідне значення. Наприклад, якщо відповідний регулярний вираз має текст (news)/page(2)\.html, можна використати $1 для посилання на першу групу вибірки (news), а $2 – на другу (2).

Якщо ви використовуєте налаштування "Групи вибірки й функція заміни" та вимкнули параметр "Лише повні збіги", то можете отримати несподівані результати (наприклад, повернення цілого вхідного значення із заміною частини, яка збігається).

Дані, надані користувачами

Щоб збирати дані з форм для зворотного зв’язку (наприклад, електронні адреси, номери телефонів, імена й адреси), укажіть інформацію, яку потрібно реєструвати в одному з наведених нижче режимів.

• Автоматична конфігурація автоматично визначає форми на веб-сайті й реєструє заповнення цих форм.
• Налаштування вручну дає змогу зіставляти наявні змінні Менеджера тегів із відповідними полями даних, наданих користувачами, як-от електронною адресою, номером телефону, іменем і адресою.
• Код дає змогу вказати змінну рівня даних або користувацьку змінну JavaScript, яка повертатиме структурований об’єкт даних, наданих користувачем.

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

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

Повертає ідентифікатор контейнера Менеджера тегів, наприклад GTM-101010.

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

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

Режим налагодження

Якщо контейнер перебуває в режимі попереднього перегляду та налагодження, встановлюється значення true, а якщо ні – false.