触发器定义工具启动操作的条件。在大多数情况下,你的目标是创建与业务相关的特定网站事件相匹配的触发器。触发器可以基于网站上发生的事件,例如选择按钮之后或加载特定页面之后。
这些网站事件可以通过多种方式传递给 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(创建触发器)。
设置一个计时器,在每个 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(创建触发器)。