控制台的平台列表比已发布的包更长。百度、快手、QQ 可以出现在平台字段里,但 @webcount/miniprogram 没有对应入口,不要引用不存在的子路径。
三个入口
| 平台 | 入口 | 上报平台值 |
|---|---|---|
| 微信 | @webcount/miniprogram/wx | mp_weixin |
| 支付宝 | @webcount/miniprogram/my | mp_alipay |
| 抖音 | @webcount/miniprogram/tt | mp_bytedance |
包名里的 webcount 是历史标识,产品名是 TapCub。安装命令以控制台「SDK 代码」页为准,见 SDK 总览与支持矩阵。支付宝和抖音的全局对象不同,但初始化参数(站点标识、收数地址、应用标识)一致。不要把微信的入口文件拷到另外两端,导入路径必须换成对应入口。
对齐过的行为
三端都是先 preInit(不联网),再在不要求同意或用户已经同意之后 init。国内模式必须等同意后再 init,见 接入前的隐私选择。
启动和切回前台时的场景编号写成 $scene,报表用它做场景值分析。分享回调归一成 $share_distinct_id,所以回流表不按各端原始参数名拆开。点击全埋点默认关闭。
三端共用一套脚本核心:本地队列、失败重试和远程配置都生效。这和 Android、iOS 当前版本不同,后者不读远程配置。uni-app 打到这三个平台时走这个包,打到 H5 时改用网站脚本,见 跨平台框架。
接入注意
- 应用标识填各平台的小程序 appid,须先在「SDK 代码」里登记,否则上报会被拒收。
- 收数地址必须是该小程序允许发起网络请求的域名,否则事件送不出去。
- 用户资料接口以各平台当前规则为准,SDK 不会绕过授权替你取头像或手机号。
- 用户标识可以用登录后的开放标识;匿名访客不会因此出现在用户档案里。