跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

触发器与规则

最后更新 查看 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(创建触发器)。

这篇文档对您有帮助吗?