Типы пользовательских переменных для сайтов

Если встроенных переменных недостаточно для решения ваших задач, вы можете создать пользовательские переменные. Сделать это можно в Google Менеджере тегов.

Чтобы создать пользовательскую переменную, выполните следующие действия:

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

В Менеджере тегов поддерживаются следующие типы пользовательских переменных для сайтов:

• Панель навигации
  • URL перехода HTTP
  • URL
• Переменные страницы
  • Собственный файл cookie
  • Собственный код JavaScript
  • Переменная уровня данных
• Элементы страницы
  • Переменная автоматического события
  • Элемент DOM
  • Видимость элемента
• Утилиты
  • Константа
  • Специальное событие
  • Название среды
  • Настройки Google Аналитики
  • Тег Google: настройки конфигурации
  • Тег Google: настройки события
  • Таблица поиска
  • Случайное число
  • Таблица регулярных выражений
• Данные, предоставленные пользователями
• Данные контейнера
  • Идентификатор контейнера
  • Номер версии контейнера
  • Режим отладки

Навигация

URL перехода HTTP

URL страницы, с которой пользователь перешел на текущую (значение поступает из заголовка HTTP referer). Например, если пользователь перешел в каталог товаров с главной страницы сайта, используется URL главной страницы. Экземпляр переменной генерируется Менеджером тегов автоматически, но при желании вы можете создать дополнительные. Кроме того, вы можете указать, будет ли в значении указываться полный URL или какой-то из его компонентов.

URL

URL текущей страницы. При желании вы можете создать дополнительные экземпляры этой переменной. Вы также можете указать, будет ли в значении указываться полный URL или какой-то из его компонентов: протокол, имя хоста, порт, путь, расширение файла, запрос или фрагмент. Значение поступает из свойства document.location. Если вы хотите, чтобы значение поступало из другой переменной, нажмите "Дополнительные настройки" и выберите нужный вариант в раскрывающемся списке Источник URL.

Переменные страницы

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

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

Собственный код 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({"a.b.c": "value"}) как три вложенных уровня: {a: {b: {c: "value"}}}.

Переменная JavaScript

Значение заданной вами глобальной переменной JavaScript. Этот тип можно использовать, если нужное значение недоступно на уровне данных (см. Переменная уровня данных) и в модели DOM (см. Элемент DOM), но содержится в исходном коде страницы в виде глобальной переменной 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 (объектная модель документа), в которой содержатся все HTML-элементы страницы. Этот тип можно использовать, если нужное значение недоступно на уровне данных (см. Переменная уровня данных), но содержится в модели DOM.

Вы можете указать название атрибута (необязательно). В этом случае переменная примет значение, полученное из этого атрибута (например, data-food="cupcake"). В противном случае значением переменной будет текст, содержащийся в элементе DOM.

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

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

Можно выбрать тип переменной:

• True/False. Логическое значение, которое показывает, отображается ли выбранный элемент в момент обращения к переменной.
• Процент. Числовое значение (0–100), которое показывает долю выбранных элементов, отображаемых на экране в момент обращения к переменной.

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

Утилиты

Константа

Значением константы является введенный вами текст. Константы часто используются при работе с несколькими тегами, связанными с одним и тем же номером аккаунта. Больше об этом можно узнать в разделе Настройки Google Аналитики.

Специальное событие

Название специального события, переданного на уровень данных.

Название среды

Возвращает название среды, открытой в режиме предварительного просмотра.

Настройки Google Аналитики

Переменная настроек используется в тегах Universal Analytics, которые входят в состав контейнеров для сайтов и мобильных приложений (Firebase). Она служит для настройки конфигураций Google Аналитики, применяемых к нескольким разным тегам. При создании тега Google Аналитики с помощью Universal Analytics Менеджер тегов предложит вам выбрать или создать переменную настроек. Подробнее…

Тег Google: настройки конфигурации

Эта переменная позволяет задавать параметры уровня конфигурации при загрузке тега Google.

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

Подробнее о повторном использовании настроек конфигурации…

Тег Google: настройки события

Эта переменная позволяет задать параметры уровня события, чтобы отправлять дополнительные данные вместе с событием GA4.

Допустим, в вашем интернет-магазине проходит распродажа, и вы хотите отслеживать, сколько клиентов используют предоставленный вами код скидки. Вместо того чтобы вручную добавлять во все свои теги параметр discount, вы можете создать параметр с переменной Тег Google: настройка события и использовать его везде, где необходимо.

Подробнее о повторном использовании настроек конфигурации…

Таблица поиска

Значение переменной задается в соответствии с инструкциями в таблице поиска. Эта таблица содержит два столбца (в примере ниже таблица не заполнена):

Чему должно быть равно значение [выбранной переменной]	Какое значение присвоить [этой переменной]

Таблица поиска позволяет создавать переменные, значения которых будут меняться вслед за значением другой переменной. Это может быть полезно, если конфигурация сайта позволяет привязать определенное значение (например, идентификатор отслеживания конверсий) к URL, элементу DOM или другой части страницы. Ниже приведен пример создания переменной Идентификатор конверсии. Для URL /thanks/buy1.html устанавливается значение 12345, а для URL thanks/buy2.html – значение 34567.

Когда {{url}} содержит…	Использовать для {{Идентификатор конверсии}} значение…
/thanks/buy1.html	12345
/thanks/buy2.html	34567
/thanks/buy3.html	56789

Случайное число

Случайное число в диапазоне от 0 до 2 147 483 647.

Таблица регулярных выражений

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

Рассмотрим таблицу регулярных выражений:

Шаблон	Результат
.*/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

Входная переменная сопоставляется со всеми шаблонами в таблице регулярных выражений в нисходящем порядке. При обнаружении соответствия возвращается значение результата из этой строки.

Выберите Установить значение по умолчанию, чтобы задать выходное значение на случай, если соответствие не найдено.

По умолчанию шаблоны нечувствительны к регистру и должны полностью совпадать с введенной строкой. Эти условия можно изменить, применив следующие расширенные настройки:

• Игнорировать регистр. Шаблоны не будут учитывать регистр, и вам не придется создавать специальное регулярное выражение для этого условия.

• Только полное соответствие. Значения в шаблонах должны полностью совпадать с вводимыми значениями, как если бы вокруг значений в шаблонах были поставлены символы начала (^) и окончания ($) строки. Если эта настройка не включена, поиск совпадений будет вестись по любой части строки.

• Группы для извлечения подстроки и функция замены. Когда эта настройка включена, вы можете включать фрагменты входной переменной в выходные значения с помощью значка доллара. Допустим, если задано регулярное выражение /(news)/page(2)\.html, вы можете использовать $1 в качестве обозначения первой группы для извлечения подстроки ("news") и $2 – в качестве второй ("2").

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

Данные, предоставленные пользователями

Собирайте информацию из формы для обратной связи, например адрес электронной почты, номер телефона, имя и адрес. Чтобы указать, какую информацию нужно собирать, используйте один из следующих режимов:

• Автоматическая настройка – режим, когда система самостоятельно обнаруживает поля форм на сайте и новые записи.
• Настройка вручную позволяет сопоставить существующие переменные Менеджера тегов с соответствующими полями данных, предоставляемых пользователями, например адресом электронной почты, номером телефона, именем и адресом.
• Код позволяет указать переменную уровня данных или пользовательскую переменную JavaScript, которая будет возвращать структурированный объект данных, предоставленных пользователями.

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

Идентификатор контейнера

Возвращает идентификатор контейнера Менеджера тегов, например "GTM-101010".

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

Возвращает номер версии контейнера (просматриваемой или уже опубликованной).

Режим отладки

Принимает значение true, когда контейнер просматривается в режиме отладки, и false, когда нет.