Встроенные переменные
Встроенные переменные — это готовые переменные, которые нельзя изменить. Набор таких переменных автоматически добавляется в каждый новый контейнер.
Клики
При срабатывании триггера Клик Яндекс Тег Менеджер автоматически сохраняет встроенные переменные:
|
Переменная в YTM |
Описание |
Тип данных |
|
Click Element |
DOM-элемент, по которому был выполнен клик |
DOM-элемент |
|
Click Classes |
Массив классов элемента, например для элемента |
Массив строк |
|
Click ID |
Значение атрибута id |
Строка |
|
Click Target |
Значение атрибута target |
Строка |
|
Click URL |
Значение href, если элемент — ссылка |
Строка |
|
Click Text |
Видимый текст внутри элемента |
Строка |
Переменные можно использовать:
-
В условиях активации триггеров (например, Click Text содержит "Купить").
-
В пользовательских шаблонах тегов.
Формы
При срабатывании триггера Отправка формы Яндекс Тег Менеджер автоматически сохраняет встроенные переменные:
|
Переменная в YTM |
Описание |
Тип данных |
|
Form Element |
DOM-элемент отправленной формы |
DOM-элемент |
|
Form Classes |
Массив классов элемента, например для элемента |
Массив строк |
|
Form ID |
Значение атрибута id формы |
Строка |
|
Form Target |
Значение атрибута |
Строка |
|
Form URL |
Значение атрибута action — адрес, на который отправляется форма |
Строка |
Эти переменные можно использовать:
- В условиях активации триггеров (например, Form ID равно
subscribe-form). - В пользовательских шаблонах тегов.
Страницы
При срабатывании любого из триггеров в Яндекс Тег Менеджер автоматически вычисляется информация об адресе текущей страницы и источнике перехода. Эти данные становятся доступны через следующие встроенные переменные:
|
Переменная в YTM |
Описание |
Пример |
|
Page Hostname |
Домен сайта, без протокола и пути, например, |
|
|
Page Path |
Путь URL — все, что после домена. |
|
|
Page URL |
Полный URL страницы текущей страницы. |
|
|
Referrer |
Адрес страницы, с которой пришел пользователь на текущую страницу. |
|
Эти переменные можно использовать:
-
В условиях активации триггеров. Например: «Просмотр страницы сработает, только если Page Path содержит
/checkout». -
В пользовательских шаблонах для динамической подстановки URL, домена и т. д.
Элемент DOM
Элемент DOM позволяет получить значение прямо из структуры страницы — из HTML-элемента, который пользователь видит на сайте. Этот метод используют, когда нужное значение не передают через dataLayer, но оно отображается в коде страницы. Например, цена, название товара или категория.
Можно указать название атрибута (необязательно). Если атрибут задан, переменная возьмет значение из этого атрибута.
Пример
data-food="cupcake"
В переменной будет значение cupcake.
Если атрибут не указан, переменная автоматически подставит текст, который содержится внутри элемента. Например, цену или заголовок.
Прокрутка
При срабатывании триггера Глубина прокрутки Яндекс Тег Менеджер автоматически сохраняет встроенную переменную:
|
Переменная в YTM |
Описание |
Пример |
|
Scroll Depth Threshold |
Фиксирует глубину прокрутки, которая активировала триггер. |
|
Видимость
При срабатывании триггера Видимость элемента Яндекс Тег Менеджер автоматически сохраняет встроенные переменные:
|
Переменная в YTM |
Описание |
Пример |
|
Visible Ratio Percent |
Определяет процент видимой области элемента на экране. |
|
|
Visible Duration |
Фиксирует, сколько времени элемент был видимым. |
|
Утилиты
Встроенные переменные, которые помогают обрабатывать служебные данные, идентификаторы и события:
|
Переменная в YTM |
Описание |
|
Container Version |
Текущая версия контейнера (номер сборки). |
|
Event |
Название события, переданного в dataLayer (например, |
|
Random Number |
Случайное число (полезно для кэш-байпасов и уникальности событий). |
Примеры использования:
-
Event можно использовать в триггере Специальное событие, чтобы задать условие Event равно
form-submit. -
Random Number — для передачи уникального ID в тег или в запрос, чтобы исключить кеширование.