window 上广播所发生的情况。监听这些事件,你就可以在数据分析工具中跟踪访客行为、响应访客的回答,或在恰当的时机运行你自己的代码。
event.detail 中。其中始终包含两项:
quizId:触发该事件的测验llQuizApi:测验 API,让你可以直接在监听器中读取或修改测验
ll-quiz-init 会在测验准备就绪后立即触发,这可能早于你的脚本运行。不必担心:即使监听器注册得较晚,也仍会收到 ll-quiz-init。其他所有事件都由访客操作触发,发生在你的脚本就位之后。事件一览
ll-quiz-init
在测验出现在页面上并准备就绪后触发一次。你可以在这里获取llQuizApi、预填值或进行初始化设置。
ll-quiz-step-view
每次显示步骤时都会触发,包括加载时显示的第一个步骤,以及访客返回上一步时。ll-quiz-step-leave
在访客离开某个步骤时触发,早于下一个ll-quiz-step-view。可用于衡量某个步骤所花的时间,或保存草稿。
ll-quiz-value-change
在提交答案时触发。需要输入的字段(文本、邮箱、电话、数字、多行文本、日期、出生日期、邮编、地址、OTP)会在访客离开该字段或该步骤时提交,因此每个答案只会触发一次事件,而不是每次按键都触发。其他所有输入,以及通过 API 设置的所有值,都会立即提交。 如果值没有变化,则不会触发。测验加载时已存在的值(默认值、URL 参数、恢复的答案)作为起始值,不会触发事件;它们包含在ll-quiz-step-view 的 fields 中。
ll-quiz-input-click
在访客点击多项选择或图片选择区块中的某个选项时触发。对于同一次点击,它会在ll-quiz-value-change 之前触发。
ll-quiz-button-click
在点击 Continue、Previous、Submit 或 Button 区块时触发,早于任何校验。即使这次点击最终被阻止也会触发,因此它统计的是尝试次数,而不是成功次数。ll-quiz-validation-error
当访客尝试离开某个步骤、但因步骤中有无效内容而被阻止时触发。每次尝试触发一个事件,在所有检查(包括邮箱、电话和 OTP 字段的服务器检查)完成后触发,并准确列出访客看到的错误。隐藏区块永远不会包含在内。user:按钮或会触发跳转的选项。api:你的脚本(validateStep()、goNext()、goToStep()、submit())。system:测验尝试自动前进(加载器、倒计时、支付)ll-quiz-google-address-select
在访客从 Google Address 区块中选择一条建议地址时触发。ll-quiz-submit
在测验提交、线索保存之后触发。这里适合把答案发送到其他地方或触发转化。ll-quiz-exit
在标签页或窗口被关闭或跳转离开时触发,基于浏览器的pagehide 事件。
fields 和 fieldsSimple
fields 是一个列表,每个已回答的区块对应一条:
fieldsSimple 包含相同的信息,但以标签为键组成一个对象,便于转发:
fieldsSimple 会用逗号连接它们的值。测验 API 的 getAnswers() 和 getAnswersSimple() 返回的数据结构与此相同。