跳转到内容
搜索文档

触发器与规则

最后更新 查看 MarkdownAgent 设置

触发器定义工具启动操作的条件。在大多数情况下,你的目标是创建与业务相关的特定网站事件相匹配的触发器。触发器可以基于网站上发生的事件,例如选择按钮之后或加载特定页面之后。

这些网站事件可以通过多种方式传递给 Cloudflare Zaraz。你可以使用 Web API 的 Track 方法或 dataLayer 调用。或者,若你不想编写代码来跟踪网站上的事件,可以将触发器配置为监听浏览器端网站事件,使用不同类型的规则,例如点击监听器或表单提交。

规则类型

触发器的具体构成取决于你选择的规则类型。

匹配规则

Zaraz 将你在 Variable name(变量名) 中输入的变量与 Match string(匹配字符串) 下的文本进行匹配。有关支持变量的完整列表,请参阅 Properties reference

触发器示例:匹配 zaraz.track("purchase")

规则类型 Variable name Match operation Match string
Match rule Event Name Equals purchase

若你使用来自 Page Properties、Cookies、Device Properties 或 Miscellaneous 类别的变量创建带有 match 规则的触发器,通常还需要添加第二条匹配 Pageview 的规则。否则,你的触发器对发生在此页面上的其他每个事件也有效。有关如何为触发器添加多个条件,请参阅 Create a trigger

触发器示例:/blog 下的所有页面

规则类型 Variable name Match operation Match string
Match rule URL pathname Starts with /blog
规则类型 Variable name Match operation Match string
Match rule Event Name Equals Pageview

触发器示例:所有已登录用户

规则类型 Variable name Match operation Match string
Match rule Cookie: name: isLoggedIn Equals true
规则类型 Variable name Match operation Match string
Match rule Event Name Equals Pageview

使用 Match rule 时可使用的变量的更多信息,请参阅 Properties reference

点击监听器

跟踪网页中的点击。你可以使用 CSS 选择器或 XPath 表达式设置点击监听器。**Wait for actions(以毫秒为单位)**告诉 Zaraz 在指定时间内阻止页面更改。这使点击监听器触发的所有请求都能到达其目标。

CSS 选择器的触发器示例:

规则类型 Type Selector Wait for actions
Click listener CSS #my-button 500

为改善网页性能,你可以通过将其与 Match rule 组合,将点击监听器限制到特定 URL。例如,要跟踪特定页面上的按钮点击,可在触发器中设置以下规则:

规则类型 Type Selector Wait for actions
Click listener CSS #myButton 500
规则类型 Variable name Match operation Match string
Match rule URL pathname Equals /my-page-path

若需要使用 CSS 选择器跟踪元素的链接——例如在可点击按钮上——你必须为 <a> 标签的 href 属性创建监听器:

规则类型 Type Selector Wait for actions
Click listener CSS a[href$='/#my-css-selector'] 500

有关如何为触发器添加多条规则,请参阅 Create a trigger(创建触发器)


XPath 的触发器示例:

规则类型 Type Selector Wait for actions
Click listener XPath /html/body//*[contains(text(), 'Add To Cart')] 500

元素可见性

当 CSS 选择器在屏幕上变为可见时触发操作。

规则类型 CSS Selector
Element Visibility #my-id

滚动深度

当用户滚动预定数量的像素时触发操作。可以是固定像素数或屏幕的百分比。

像素示例

规则类型 CSS Selector
Scroll Depth 100px

屏幕百分比示例

规则类型 CSS Selector
Scroll Depth 45%

表单提交

使用 CSS 选择器跟踪表单提交。选择 Validate(验证) 切换按钮,仅在表单无验证错误时触发触发器。

触发器示例:

规则类型 CSS Selector Validate
Form submission #my-form Toggle on or off

为改善网页性能,你可以通过将其与 Match rule 组合,将 Form submission 触发器限制到特定 URL。例如,要跟踪特定页面上的表单,可在触发器中设置以下规则:

规则类型 CSS Selector Validate
Form submission #my-form Toggle on or off
规则类型 Variable name Match operation Match string
Match rule URL pathname Equals /my-page-path

有关如何为触发器添加多个条件,请参阅 Create a trigger(创建触发器)

Timer

设置一个计时器,在每个 Interval(间隔) 后触发触发器。以毫秒为单位设置间隔时间。在 Limit(限制) 中指定间隔将运行的次数,从而触发触发器。若未指定限制,只要页面仍在显示,计时器就会重复。

触发器示例:

规则类型 Interval Limit
Timer 5000 1

上述 Timer 将在五秒后触发一次。为改善网页性能,你可以通过将其与 Match rule 组合,将 Timer 触发器限制到特定 URL。例如,要在特定页面上设置计时器,可在触发器中设置以下规则:

规则类型 Interval Limit
Timer 5000 1
规则类型 Variable name Match operation Match string
Match rule URL pathname Equals /my-page-path

有关如何为触发器添加多个条件,请参阅 Create a trigger(创建触发器)

这篇文档对您有帮助吗?