docs: 补充推广工具H5接入清单

This commit is contained in:
远周 2026-04-27 15:51:48 +08:00
parent fb52224d27
commit b0f6e4a371

View File

@ -725,6 +725,17 @@
> - 普通站内访问不带 `from=promotion`,不计入推广点击。
> - 同一访客多次访问会累计点击;唯一访客按 `txin_pv` 去重。
**H5 接入清单:**
1. 推广工具页加载时调用 `CREATOR-10A` 获取推广链接,优先使用 `shareLink.url``shortLink.shortUrl` 只作为兼容兜底。
2. 推广工具页的「复制链接」、快捷文案、二维码、海报导出均使用 `shareLink.url`,不要再硬编码 `txin.me` 或其它短链域名。
3. 推广工具页引流数据调用 `CREATOR-10B`,展示 `totalClicks`、`todayClicks`、`conversionRate`;不要继续从 `creator/dashboard` 推导推广统计。
4. H5 `/creator/{creatorId}` 若会重定向到 `/user/{creatorId}`,必须保留完整 query例如 `from=promotion&promo={username}&pv={visitorKey}&pc={clickId}`
5. H5 `/creator/{creatorId}``/user/{creatorId}` 页面检测到 `from=promotion` 时,调用 `CREATOR-10D` 记录点击,请求体建议为 `{"creatorId":"{creatorId}","source":"h5","promo":"{promo}"}`
6. 如果 URL 已携带 `pc`表示兼容短链入口已完成一次点击记录H5 应跳过 `CREATOR-10D`,避免同一次访问重复计数。
7. 推广分享链接进入创作者主页时,匿名用户应能直接浏览创作者主页;仅在关注、订阅、解锁、私信等需要登录的动作上再引导登录或注册。
8. 若 H5 API 请求与页面不同域,调用 `CREATOR-10D` 时需要携带凭证并确保后端允许凭证跨域,否则 `txin_pv` cookie 无法稳定写入或复用;同源代理场景无需额外处理。
---
#### CREATOR-12 移除粉丝