一句话回答
网页信标是网页或邮件向服务器发出的一个很小的、看不见的请求,让服务器记下这段内容被加载过。它通常是一个 1 像素的图片;浏览器的 Beacon API(navigator.sendBeacon)则为页面关闭时发送的数据做同样的事。
公式: 一次信标能带的事件数 = 65,536 字节 ÷ 每个事件的字节数
什么是网页信标?
网页信标(web beacon)是网页或邮件向服务器发出的一个很小的、看不见的请求,让服务器记下「这段内容被加载过」。经典形式是一个 1 像素的透明图片,也叫像素标签、网页臭虫(web bug)或透明 GIF。图片一加载,服务器就收到请求,可以记录时间、IP 地址、浏览器类型,以及它之前设置过的 Cookie。屏幕上什么都看不到。
这个词在网页开发里还有第二层意思:浏览器提供的 Beacon API,即 navigator.sendBeacon(),它发出一个单向请求,页面正在关闭时也能继续发送。本文两种都讲,因为如今的统计代码大多用第二种去做第一种最早在做的事。
有一种意思本文不讲:蓝牙信标,也就是商场、博物馆里用来向手机广播位置的小型无线发射器。搜「what is beacon」,排在前面的基本是它;搜「what is a web beacon」,结果讲的才是本文这种追踪技术。
人们说的「信标」其实是两样东西
| 像素型网页信标 | Beacon API(navigator.sendBeacon) | |
|---|---|---|
| 是什么 | 页面或邮件让浏览器加载的一个看不见的图片(或极小的脚本) | 浏览器函数,把一个 POST 请求排进发送队列 |
| 在哪里运行 | 网页和 HTML 邮件 | 只在网页里,用 JavaScript 调用 |
| 数据怎么带 | 放在图片地址的查询字符串里,再加上浏览器自动附带的 Cookie | 放在请求体里(字符串、Blob、表单数据) |
| 大小限制 | 取决于地址长度能放多少 | 排队中的数据合计 64 KiB |
| 响应 | 服务器返回一张图片,页面可以不理会 | 读不到任何响应,只返回 true 或 false |
| 典型用途 | 邮件打开、广告转化、较老的统计标签 | 页面停留时长、最后一刻的统计事件 |
像素这一类,包括邮件打开和广告转化像素,见追踪像素。本文后面主要讲右边那一列,因为最后几秒的数据能不能送到,取决于它。
服务器到底收到什么
信标就是普通的 HTTP 请求,所以服务器知道的,只是任何请求都会透露的内容,不会更多:
- 页面或脚本触发请求。 一个
<img>标签指向https://collector.example/b.gif?page=/pricing,或者 JavaScript 调用navigator.sendBeacon("https://collector.example/b", data)。 - 浏览器把它发出去。 除了地址或请求体,请求还带着常规请求头:用户代理、来源页,如果对方之前设置过 Cookie,还有 Cookie。
- 服务器记录下来。 常见字段是时间、IP 地址(不少系统会截断或丢弃)、用户代理,以及发送方放进去的参数。
- 服务器回一个无关紧要的响应,比如一张图片,或者一个空的
202、204。访客什么也看不到。
信标只能上报发送方愿意放进地址或请求体里的内容,加上浏览器自动附带的东西,它读不到页面本身。能不能认出回访的人,取决于有没有 Cookie 或别的标识跟着一起发,所以信标常和 Cookie 搭配。邮件里的信标完全不需要 Cookie,这也让它更难拦。
为什么最后一刻的数据要用 Beacon API
统计里最难的时刻是访问的结尾:标签页关闭、用户点了链接、手机切到别的应用。有 Beacon API 之前,页面想办法把浏览器「拖住」,好把数据发出去:同步的 XMLHttpRequest、临时创建的图片、什么也不做的空循环。MDN 指出,这些做法都会阻塞页面卸载,拖慢下一次跳转。
sendBeacon 把请求交给浏览器,让它在合适的时候发送,不拖慢页面。规范和 MDN 给出三条规则:
true表示已排队,不是已送达。 浏览器接受了这份数据就返回true,它没法告诉你服务器收到没有。- 载荷要小。 排队的数据合计不能超过 64 KiB(65,536 字节)。数据超过浏览器的限制时,调用返回
false,什么也不会发出。 - 在
visibilitychange上发,不要在unload上发。 MDN 说最可靠的时机是页面变为隐藏的时候。unload事件不可靠,在手机上尤其如此,而且与浏览器的前进 / 后退缓存不兼容;pagehide也有同样的可靠性问题。
需要读取响应、或要控制请求头时,带 keepalive: true 的 fetch() 也能让请求在页面关闭后继续,它的请求体同样限制在 64 KiB。
信标要多大:一个算例
示例数据:某页面把统计事件先存在内存里,标签页隐藏时统一发送,每个事件序列化后约 280 字节。
| 做法 | 页面隐藏时缓冲区里的事件数 | 载荷 | 放得进 64 KiB 吗 |
|---|---|---|---|
| 全部留到最后一起发 | 400 | 400 × 280 = 112,000 字节 = 109.4 KiB | 放不进:调用返回 false,400 个事件全部丢失 |
| 每 50 个事件先发一次,剩下的在隐藏时发 | 最多 49 | 49 × 280 = 13,720 字节 = 13.4 KiB | 放得进,余量 4.8 倍(65,536 ÷ 13,720) |
64 KiB 的预算只能装下 234 个这样的事件(65,536 ÷ 280 = 234.06),所以事件超过 234 个的访问,没法用一次信标发完。办法不是做更聪明的信标,而是更早发:访问过程中就发,只把一小段尾巴留给离开的时刻。
信标会在哪里丢
没有离开浏览器的信标,在服务器上不会留下任何痕迹,所以故障看起来是数据缺了,而不是报错。
| 原因 | 发生什么 | 怎么判断 |
|---|---|---|
| 内容拦截器拦掉了采集域名 | 请求根本没发出,实时页永远看不到这次访问 | 网络面板里没有发往采集域名的请求 |
内容安全策略的 connect-src 没放行采集域名 | sendBeacon 和 fetch 都失败,页面也不报错 | 同样是网络面板里没有请求,浏览器控制台里可能有违反策略的提示 |
| 开启了 Do Not Track 或 Global Privacy Control | 遵守它们的脚本完全不发送 | 脚本在发送之前就返回了 |
| 请求发出前页面已经关闭 | 发送方没有队列的话,没人会重发 | 缺口集中在离开的时刻,比如停留时长 |
拦截器对像素类同样有效:Wikipedia 列出了关闭图片加载、使用纯文本邮件客户端、安装浏览器扩展这几种用户屏蔽方式。拦截器对统计整体的影响见广告拦截器。
常见误区
- 把
true当成已送达的证据。 它只说明浏览器把请求排进了队列。要在服务端或实时报表里核对是否到达。 - 全部留到页面卸载时再发。 越早发,因离开时没触发任何事件而丢的就越少。
- 把个人信息放进像素的地址里。 地址会出现在服务器日志、代理和浏览器历史里。只在需要时才发标识,邮箱和姓名不要放进查询字符串。
- 以为信标必须有 Cookie。 不需要。脚本可以既不写 Cookie、也不用本地存储来发信标;它失去的只是靠 Cookie 认出回访者的能力。见第一方 Cookie。
- 把 200、202 或 204 读成「已存储」。 服务器可以收下请求却丢掉事件,成功状态码说明不了留下了什么。
在 TapCub 里检查信标
假设你装好了 TapCub 脚本,想确认数据真的离开了浏览器,包括一次访问的最后几秒。
- 先知道脚本发什么。 每次浏览量是一个发往采集地址的请求(脚本所在域名加
/api/v1/pulse),优先用navigator.sendBeacon,回退到带keepalive、不带凭证的fetch。一次页面加载的第一个浏览量用的是能读取响应的fetch,因为响应里带着站点配置,决定要不要加载客服或身份脚本。 - 知道停留时长什么时候发。 路由切换、标签页隐藏或页面关闭时,如果页面已经打开超过 1 秒,脚本会发一个
__leave事件,带上以毫秒计的时长。 - 在 网站统计 › 实时 里确认到达。 打开你的网站,几秒内你的浏览量应该出现在真人动态里。采集端对存储的和丢弃的都返回
202,所以只看状态码判断不了。 - 如果实时页一直是空的, 打开浏览器的网络面板。没有发往采集域名的 POST,说明被浏览器或拦截器拦下了。请在
connect-src里放行脚本域名和采集域名(不用客服时,美洲区域是static.pathclue.com和api.pathclue.com)。TapCub 不会绕过拦截器或 Do Not Track。 - 记住浏览器里没有队列。 网站脚本不会重试,没来得及在页面关闭前发出的那一条就没了。脚本本身既不写 Cookie,也不写本地存储。
资料来源
- MDN Web Docs,Navigator: sendBeacon() method。
- W3C,Beacon(候选推荐草案,2022 年 8 月 3 日)。
- MDN Web Docs,RequestInit: keepalive property。
- Wikipedia,Web beacon。
这个解释清楚吗?
我们会根据反馈修改和补充这篇内容。
提交没有成功,请稍后再试。
谢谢你的反馈,我们会据此改进这篇内容。你已经反馈过这篇了,谢谢。
