TapCub 正式上线:统计、分析、客服一个平台免费用
术语表

什么是网页信标?像素信标与 Beacon API 的区别

网页信标是网页或邮件发出的一个很小的、看不见的请求,让服务器记下一次加载。像素信标和 Beacon API 的区别、一次信标能带多少数据,以及信标会在哪里丢。

陈屿 审核人 伊森·布鲁克斯 又称 像素标签 最后更新 2026 年 11 月 17 日 术语表

一句话回答

网页信标是网页或邮件向服务器发出的一个很小的、看不见的请求,让服务器记下这段内容被加载过。它通常是一个 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 请求,所以服务器知道的,只是任何请求都会透露的内容,不会更多:

  1. 页面或脚本触发请求。 一个 <img> 标签指向 https://collector.example/b.gif?page=/pricing,或者 JavaScript 调用 navigator.sendBeacon("https://collector.example/b", data)。
  2. 浏览器把它发出去。 除了地址或请求体,请求还带着常规请求头:用户代理、来源页,如果对方之前设置过 Cookie,还有 Cookie。
  3. 服务器记录下来。 常见字段是时间、IP 地址(不少系统会截断或丢弃)、用户代理,以及发送方放进去的参数。
  4. 服务器回一个无关紧要的响应,比如一张图片,或者一个空的 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 吗
全部留到最后一起发400400 × 280 = 112,000 字节 = 109.4 KiB放不进:调用返回 false,400 个事件全部丢失
每 50 个事件先发一次,剩下的在隐藏时发最多 4949 × 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 脚本,想确认数据真的离开了浏览器,包括一次访问的最后几秒。

  1. 先知道脚本发什么。 每次浏览量是一个发往采集地址的请求(脚本所在域名加 /api/v1/pulse),优先用 navigator.sendBeacon,回退到带 keepalive、不带凭证的 fetch。一次页面加载的第一个浏览量用的是能读取响应的 fetch,因为响应里带着站点配置,决定要不要加载客服或身份脚本。
  2. 知道停留时长什么时候发。 路由切换、标签页隐藏或页面关闭时,如果页面已经打开超过 1 秒,脚本会发一个 __leave 事件,带上以毫秒计的时长。
  3. 在 网站统计 › 实时 里确认到达。 打开你的网站,几秒内你的浏览量应该出现在真人动态里。采集端对存储的和丢弃的都返回 202,所以只看状态码判断不了。
  4. 如果实时页一直是空的, 打开浏览器的网络面板。没有发往采集域名的 POST,说明被浏览器或拦截器拦下了。请在 connect-src 里放行脚本域名和采集域名(不用客服时,美洲区域是 static.pathclue.com 和 api.pathclue.com)。TapCub 不会绕过拦截器或 Do Not Track。
  5. 记住浏览器里没有队列。 网站脚本不会重试,没来得及在页面关闭前发出的那一条就没了。脚本本身既不写 Cookie,也不写本地存储。

资料来源

这个解释清楚吗?

我们会根据反馈修改和补充这篇内容。

陈屿

技术工程师

专注统计代码、SDK 与接口集成文档,从接入验证到问题排查,帮助开发者更顺畅地完成实施。

常见问题

常见追问

大家看完定义后最常问的几个问题。

还有其他问题?

直接和 TapCub 团队聊聊——工作日通常几小时内回复。

网页信标和追踪像素有什么区别?

通常没有区别。两个名字指的都是一个很小的、看不见的图片,服务器会记录它的加载。「网页信标」有时也泛指任何看不见的追踪请求,包括用浏览器 Beacon API 发出的。

网页信标和 Cookie 是一回事吗?

不是。Cookie 是存在浏览器里的数据,信标是一个请求。信标常和 Cookie 搭配,让服务器认出回访的人,但信标不带任何 Cookie 也能发。

navigator.sendBeacon 能保证送达吗?

不能。浏览器把数据排进队列就返回 true,数据超出限制则返回 false。排队的数据合计最多 64 KiB,拦截器或内容安全策略也可能在请求离开之前就把它拦下。

网页信标和蓝牙信标是一回事吗?

不是。蓝牙信标是向附近手机广播信号的小型无线发射器;网页信标是网页或邮件发出的 HTTP 请求。

在你自己的网站上看这个数字

加一行脚本就能开始,网站和 App 都能接,几分钟内就能看到第一批报表。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie