渠道来源追踪场景

背景

在多渠道推广直播间的场景下，商家往往需要了解：用户到底是从哪个渠道进入直播间的？不同渠道带来的用户后续购买转化如何？

然而，直播间本身并不感知用户的来源渠道，导致下游系统（如电商、CRM）无法区分用户来源，难以评估各渠道投放效果。

业务场景

在直播间入口 URL 中追加来源标识参数 tpRef，系统会在用户后续的各类跳转链路中自动携带该标识，实现渠道来源的全链路追踪。

典型场景： 商家同时在公众号推文、社群、短信三个渠道投放了同一直播间链接——

投放渠道	直播间链接
公众号推文	https://live.example.com/Watch/123456?...&tpRef=wechat_article
社群	https://live.example.com/Watch/123456?...&tpRef=community_group
短信	https://live.example.com/Watch/123456?...&tpRef=sms_campaign

用户从不同渠道进入直播间后，后续在商品购买、微信分享等环节，系统会自动将对应的来源标识带到链接中，下游系统即可据此识别用户来源。

接入方式

在直播间入口 URL 末尾追加 tpRef 参数即可，无需任何额外配置。

格式：

https://your-domain.com/Watch/{room_id}?原有参数&tpRef=你的来源标识

注意： 来源标识如包含中文、特殊字符或 JSON 等，请在拼接 URL 时自行进行 URL 编码（encodeURIComponent），避免乱码或解析异常。

透传覆盖场景

系统会自动将来源标识携带到以下场景的链接中：

场景	透传效果
商品购买	用户点击商品"立即购买"跳转的外链会带上来源标识
微信分享	用户通过微信分享直播间时，分享链接会带上来源标识
生成链接	点击"生成链接"复制的直播间链接会带上来源标识
保存二维码	生成的直播间二维码内容链接会带上来源标识

也就是说，无论用户是直接进入直播间，还是通过分享、二维码等方式二次进入，来源标识都会一直跟随。

参数规范

项目	说明
参数名	固定为 tpRef（大小写敏感，必须小写）
参数值	任意字符串，建议控制在 200 字符以内
编码	含中文、特殊字符、JSON 时请自行 URL 编码，系统透传时不做二次编码
是否必填	否，不加时所有功能正常使用，完全不影响

注意事项

1. 这个参数是可选的，不加的话所有功能正常使用，不会有任何影响。
2. 参数名 tpRef 必须小写，写成 tpref、TpRef 等都无法识别。
3. 如果只传了空值（&tpRef=），系统不会将其追加到下游链接中。
4. 如需同时透传多个自定义参数，请联系平台开发团队评估扩展支持。