Переменная

Краткое содержание

Переменная — объект с постоянным именем и изменяющимся значением. Значение зависит от действий на сайте, например, сумма транзакции.

Переменные в триггерах
Используются для настройки фильтров, определяющих запуск тега. Пример: активация триггера Просмотр страницы, если переменная Page URL содержит mts.ru.

Переменные в тегах
Позволяют получать динамические значения, например, сбор данных о транзакциях через связанные теги.

Управление переменными

• Создать переменную:

  1. Перейти в контейнер, выбрать Переменные и нажать +.
  2. Настроить и сохранить переменную.
  3. Все переменные контейнера находятся в его карточке.

• Скопировать переменную:

  1. Кликнуть на переменную в рабочей области.
  2. Выбрать Другое — Копировать.

• Откатить изменения:

  1. Кликнуть на переменную, выбрать Другое — Откатить изменения.
  2. Переменная вернётся к состоянию на момент создания рабочей области.

Типы переменных

• Переменная автоматического события
  Возвращает значение, соответствующее типу и действию пользователя. Примеры: element, elementType, elementAttr, elementText и др.

• Константа
  Имеет фиксированное значение, заданное в поле Значение.

• Собственный файл cookie
  Извлекает значение cookie, указав его название.

• Переменная уровня данных
  Получает данные из dataLayer.push().

• Элемент DOM
  Возвращает текст или атрибуты элемента по CSS-селектору.

• Видимость элемента
  Определяет, был ли элемент виден на экране (возвращает True/False).

• Переменная JavaScript
  Возвращает значение глобальной переменной, заданной в коде страницы.

• Собственный код JavaScript
  Универсальная переменная для выполнения пользовательского кода.

• Номер опубликованной версии
  Хранит номер версии контейнера, используемый для тестирования.

Формат значений переменной

• Возможность изменения регистра символов.
• Преобразование null, undefined, true, false в другие значения.
• Экранирование символов для защиты от XSS-атак.

Переменная — объект, у которого есть постоянное имя и может меняться значение. Значение меняется в зависимости от действий на сайте. Например, в значении переменной может указываться сумма транзакции.

Заметка

Переменные в триггерах

Применяются для настройки фильтров, которые определяют, когда запускать тег. Например, активация триггера Просмотр страницы, когда переменная Page URL содержит адрес mts.ru.

Переменные в тегах

Используются для получения динамических значений. Например, собор данных о транзакциях, когда переменная связана с тегом отслеживания конверсий.

Управление переменными

Создать переменную

1. Перейдите в контейнер, наведите на Переменные и нажмите +

3. Настройте переменную и сохраните её.

4. Все переменные контейнера находятся в карточке контейнера. Далее их можно редактировать, публиковать и удалять.

5. Если контейнер установлен, при нажатии на Опубликовать данные о добавленной переменной будут внесены в код контейнера автоматически.

Скопировать переменную

Чтобы дублировать переменную:

1. В рабочей области кликните на переменную, откроется форма Редактирования.

2. Выберите Другое — Копировать

Копия переменной сразу появится в форме редактирования — её можно править, сохранять и публиковать.

Откатить изменения переменной

Внесённые изменения в переменную можно отменить. Тогда переменная откатится до состояния, в котором она была на момент создания рабочей области.

Как откатить переменную:

1. В рабочей области кликните на переменную. Откроется форма Редактирования.

2. Выберите Другое — Откатить изменения

Переменная мгновенно откатится до изначального состояния в версии.

Типы переменных

Переменная автоматического события

Переменная возвращает только значение, которое соответствует её типу и содержит информацию о действии пользователя, которое её вызвало

Тип переменной	Переменная возвращает
element	объект элемента. Его можно использовать как объект для собственного кода JavaScript, например {{Element}}.title
elementType	тип элемента (HTML-тег, например, a, Button, img)
elementAttr	значение атрибута. Для корректной работы переменной укажите название атрибута. Если вы используете эту переменную, заполните поле Атрибут. Атрибут уточняет поведение или свойства переменной.
elementClasses	значение атрибута class элемента
elementId	значение атрибута id
elementTarget	значение атрибута target (например, _blank)
elementText	значение текста элемента
elementUrl	URL элемента, полученный из атрибута href или action
oldHistoryState	старый объект состояния истории, управляемый вызовами pushState
newHistoryState	новый объект состояния истории, управляемый вызовами pushState
oldUrlFragment	фрагмент URL, который использовался ранее, из истории браузера (например, #intro)
newUrlFragment	новый фрагмент URL из истории браузера (например, #summary)
historyChangeSource	событие, которое изменило историю (например, pushState, replaceState)
historyOldUrl	URL, с которого перешли. Актуально, если используется History API
historyNewUrl	URL, на который перешли. Актуально, если используется History API

Константа

Константа всегда принимает фиксированное значение, которое вы указываете в поле Значение. Переменная может использоваться повторно, например, для нескольких тегов с одинаковыми значениями.

Собственный файл cookie

Чтобы извлечь значение cookie в переменную достаточно только корректно указать название вашего файла cookie. Если в нескольких путях или на разных уровнях одного домена используются файлы cookie с одинаковым названием, выбирается первый из них (тот, который будет идти первым в списке, если вызвать функцию document.cookie со страницы сайта).

Вы также можете включить URI-декодирование файла cookie при необходимости. Когда файл сохраняется на компьютере, некоторые символы могут быть закодированы для безопасности или обеспечения совместимости с URI-форматом.

Переменная уровня данных

Содержит информацию, которая передается с уровня данных в МТС Тег. Когда вы используете уровень данных, происходит передача данных ключ-значение.

Ключ укажите в поле Имя переменной уровня данных. Значение задается при помощи вызова

dataLayer.push():
dataLayer.push({'Data Layer Name': 'value'}).

Data Layer Name — название уровня данных. Если в вашем проекте используется другое название, укажите его в коде.

Точки в ключе интерпретируются как переход на следующий уровень во вложенных структурах. Например, в

dataLayer.push('m.t.s': 'value')

Название ключа будет интерпретировано как

m.t.s  {'m.t.s': 'value'}.

Элемент DOM

Переменная возвращает текстовое содержимое любого элемента DOM и значения любого атрибута-элемента DOM. В поле querySelector элемента укажите его CSS-селектор. В поле Название атрибута — имя атрибута.

Если имя атрибута задано, переменной будет присвоено значение из этого атрибута. Если имя атрибута не задано, значение переменной будет содержать текст, который находится в элементе DOM.

Видимость элемента

Позволяет определить был ли виден элемент в интерфейсе в браузере пользователя. Для определения элемента введите его ID или селектор CSS (querySelector, проверяется на видимость). Значение возвращается в формате True (полностью показывается) или False (не показывается на экране).

Переменная JavaScript

Возвращает значение глобальной переменной JavaScript, имя которой вы указали в поле Имя глобальной переменной. Используйте этот тип переменной, если её значение задано в коде страницы

Например, если var NameVar = 10, переменная вернет значение 10.

Собственный код JavaScript

Универсальная переменная для запуска собственного JavaScript. Значение переменной рассчитывается функцией в браузере. Например,

function () {
  var date = new date ();
  return date.getDate();
}

Номер опубликованной версии

Переменная хранит номер опубликованной версии контейнера, которая сейчас работает на странице. Используйте переменную, чтобы сократить время на проверку номера версии во время тестирования, — не искать его вручную.

Формат значений переменной

Формат значения	Описание
Изменить регистр символов	Возможность изменить регистр возвращаемого значения пользовательской веб-переменной на верхний/нижний
Преобразовать null в другое значение	Возможность изменить null значения в параметрах переменной на введенное
Преобразовать undefined в другое значение	Возможность изменить undefined значения в параметрах переменной на введенное
Преобразовать true в другое значение	Возможность изменить true значения в параметрах переменной на введенное
Преобразовать false в другое значение	Возможность изменить true значения в параметрах переменной на введенное
Экранирование символов для защиты сайта	Защита сайта от XSS-атак. Экранирование символов не позволит злоумышленнику внедрить на страницу JavaScript-код, который не был предусмотрен разработчиками, и украсть данные пользователей