朋友发来一张卡片:「就差你一票,点一下补上」。你点了。小程序开在首页,那一票没了,还得从头把那个群找出来。没崩,按钮也好好的,是链接把该带的东西丢了。
这种毛病我们上线过不止一次,问题多半不在按钮。是把链接当成了地址,而它本该是一句话:打开这个、停在这个状态、给这个人、从这个地方来。被网页 URL 训练了这么多年,我们习惯把链接当位置。可在超级 App 里,一条不带上下文的链接几乎算不上链接——它只是一把开前门的钥匙。
链接是一句话,不是地址
每个入口在第一屏渲染之前,都会先递给你一小包上下文。有你能控制的部分——商品 id、群 id、活动标记、谁分享的;也有宿主自己的元数据,比如场景值,告诉你这次是从二维码贴纸、聊天会话,还是从桌面快捷方式进来的。微信管它叫场景值,支付宝有自己那套叫法,Telegram 机器人在首次 /start 时拿到一个 start 参数。名字不同,意思一样:宿主已经知道你是怎么来的,去读它,别猜。
实操上就一条:让分享带上状态。用户从商品页分享出去,卡片就该带着那个商品 id,把收的人直接落在那一屏,而不是甩到首页配一句「快看看」。活动导流进来,第一屏就该是活动许诺的那个东西。听着像废话,直到你真去查一个线上应用,发现一半卡片都指着根路径。
还有条教训是踩坑换来的:身份、价格、权限别放进参数。链接里的东西都是客户端给的。把 payload 当成「该往哪儿走」的提示,至于这个人到底能看什么,交给服务端定。
两条路,同一份参数
多数团队栽在这儿。入口不是一个,是两个,而且行为不一样。
冷启动——小程序本来没在跑——payload 交给启动生命周期,你读一次、定路由、渲染目标屏,没问题。但如果小程序已经开着、压在后台,一条新链接不会把它重启,而是唤醒。新 payload 走的是 onShow 那类回调,当前页不会重新加载;你要是没显式处理这个回调,人就停在十分钟前离开的那一屏上。这就是那种「点了没反应」的毛病,它不崩,所以测试很容易放过。
所以两头都得管:启动时解析并路由一次,每次回到前台再解析并路由一次。同一个小函数,两个调用点。漏了第二个,差不多一半深链会悄没声地什么都不做。
| 入口形态 | 携带什么 | 落到哪一屏 | 常见丢失点 |
|---|---|---|---|
| 聊天里转发的分享卡片 | 商品 id、群 id、谁分享的 | 那件商品或那个群,状态一并带上 | 卡片指向首页路径,上下文压根没离开发送方 |
| 带场景值的二维码 | 场景 id、活动、投放位 | 活动专属的第一屏 | 链接被复制到宿主外时,场景参数被剥掉 |
| 广告或短信链接 | 活动、素材、一小段 payload | 广告真正许诺的那个优惠 | 外部浏览器打不开宿主 scheme,点一下就到死胡同 |
| 推送或订阅消息 | 一个理由、一个目标屏 | 具体某一屏,不是消息列表 | 模板限额把自定义字段丢了,点开是个通用页 |
| 已经打开的小程序 | 唤醒时的一份新参数 | 唤醒时重新决定的新目标 | 没处理 onShow,旧页面就那么杵着 |
归因是在哪儿悄悄没的
接下来说实在的。先假定它一定会丢一部分。 payload 会被截断:长度上限、特殊字符、某个你没料到的编码环节、宿主转发时把链接重写了一遍。宿主对外部唤起也设了卡子。浏览器或短信里的链接往往得用特定 scheme,可能被拦、可能先弹一层确认才肯开;而给一家宿主生成的链接,在另一家根本打不开。我们当然想要一条通吃的 URL,但没有哪家宿主愿意,所以别照着这个设计。一家宿主做一个入口,其余留个朴素的网页兜底。
归因在任意一端都可能断。发的人改了 path。收的人把链接复制到别的群,场景 id 没跟过去。第二次打开把正准备记的冷启动参数覆盖了。有人把二维码截图发出去而不是扫。不管多小心,最后总会剩一桶「来源未知」,装作没有,只会养出一堆笃定但错误的看板。
还有安全这笔账。你要是图路由省事,信了查询串里的 user id 或者管理员标记,那就是白送一个越权漏洞。每次都在服务端校验。链接只负责告诉你落到哪儿,绝不该告诉你这个人是谁。
设计下一张分享卡片之前,先试一件事:打开小程序,把它压到后台,再从另一个会话点一条新链接。要是它落在旧屏上,你就找到了大多数团队都会带上线那个 bug。把唤醒那条路补上,payload 保持又短又无聊,敏感的东西一律服务端校验——至于有人把场景 id 粘进群里之后丢掉的那部分,是得学会共存的缺口,不是能补上的洞。
参考来源
- Android 开发者 — App Links — 平台怎么判定一条进来的链接该归哪个应用。
- 微信 — 小程序开发文档 — 场景值、启动参数,以及入口参数在哪儿能取到。
- Telegram — Bot API — 首次打开时随链接带过来的 start 参数。
- Apple 开发者 — 平台文档 — 宿主对外部唤起与通用链接的种种限制。