Триггер

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

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

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

В статье приведена пошаговая инструкция по созданию триггера в контейнере. После настройки объект появляется в разделе «Обзор». Если контейнер установлен, триггер автоматически добавляется в код при публикации.

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

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

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

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

Статья описывает различные типы триггеров, которые помогают настроить точную активацию тегов в зависимости от действий пользователя или состояния страницы:

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

Для триггеров видимости доступны правила запуска, такие как срабатывание один раз на страницу, один раз на элемент, при каждом появлении или по заданному проценту и времени видимости. Также можно отслеживать изменения DOM-структуры.

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

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

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

В тексте вы найдете руководство по добавлению условий активации и блокировки в настройки тега через разделы «Активация» или «Исключение».

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

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

В статье приведена пошаговая инструкция по добавлению условий:

1. Перейдите в настройку триггера и нажмите «Добавить условие».
2. Выберите переменную из списка (или создайте новую).
3. Выберите оператор сравнения.
4. Задайте текстовое значение для сравнения с переменной.

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

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

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

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