像素
邮件打开、不能执行脚本的页面,用一张 1×1 的透明图上报一条事件。
用法
html
<img src="https://stats.example.com/sa.gif?key=evs_wk_xxx&data=eyJ0eXBlIjoidHJhY2siLCJldmVudCI6ImVtYWlsX29wZW4iLCJhbm9ueW1vdXNJZCI6Im1haWwtNDIiLCJtZXNzYWdlSWQiOiI4YjBlMmExYy0zZjRkLTRlNWEtOWI2Yy03ZDhlOWYwYTFiMmMiLCJjb250ZXh0Ijp7InBhZ2UiOnsicGF0aCI6Ii9uZXdzbGV0dGVyLzIwMjYtMDkifX19"
width="1" height="1" alt="">参数与 POST /sa 相同,见 HTTP 协议。像素常用这几个:
| 参数 | 说明 |
|---|---|
key | 写入密钥 |
data | 单条事件的 Base64。JSON 里带 messageId、anonymousId、event、context.page |
gzip | 1 时 data 是先 gzip 再 Base64 |
data 要做 URL 编码。每次发信换一个 messageId。
行为
GET /sa.gif无论成功失败都返回同一张 1×1 透明 GIF,不会在邮件里露出破图。- 密钥错误时同样返回 GIF,事件不入库;结果只能在接入检查里看到。
- 官方 SDK 不走像素,像素只给不能跑脚本的地方。
地址里含写入密钥
像素地址的查询参数里有写入密钥。它只能写不能读,但也不要把带密钥的地址贴到公开仓库、公开页面和截图里。
很多邮件客户端会拦截或预取图片,邮件打开数只能当参考。