← Cloudflare Zaraz / zaraz / reference
Триггеры и правила
Триггеры определяют условия, при которых инструмент запускает действие. В большинстве случаев ваша цель заключается в том, чтобы создать триггеры, соответствующие определённым событиям сайта, важным для вашего бизнеса. Триггер может основываться на событии, произошедшем на сайте, например на нажатии кнопки или загрузке определённой страницы.
Такие события сайта можно передавать в Cloudflare Zaraz несколькими способами. Например, можно использовать Track метод Web API или dataLayer вызов. Если вы не хотите писать код для отслеживания событий на сайте, можно настроить триггеры для отслеживания событий на стороне браузера, используя разные типы правил, например слушатели кликов или отправку форм.
Типы правил
Точный состав триггера зависит от выбранного типа правила.
Правило сопоставления
Zaraz сопоставляет введённую вами переменную в Имя переменной на текст из Строка сопоставления. Полный список поддерживаемых переменных см. в разделе Справочник свойств.
Пример триггера: Match zaraz.track("purchase")
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | Имя события | Equals | purchase |
Если вы создаёте триггер с правилами соответствия на основе переменных из категорий Page Properties, Cookies, Device Properties или Miscellaneous, часто требуется добавить второе правило, которое соответствует Pageview. В противном случае ваш триггер будет действовать и для любого другого события на этой странице. См. Создание триггера чтобы узнать, как добавить в триггер несколько условий.
Пример триггера: все страницы под /blog
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | URL pathname | Начинается с | /blog |
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | Имя события | Equals | Pageview |
Пример триггера: все авторизованные пользователи
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | Cookie: имя: isLoggedIn |
Equals | true |
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | Имя события | Equals | Pageview |
См. Справочник свойств для получения дополнительной информации о переменных, которые можно использовать с правилом Match.
Click listener
Отслеживает клики на веб-странице. Вы можете настроить слушатели кликов с помощью CSS-селекторов или выражений XPath. Ожидание действий (в миллисекундах) указывает Zaraz не изменять страницу в течение заданного времени. Это позволяет всем запросам, инициированным слушателем кликов, достичь места назначения.
Пример триггера для CSS-селектора:
| Тип правила | Тип | Селектор | Ожидание действий |
|---|---|---|---|
| Click listener | CSS | #my-button |
500 |
Чтобы повысить производительность веб-страницы, можно ограничить слушатель кликов конкретным URL-адресом, объединив его с правилом Match. Например, чтобы отслеживать клики по кнопке на определённой странице, настройте в триггере следующие правила:
| Тип правила | Тип | Селектор | Ожидание действий |
|---|---|---|---|
| Click listener | CSS | #myButton |
500 |
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | URL pathname | Equals | /my-page-path |
Если нужно отслеживать переход по ссылке элемента с помощью CSS-селекторов, например на кликабельной кнопке, необходимо создать обработчик для href атрибут для <a> тег:
| Тип правила | Тип | Селектор | Ожидание действий |
|---|---|---|---|
| Click listener | CSS | a[href$='/#my-css-selector'] |
500 |
См. Создание триггера чтобы узнать, как добавить в триггер несколько правил.
Пример триггера для XPath:
| Тип правила | Тип | Селектор | Ожидание действий |
|---|---|---|---|
| Click listener | XPath | /html/body//*[contains(text(), 'Add To Cart')] |
500 |
Element Visibility
Запускает действие, когда CSS-селектор становится видимым на экране.
| Тип правила | CSS Selector |
|---|---|
| Element Visibility | #my-id |
Scroll depth
Запускает действие, когда пользователь прокручивает страницу на заданное количество пикселей. Это может быть фиксированное количество пикселей или процент от размера экрана.
Пример с пикселями
| Тип правила | CSS Selector |
|---|---|
| Scroll Depth | 100px |
Пример с процентом экрана
| Тип правила | CSS Selector |
|---|---|
| Scroll Depth | 45% |
Отправка формы
Отслеживает отправку форм с помощью CSS-селекторов. Выберите Проверка переключатель, чтобы триггер срабатывал только при отсутствии ошибок валидации формы.
Пример триггера:
| Тип правила | CSS Selector | Проверка |
|---|---|---|
| Отправка формы | #my-form |
Включить или отключить |
Чтобы повысить производительность веб-страницы, можно ограничить триггер отправки формы конкретным URL-адресом, объединив его с правилом Match. Например, чтобы отслеживать форму на определённой странице, настройте в триггере следующие правила:
| Тип правила | CSS Selector | Проверка |
|---|---|---|
| Отправка формы | #my-form |
Включить или отключить |
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | URL pathname | Equals | /my-page-path |
См. Создание триггера чтобы узнать, как добавить в триггер несколько условий.
Timer
Настройте таймер, который будет запускать триггер через каждые Интервал. Укажите интервал времени в миллисекундах. В Лимит укажите, сколько раз будет запущен интервал, вызывая срабатывание триггера. Если не указать ограничение, таймер будет повторяться, пока страница отображается.
Пример триггера:
| Тип правила | Интервал | Лимит |
|---|---|---|
| Timer | 5000 |
1 |
Таймер, показанный выше, сработает один раз через пять секунд. Чтобы повысить производительность страницы, можно ограничить триггер Timer конкретным URL, объединив его с правилом Match. Например, чтобы настроить таймер для отдельной страницы, задайте в триггере такие правила:
| Тип правила | Интервал | Лимит |
|---|---|---|
| Timer | 5000 |
1 |
| Тип правила | Имя переменной | Операция сопоставления | Строка сопоставления |
|---|---|---|---|
| Правило сопоставления | URL pathname | Equals | /my-page-path |
См. Создание триггера чтобы узнать, как добавить в триггер несколько условий.