Пользовательские переменные
В Яндекс Тег Менеджере можно создать пользовательские переменные. Они нужны в случаях, когда встроенных переменных недостаточно.
Пользовательские переменные получают данные из разных источников: dataLayer, cookie, JavaScript и т. д.
Создать пользовательскую переменную
Чтобы создать пользовательскую переменную:
-
Перейдите в раздел Переменные.
-
Справа нажмите Добавить переменную → Создать.
-
В окне Настройка переменной заполните информацию:
- Название — описывает назначение переменной.
- Шаблон переменной — тип переменной.
- Параметры(если требуются).
-
Нажмите кнопку Сохранить.
Типы пользовательских переменных
Константа
Константа — это особый вид пользовательской переменной с заданным текстовым значением. Часто используется для ID аккаунтов, значений по умолчанию и т. д.
Переменная уровня данных
Переменная уровня данных получает значение по ключу из dataLayer, которое было отправлены на страницу вручную или автоматически. Это основной способ передавать динамические значения — такие как ID товара, сумма заказа, email пользователя и других.
Используется как в тегах, так и в условиях активации триггеров с типом Специальное событие. Подробнее см. Специальное событие.
Как работает
Когда на странице вызывается:
dataLayer.push({
event: 'form_submit',
form_id: '12345',
form_name: 'подписка'
});
Вы можете создать переменную уровня данных с именем form_id
или form_name
, и она будет возвращать соответствующее значение при каждом push
.
Как настроить
-
Выберите шаблон Переменная уровня данных.
-
В поле Имя переменной уровня данных укажите ключ (например,
form_id
). -
Назовите переменную так, чтобы было понятно, что она возвращает (
DL - form id
). -
Нажмите Сохранить.
Далее вы можете использовать эту переменную в условиях срабатывания триггера или в шаблоне тега.
Собственный файл cookie
Позволяет получить значение из любого cookie, установленного на сайте.
Эта переменная полезна, если вы сохраняете идентификаторы, параметры кампаний или пользовательские данные в cookie (например, user_id
, utm_source
и т. д.).
Как настроить
-
Выберите шаблон Собственный файл cookie.
-
В поле Название переменной укажите удобное имя, под которым переменная будет использоваться в YTM.
-
В поле Название cookie укажите имя cookie, значение которого нужно получить, например,
utm_campaign
. -
Выберите опцию URI-декодирование, если нужно, чтобы значения автоматически декодировались (по умолчанию включено). Например,
%20
станет пробелом. -
Нажмите Сохранить.
Пример
Название переменной |
Название cookie |
URI-декодирование |
utm_source |
utm_source |
Включено |
Примечание
Cookie должен быть доступен на момент срабатывания тега. Если cookie нет — переменная вернет пустое значение или значение по умолчанию, если оно задано.
Переменная JavaScript
Позволяет получить значение из глобального объекта JavaScript, например window
, document
, location
.
Используется, если нужные данные уже доступны на странице через глобальные переменные.
Как настроить
Чтобы настроить переменную JavaScript, укажите путь к переменной. Путь указывается без window
, например: user.id
, document.title
, location.href
.
Пример
Путь к переменной |
Что возвращает |
|
Значение id из объекта user |
|
Заголовок текущей страницы |
|
Полный URL текущей страницы |
Важно
-
Переменная должна быть уже определена в момент срабатывания тега.
-
Поддерживается только чтение значений — вызов функций и выражения не работают.
Случайное число
Генерирует случайное число от 0 до 2147483647. Полезно для уникальных ID и кеш-байпасов.