多端概览
网站、应用、小程序各有自己的统计壳,并排比较发生在全端分析。
菜单结构
全端分析的概览组里有两张跨端报表:
控制台全端分析概览平台并排| 菜单 | 何时出现 | 内容 |
|---|---|---|
| 多平台总览 | 网站、原生应用、小程序三类里至少两类有数据源 | 用归一后的人看各端,并列出变化最大的事件、屏幕和渠道 |
| 平台并排 | 始终在概览组 | 按平台列出用户、新增、会话、事件、时长和错误 |
只登记了 Android 和 iOS、没有网站也没有小程序时,算同一类应用,不会出现「多平台总览」。应用统计和小程序统计的菜单分别见 应用统计概览 和 小程序统计概览。
「多平台总览」强制按人归一,所以设备数可能高于人数,差额是同一人的多台设备。它只放各端都能比的指标,不放网页浏览量、跳出率、启动次数或版本。「平台并排」新增列的提示是「按首次出现的平台归属」。服务端单独上报时,会成为自己的平台行,不并进网站。
从哪开始
已有网站、还没接别的端:先读 网站 → 多端平滑迁移,原来的数据不用改。要接小程序,从 小程序统计概览 看菜单,再按 SDK 总览与支持矩阵 选包。订单、付费这类事实用服务端上报,见 服务端采集与融合。
名词
平台字段和「一个用户只在一个平台新增」见 平台与多端。
跨平台框架
事件名仍是 预置事件与属性 那一套,报表仍在应用统计或小程序统计里按实际运行的平台查看。
三个包
| 框架 | 包 | 实际依赖 |
|---|---|---|
| React Native | @webcount/react-native | 纯脚本转发,页面靠路由钩子产生 $screen_view |
| Flutter | webcount_flutter | 转到已接入的 iOS 或 Android 原生 SDK |
| uni-app | @webcount/uni-app | 小程序目标用小程序包,App 目标用应用核心,H5 用网站脚本 |
React Native 要求 react-native 不低于 0.72。Flutter 要求 Dart 3 和 Flutter 3.10 起,宿主工程还要接上对应的原生 SDK,见 Android 和 iOS。uni-app 的小程序目标只覆盖微信、支付宝、抖音,和 小程序平台差异 一致。
React Native 的页面事件只来自你传入的路由钩子,不会再从原生界面自动采一遍。Flutter 的页面来自导航观察者,其余能力等于它所调用的原生 SDK,不要按小程序那套去预期队列和远程配置。uni-app 选定核心之后,小程序端的场景值和分享字段与 小程序平台差异 一致。应用标识要登记在实际运行的系统或小程序上,桥本身没有单独的应用标识。
验证
打开对应壳的实时页,看到 $app_start 或 $mp_launch 即接入成功。套餐若不包含应用或小程序,上报会被丢弃,和框架种类无关,见 套餐与额度。
没有发布的包
没有电视、手表、桌面专用 SDK,也没有单独的游戏引擎包或 C++ 包。控制台接入向导里若出现这些名字,会标明仍是设计稿。报表收到别的平台值时会按该值归类,但这不代表已经有对应的安装包。
服务端采集与融合
服务端采集用来补上客户端看不到的事实:下单、退款、对账后的身份。这些事件的平台记为服务端,并排查看时是单独的平台行,见 多端概览。
怎么送
五种服务端 SDK 都是对 POST /api/v1/track 的薄封装,密钥要有写入权限。字段和限制见 服务端事件与日志导入 与 服务端事件。另一条日志式接口用于访问日志导入,不要和这条事件接口混用。
和客户端怎么合
| 字段 | 作用 | 不填时 |
|---|---|---|
insert_id | 幂等键,同键再送按先到的那条生效 | 每次都会新记一条 |
session_id | 放进已有会话 | 不进入会话表,会话类指标不算它 |
login_id | 绑到已登录的人 | 只有设备或匿名标识时对不上同一个人 |
同一笔事实如果客户端和服务端都报了,并用了同一个 insert_id,后到的会被丢掉;用了不同的键,两笔都会留下,报表不会自动合并。所以请在业务侧生成稳定的 insert_id(例如订单号),不要用随机数。
身份要能对上,客户端和服务端得使用同一个登录标识,规则见 访客、用户与身份归一。服务端事件没有会话标识时,不要用它解释人均时长或会话次数,见 会话。
限制
时间与服务器相差超过 72 小时的事件,会被改成接收时间。单次最多 1000 条,每个密钥每分钟有请求上限。带调试参数时只校验,不入库。营销归因的回传走另一个接收地址,写成 $app_install,不要和业务订单用同一个事件名。
从网站平滑迁移到多端
这个概念是什么
一个项目是一套身份和一张事件表。网站、应用、小程序、服务端都是这个项目上的数据源,用平台字段区分,而不是各建一个项目。见 账号、项目与数据源 和 平台与多端。
为什么可以不改网站
已经入库的网页事件保持原来的平台值。你不需要给旧数据补平台,也不需要更换站点标识。网站脚本、应用 SDK、小程序 SDK 可以同时开着。新端用自己的 SDK,在 控制台应用统计配置SDK 代码 或 控制台小程序统计配置SDK 代码 登记应用标识后开始上报。旧的网站报表仍在网站统计壳,数字不会因为多了一个应用壳而被挪走。
并排从什么时候出现
「多平台总览」要网站、原生应用、小程序这三类里至少两类有数据源。只增加了 Android 和 iOS、没有小程序,仍然算同一类应用,不会出现这张总览;「平台并排」则一直在。迁移当天,新壳的实时页会先看到启动事件。
新增用户只记在他第一次出现的平台上,所以旧的网站访客后来打开应用,不会被再计一次新增。同一个人要在并排里合成一行,需要登录标识或其他身份打通,只靠各自的设备号会显示成多个人,见 访客、用户与身份归一。
下一步
新端接好之后,订单、付费这类事实建议改由服务端上报,避免各端各记一份,见 服务端采集与融合。