自定义事件
自定义事件用来记注册、加购、播放这类页面浏览覆盖不到的动作，结果出现在 控制台网站统计事件 和 事件分析。金额类事实更适合服务端上报，见 服务端事件快速入门。
参数
网站上调用 webcount.track(name, props)。name 必填，截到 100 个字符。props 最多 20 个键；键截到 50 个字符，字符串值截到 200 个字符；只保留字符串、数字和布尔。
在事件定义里登记时，名字必须蛇形、字母开头、不超过 40 个字符，且不能以 $、_ 或 wc_ 开头。$ 留给应用预置事件，双下划线留给自动采集。
名字是数据里的键，写进事件定义后就不要再改，显示名可以后改。同一动作在网站、应用和小程序上用同一个名字，全端分析才能放在一起看。属性只放会拿来拆分的维度，不要把整段输入原文塞进去。
默认与限制
脚本加载前可以先把调用放进 window.__wcq，形如 ['track', 'signup', { plan: 'pro' }]，脚本执行时会补发。加载失败不会抛到页面上。同一访客在同一路径和查询串上，1 秒内名字与属性都相同的事件会被采集端去重。
示例
<script async src="https://YOUR_ORIGIN/w.js" data-site="YOUR_SITE_KEY"></script>
<script>
window.__wcq = window.__wcq || [];
window.__wcq.push(['track', 'signup', { plan: 'pro' }]);
</script>脚本已就绪时直接 webcount.track('signup', { plan: 'pro' })。
错误
空名字会被忽略。对象、数组不会进入属性。用了保留前缀的名字无法在收件箱里登记成正式定义。超长的名字和属性会在浏览器里静默截断，不会因为超限把整条事件丢掉。服务端对应字段见 服务端事件与日志导入。
自动采集与事后定义
站点开启全埋点且套餐允许时，首个页面浏览的响应会拉起扩展脚本，再加载全埋点脚本；它只记录可点击元素，密码框、data-wc-ignore 子树和客服容器不会采。点击要在收件箱里确认后才会变成可分析的事件。
参数
采样按百分比，默认 100。低于 100 时按设备标识稳定抽样，同一个人不会这次采、下次不采；没有设备标识则随机。黑名单是一组选择器，最多 20 条。文本采集默认关，且只在采集档位达到第三档时生效。滚动默认关。批量默认 20 条或约 2 秒发送一次。
三次点击落在约 300 毫秒、50 像素内时，会多记一条挫败点击。
默认与限制
未开全埋点或套餐不含此项时，这类请求会被丢掉。候选每天整理，也可以在收件箱里立即生成。接受之后会建成一条规则，并回溯最近 90 天。事件名仍须符合 事件与属性 的保留字规则。
示例
在 控制台全端分析数据管理事件收件箱 接受一条候选，填写蛇形事件名，或合并进已有事件，不必每个按钮都新起一个名字。页面上不需要先写 track。已经写死的业务事件不会被这条规则改名。
错误
选择器写错会被忽略，不会中断页面。高置信和低置信只影响排序，不影响采集。忽略候选不会删除已经入库的点击记录。
增强采集
这批事件跟着页面浏览由网站脚本自动发出，data-auto-track="false" 会把它们一并关掉。挫败点击不在其中，它跟随全埋点，见 自动采集与事后定义。
事件与默认值
| 事件 | 事件名 | 默认 | 何时发送 |
|---|---|---|---|
| 外链点击 | __outbound | 开 | 链接指向别的主机 |
| 文件下载 | __download | 开 | 路径以常见文档、压缩包或安装包扩展名结尾 |
| 表单提交 | __form | 关 | 脚本上显式打开表单采集 |
| 未找到页面 | __404 | 开 | 404 模板的脚本标了对应属性 |
| 性能 | __vitals | 开 | 离开首屏时汇总一次 |
| 站内搜索 | 无，写在页面浏览上 | 开 | 落地页查询串命中参数名 |
参数
外链和下载可用 data-outbound="false"、data-downloads="false" 关掉，只认 http 与 https 链接，邮件链接和脚本链接不会记。表单要设 data-forms="true" 才会监听提交，只记录表单的 id、name 和 action，不记录字段内容。404 要在错误页的脚本上加 data-404="true"。性能可用 data-vitals="false" 关闭，否则上报首屏的几项耗时。站内搜索默认认 s、q、search，在网站设置里改。
默认与限制
项目设置里若把外链、下载、表单、404 或错误关掉，采集端会丢掉对应事件，即使脚本发了出来。站内搜索不是单独事件，而是写在那次页面浏览上的搜索词。
示例
<script async src="https://YOUR_ORIGIN/w.js" data-site="YOUR_SITE_KEY" data-forms="true"></script>404 页再加 data-404="true"。不要在普通页面上加这个属性。
错误
下载只认扩展名，动态下载地址不会记成下载。性能在没有得到任何指标时不发送。搜索参数写错就只会剩下来源，不会有搜索词。