Триггер
Краткое содержание
Триггер — это правило, по которому активируется или блокируется запуск тега.
Управление триггерами
- Создать триггер: Перейдите в контейнер, выберите Создать... — Триггер, настройте и сохраните. Изменения отобразятся в разделе «Обзор».
- Все триггеры: Найдены в разделе «Триггеры» контейнера. Можно редактировать, останавливать, публиковать и удалять.
- Копировать триггер: В рабочей области выберите Другое — Копировать, измените и сохраните копию.
- Откатить изменения: В редактировании триггера выберите Другое — Откатить изменения, чтобы вернуться к исходному состоянию.
Типы триггеров
- Модель DOM готова: Срабатывает после завершения обработки HTML-кода.
- Клик — все элементы: Активируется при клике по любым элементам.
- Изменение в истории: Реагирует на изменения URL или
pushState HTML5. - Инициализация: Срабатывает до остальных триггеров.
- Ошибка JavaScript: Перехватывает исключения и передаёт сообщения об ошибках.
- Клик — только ссылки: Активируется при клике по ссылкам
<a>. - Просмотр страницы: Срабатывает при начале загрузки страницы.
- Специальное событие: Реагирует на пользовательские события в
dataLayer. - Таймер: Отправляет события через заданный интервал.
- Окно загружено: Срабатывает после полной загрузки страницы.
- Видимость элемента: Активирует теги, когда элемент появляется в области просмотра.
Правило запуска триггера
В таблице указаны условия активации:
- Один раз на страницу: Триггер срабатывает один раз при первом появлении элемента.
- Минимальный процент видимости: Требуется определённый процент видимости элемента.
- Регистрация изменений DOM: Отслеживает добавление/удаление элементов.
Глубина прокрутки
Активирует теги в зависимости от прокрутки страницы.
Триггеры исключения и активации
- Активация: Условие для запуска тега (например, активировать на всех страницах).
- Исключение: Ограничивает активацию (например, исключить регион Астрахань).
- Настройка: В настройках тега добавьте триггеры активации и исключения.
Условия триггера
- Добавьте переменную, оператор и значение для фильтрации.
- Пример:
Page URL (Имя) содержит mts.ru.
Триггер — это правило, по которому активируется или блокируется запуск тега.
Управление триггерами
Создать триггер
- Перейдите в контейнер. Откроется рабочая область.
- Кликните на Создать... — Триггер
-
Настройте триггер и сохраните его. Подробнее про настройку триггеров — ниже. Все изменённые и добавленные объекты появятся в рабочей области — раздел «Обзор».
-
Если контейнер установлен, по клику на Опубликовать триггер добавится в код контейнера автоматически.
Все триггеры
Все созданные триггеры находятся в контейнере — раздел «Триггеры». Далее их можно редактировать, останавливать, публиковать и удалять
Скопировать триггер
Чтобы дублировать триггер:
-
В рабочей области кликните на триггер, откроется форма Редактирования.
-
Выберите Другое — Копировать
Копия триггера сразу появится в форме редактирования — её можно править, сохранять и публиковать.
Откатить изменения триггера
Внесённые изменения в триггер можно отменить. Тогда триггер откатится до состояния, в котором он был на момент создания рабочей области.
-
В рабочей области кликните на триггер. Откроется форма Редактирования.
-
Выберите Другое — Откатить изменения
Триггер мгновенно откатится до изначального состояния в версии.
Типы триггеров
Модель 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 >
Триггеры исключения и активации
Триггер активации задаёт условие для запуска тега. То есть тег будет активирован, только когда будет выполнено условие триггера.
Например, тегом управляет триггер, который активирует его на всех страницах ресурса или во всех регионах страны.
Триггер исключения ограничивает условия активации — триггер активирует тег, но его активацию можно ограничить определённым критерием. Так, можно задать условие блокировки тега.
Триггер исключения можно создать, только если настроен триггер активации.
Например, необходимо запустить тег во всех регионах России, кроме Астрахани. Для этого к тегу добавляем триггер активации «Вся Россия» и блокирующий триггер Астрахань.
Пример добавления триггера исключения в настройки тега:
Как настроить триггеры активации и исключения
- Настройте тег, которым будет управлять триггер. Как создать тег.
- В настройках тега (Редактирование тега — Триггеры — Активация или Исключение) добавьте или создайте необходимые триггеры активации и блокировки.
Условия триггера
По умолчанию триггеры срабатывают в ответ на все события определенного типа. Можно задать более конкретные условия срабатывания триггера с помощью фильтров активации.
- Перейдите в настройку Триггера и нажмите Добавить условие
- Выберите переменную, которая будет задавать условие триггера, из списка. Если в списке пусто, создайте переменную.
- Выберите оператор.
- Задайте текстовое значение, которое будет сравниваться с переменной во время активации триггера
Page URL (Имя) содержит (оператор) mts.ru (значение).