事件监听器

点击监听器

触发该代码时,Google跟踪代码管理器会开始监听网页中所有类型的 点击(比如按钮点击、链接点击等)。发生点击操作时, 将生成Google跟踪代码管理器事件gtm.click。您可以使用 {{event}} equals gtm.click在规则条件中检查该事件。若要检查 某个具体的元素(如“添加到购物车”按钮)是否获得点击,可添加 诸如{{element id}} equals addToCart的规则。请注意,只有 在可响应监听器而触发的代码所用的规则中,才能检查 该值。请参阅Google Analytics(分析)事件 中的具体示例。

表单提交 监听器

触发该代码时,Google跟踪代码管理器会开始监听网页中的表单提交 情况。发生表单提交操作时,将生成Google跟踪代码管理器事件 gtm.formSubmit。您可以使用 {{event}} equals gtm.formSubmit在规则条件中检查该事件。请注意,只有在 可响应监听器而触发的代码所用的规则中,才能检查 该值。请参阅Google Analytics(分析)事件 中的具体示例。

等待代码

延迟表单提交,直到依赖于此事件的所有代码 都已触发,或者指定的超时时间已经过去(以时间较短的为准)。如果未选择该选项, 在表单提交导致下个网页加载之前,较慢的代码可能无法触发。

检查验证结果

只有在表单能够成功提交时,才会触发代码。如果未选择该选项,那么 只要用户尝试提交表单,就会触发代码。如需更多信息,请参阅下方的关于检查验证结果选项

链接点击监听器

触发该代码时,Google跟踪代码管理器会开始监听网页中的 链接点击。要跟踪用户点击链接后转到其他网页的情况,应该使用 链接点击监听器(而不是点击监听器)。发生链接点击操作时,将生成Google 跟踪代码管理器事件gtm.linkClick。您可以使用 {{event}} equals gtm.linkClick在规则条件中检查该事件。请注意,只有在可响应监听器而触发的代码所用的规则中,才能检查 该值。请参阅Google Analytics(分析)事件中的具体示例。

等待代码

延迟打开链接,直到所有代码都已触发,或者 指定的超时时间已经过去(以时间较短的为准)。如果未选择该选项,在链接点击 导致下个网页加载之前,较慢的代码可能无法触发。

检查验证结果

只有在链接打开操作被视为有效时才触发代码。如果 未选择该选项,那么只要用户尝试点击链接,就会触发代码。如需更多信息,请参阅下方的关于检查验证结果选项

计时器监听器

触发该代码时,Google跟踪代码管理器会启动倒数计时器, 按您指定的间隔(以毫秒为单位)触发事件。如果间隔为 5000,则每五秒钟就会触发一个事件。事件的名称为 您在“事件名称”中所指定的任意名称。例如,如果您将“事件名称”指定为 “timer5”,则可以使用{{event}} equals timer5在规则条件中检查该事件。请注意,只有在可响应监听器而触发的代码所用的规则中, 才能检查该值。请参阅Google Analytics(分析)事件中的具体示例。限值 为触发该事件的最大次数。如果将“限制”留空, 将一直触发该事件,直至用户离开页面。

历史记录监听器

此代码会监听对网页历史记录做出的更改。此类历史记录事件通常会在Ajax应用中的网址片段(#)发生更改,或者网站使用HTML5 pushState API的情况下发生。此事件监听器可用来跟踪虚拟网页浏览情况。

发生历史记录事件时,此代码会将以下消息推送到数据层上:

event 将此对象标记为gtm.historyChange
gtm.historyChangeSource 历史记录事件的来源。可以是pollingpopstatepushStatereplaceState
gtm.oldUrlFragment 网址片段以前是什么。
gtm.newUrlFragment 网址片段现在是什么。
gtm.oldHistoryState 旧的历史记录状态对象,由网站对pushState的调用控制。
gtm.newHistoryState 旧的历史记录状态对象,由网站对pushState的调用控制。

JavaScript错误监听器

触发该代码时,Google跟踪代码管理器会监听未捕获的JavaScript异常。发生此类异常时,Google跟踪代码管理器会将对象推送到数据层上,并传递用于描述错误的键值对。下表介绍了JavaScript错误监听器事件可使用的每种键:

event 将此对象标记为gtm.pageError
gtm.errorMessage 包含JavaScript错误消息文字内容的字符串。
gtm.errorUrl 出现该错误的网址。
gtm.errorLineNumber 在代码中出现该错误的行数。

此事件可在规则条件中使用{{event}} equals gtm.pageError进行监控。请参阅Google Analytics(分析)事件中的具体示例。

关于检查验证结果选项

“验证”是指JavaScript阻止浏览器对某个事件执行默认操作 的功能。在浏览器中,针对链接点击的 默认操作是将访问者转到链接网址。而针对表单的默认操作则是提交 表单。

无论是对于链接点击还是表单提交,网页上的JavaScript事件监听器 都能够阻止默认操作发生。如果您希望 将用户留在当前页面上,或者用户提交的表单无效,此功能 就非常实用。

以下几种方法可阻止发生默认操作。在DOM级别0监听器中 (例如onclick="..."),您可以使用return false;。在级别2以上的监听器中,您 可以使用event.preventDefault方法。

利用检查验证结果选项,您可以仅在 默认操作未被网页中的其他代码段阻止的情况下触发代码 。此方法可避免多次重复跟踪同一表单提交操作 (例如:用户尝试提交无效表单,更正了错误,然后 又重新提交表单)。

如果启用检查验证结果后导致gtm.linkClickgtm.formSubmit事件未触发,这是因为您的网站 出于某种原因撤销了默认的浏览器操作。如果您希望代码在所有情况下都 触发,只需取消选中监听器上的检查验证结果 即可。

网页中不同JavaScript事件之间的相互作用可能会以预料之外的方式影响Google 跟踪代码管理器的自动事件跟踪功能。因此, 在将代码部署到实际网站之前,请务必在测试模式下 测试跟踪代码设置情况。另外,由于自动事件采用 “监听器代码”的形式,您使用规则部署监听器的范围 仅限于您之前测试过的特定位置。

发表回复