Триггер

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

Триггер — это правило, определяющее активацию или блокировку запуска тега.

Управление триггерами

• Создать триггер: переход в контейнер, выбор Триггеры, нажатие Плюс, настройка и сохранение. Все триггеры отображаются в карточке контейнера, где их можно редактировать, публиковать или удалять. При публикации триггер автоматически вносится в код контейнера.
• Скопировать триггер: клик на триггер в рабочей области, выбор Другое — Копировать, редактирование и публикация копии.
• Откатить изменения: через Редактирование триггера, выбор Другое — Откатить изменения, возврат к исходному состоянию.

Типы триггеров

• Модель DOM готова: срабатывает после завершения загрузки HTML-кода, необходим для взаимодействия с DOM.
• Клик — все элементы: активируется при клике по любым элементам страницы.
• Изменение в истории: срабатывает при изменении URL-хеша или использовании pushState HTML5.
• Инициализация: запускается до других триггеров, по умолчанию присутствует в контейнере.
• Ошибка JavaScript: активируется при исключениях в скриптах, позволяет передавать сообщения об ошибках.
• Клик — только ссылки: срабатывает при клике по HTML-ссылкам.
• Просмотр страницы: запускается при начале загрузки страницы.
• Специальное событие: активируется при отправке пользовательского события в dataLayer.
• Таймер: отправляет события через заданный интервал.
• Окно загружено: срабатывает после полной загрузки страницы.
• Видимость элемента: активирует теги, когда элемент становится видимым в области просмотра.
• Глубина прокрутки: запускается в зависимости от прокрутки страницы.

Правило запуска триггера
Таблица описывает параметры активации: частота срабатывания, процент видимости, время видимости, отслеживание изменений DOM.

Триггеры исключения и активации

• Активация: задаёт условия для запуска тега (например, на всех страницах).
• Исключение: блокирует тег при выполнении определённых критериев (например, исключение региона).

Условия триггера
Для настройки фильтров: выбор переменной, оператора и значения (например, Page URL содержит mts.ru).

Пример
Конфигурация, активирующая тег при событии button-click в dataLayer.

Триггер — это правило, по которому активируется или блокируется запуск тега.

Управление триггерами

Создать триггер

1. Перейдите в контейнер, наведите на Триггеры и нажмите Плюс

3. Настройте триггер и сохраните его.

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

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

Скопировать триггер

Чтобы дублировать триггер:

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

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

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

Откатить изменения триггера

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

Как откатить триггер:

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

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

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

Типы триггеров

Модель DOM готова

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

Клик — все элементы

Триггер срабатывает, когда происходит клик по любым элементам на странице, например, ссылкам, изображениям, кнопкам.

Изменение в истории

Триггер срабатывает, если изменился фрагмент URL (хеш) или на сайте используются API pushState HTML5. С помощью такого триггера можно, например, активировать теги отслеживания действий на странице в приложении Ajax.

Инициализация

Триггер инициализации срабатывает до активации всех остальных триггеров. По умолчанию в каждом веб-контейнере есть триггер Инициализация – все страницы. Выберите этот триггер, чтобы он активировал нужные теги раньше всех остальных триггеров.

Ошибка JavaScript

Триггер срабатывает, когда на сайте не удается перехватить исключение JavaScript (window.onError). Он нужен для сохранения сообщений об ошибках в инструментах аналитики. Для извлечения и передачи сообщения об ошибке при срабатывании тега используйте переменную Ошибка JavaScript.

Клик — только ссылки

Триггер срабатывает при клике исключительно по HTML-ссылкам, содержащим тег a, например, mts.ru.

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

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

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

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

Таймер

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

Окно загружено

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

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

Триггер активирует теги, когда объект становится видимым в области просмотра. Например, после прокрутки страницы появился баннер.

Правило запуска триггера

Тип переменной	Переменная возвращает
Один раз на страницу	триггер активируется на странице 1 раз. Если на странице есть несколько элементов с одинаковым селектором, триггер сработает только при первом появлении одного из них. При обновлении страницы или переходе на другую страницу триггер сбрасывается и может снова активироваться, когда нужный элемент появится в поле зрения
Один раз на элемент	Триггер активируется 1 раз для каждого выбранного элемента на странице. Если несколько элементов соответствуют селектору, триггер сработает при первом появлении каждого из них. Если у нескольких элементов одинаковый селектор, триггер отреагирует только на первый найденный элемент
При каждом появлении элемента на экране	Триггер будет срабатывать при каждом отображении подходящего элемента на экране
Минимальный процент видимости, %	На сколько процентов должен быть виден элемент, чтобы триггер сработал
Минимальное время видимости, мс	Как долго выбранный элемент должен быть виден на экране для срабатывания триггера
Регистрация изменений DOM	Опция отслеживает удаление / добавление узлов DOM-структуры страницы (заголовков, изображений и т.п.)

Глубина прокрутки

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

Пример

Пример создания конфигурации, которая активирует тег при отправке пользовательского события button-click в dataLayer

<button onclick="maLayer.push({'event': 'button-click'});">Button</button >

Триггеры исключения и активации

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

Пример

Например, тегом управляет триггер, который активирует его на всех страницах ресурса или во всех регионах страны.

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

Триггер исключения можно создать, только если настроен триггер активации.

Пример

Например, необходимо запустить тег во всех регионах России, кроме Астрахани. Для этого к тегу добавляем триггер активации «Вся Россия» и блокирующий триггер Астрахань.

Пример добавления триггера исключения в настройки тега:

Как настроить триггеры активации и исключения

1. Настройте тег, которым будет управлять триггер. Как создать тег.
2. В настройках тега (Редактирование тега — Триггеры — Активация или Исключение) добавьте или создайте необходимые триггеры активации и блокировки.

Условия триггера

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

1. Перейдите в настройку Триггера и нажмите Добавить условие

2. Выберите переменную, которая будет задавать условие триггера, из списка. Если в списке пусто, создайте переменную.
3. Выберите оператор.
4. Задайте текстовое значение, которое будет сравниваться с переменной во время активации триггера

Пример

Page URL (Имя) содержит (оператор) mts.ru (значение).