Триггер

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

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

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

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

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

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

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

Глубина прокрутки
Триггер активирует теги в зависимости от прокрутки страницы вертикально или горизонтально.

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

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

Условия триггера
Возможность задавать фильтры активации через переменные, операторы и значения. Пример: проверка наличия mts.ru в URL.

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

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

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

1. Перейдите в контейнер. Откроется рабочая область.
2. Кликните на Создать... — Триггер

3. Настройте триггер и сохраните его. Подробнее про настройку триггеров — ниже. Все изменённые и добавленные объекты появятся в рабочей области — раздел «Обзор».

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

Все триггеры

Все созданные триггеры находятся в контейнере — раздел «Триггеры». Далее их можно редактировать, останавливать, публиковать и удалять

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

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

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 (значение).