点击监听器
触发该代码时,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 |
历史记录事件的来源。可以是polling 、popstate 、pushState 或replaceState 。 |
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.linkClick
或 gtm.formSubmit
事件未触发,这是因为您的网站 出于某种原因撤销了默认的浏览器操作。如果您希望代码在所有情况下都 触发,只需取消选中监听器上的检查验证结果 即可。
网页中不同JavaScript事件之间的相互作用可能会以预料之外的方式影响Google 跟踪代码管理器的自动事件跟踪功能。因此, 在将代码部署到实际网站之前,请务必在测试模式下 测试跟踪代码设置情况。另外,由于自动事件采用 “监听器代码”的形式,您使用规则部署监听器的范围 仅限于您之前测试过的特定位置。