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