# uni统计2.0 - 内容统计
内容统计是 uni统计 的特色能力之一，面向内容详情页的访问分析：同一页面路由下，通过 URL 参数区分不同内容，统计各自的访问次数、分享次数等指标。
适用场景举例：
- 资讯类：新闻详情页，了解哪些文章阅读量、分享量更高
- 电商类：商品详情页，了解哪些商品更受关注
- 社区类：帖子详情页，了解哪些话题讨论度最高
使用前请确认项目已开启 uni统计，公有版参见 uni统计2.0，私有版参见 uni统计2.0（私有版）。
重要
内容统计依赖 页面规则 识别有效内容 URL。未配置页面规则时，详情页不会出现在内容统计报表中。请先完成 页面规则配置，再查看报表。
# 名词说明
| 名词 | 说明 |
|---|---|
| 页面 | 不同 URL 表示不同页面，如 pages.json → pages 中的每一项都表示一个不同页面 |
| 内容页 | 相同 URL、不同参数值表示不同内容，如 id=1 与 id=2 的两条新闻 |
| 内容名称 | 便于在报表中识别的展示名称，如商品名、新闻标题，可通过标题采集或手动上报 |
# 工作原理
内容统计根据页面 URL 中的参数对访问进行分组：
- 资讯 App：同一新闻详情页路由，不同
id计为不同内容 - 商城 App：同一商品详情页路由，不同商品
id计为不同内容
若详情页使用 pages.json 配置的原生导航栏，且导航标题即为内容标题，一般可直接在报表中查看。若使用自定义导航栏，或标题写在页面正文区域，请参考下文 页面标题采集 上报正确标题。
# 页面规则
# 什么是页面规则
页面规则用于生成内容统计所用的 URL：通过指定有效参数，用带参数的 URL 唯一标识一条内容。
例如需统计 pages/forum/detail/detail 详情页，页面依赖跳转时携带的参数加载数据。完整 URL 示例：
pages/forum/detail/detail?id=1&type=2&title=搜索内容
其中 id、type、title 三个参数里，只有 id 和 type 用于区分内容（如发起请求拉取数据），则页面规则应配置为 id 与 type，二者共同决定「是否为同一条内容」。
# 规则匹配逻辑
- URL 包含规则中的全部参数，且参数值相同 → 视为同一内容页
- URL 包含规则中的全部参数，但参数值不同 → 视为新的内容页
- URL 不包含规则中的任一参数 → 不会出现在内容统计中
# 配置页面规则
公有版（统计控制台）：
- 登录控制台，进入 内容统计 → 页面规则
- 选择目标页面，点击 编辑规则
- 点击 添加参数，加入用于区分内容的参数（如
id、type） - 保存规则
私有版（uni-admin）：
在 uni-admin 的 uni 统计 → 页面规则 中配置，逻辑与公有版一致。私有版内容统计默认关闭，需在 uni-config-center/uni-stat/config.json 中将 pageDetailStat 设为 true 后才会跑批统计，详见 私有版公共模块配置。
配置提示
- 每条规则可包含多个参数，单条规则内参数需同时匹配才生效
- 每个页面最多可配置 5 条规则；多条规则并存时，后添加的规则优先级更高
- 当前仅支持 URL 显式传递的键值对参数（如
?id=1&type=2），暂不支持隐式或复杂路由形式
# 页面标题采集
页面规则配置完成后，内容统计 菜单中会出现匹配到的内容页。为便于阅读报表，需正确采集内容名称（页面标题）。
# 自动采集
统计 SDK 会按以下来源自动采集标题：
pages.json中配置的原生导航栏标题uni.setNavigationBarTitle()uni.report('title', ...)（eventKey固定为title）
# 手动上报标题
使用自定义导航栏，或标题在接口返回后才确定时，可在拿到标题后调用：
// eventKey 必须为 title，param 为字符串
uni.report('title', '某商品名称')
也可使用内置统计能力的 uni-ui 组件（设置 stat: true），如 uni-title 会在渲染时自动上报内容标题。
# 标题显示优先级
多种来源同时存在时，报表按以下优先级展示标题：
后台手动修改的标题 > uni.report('title') > uni.setNavigationBarTitle > pages.json 原生导航栏标题
若自动采集的标题不符合业务需求，可在统计后台直接修改单条内容的展示标题。
# 查看报表
- 公有版：登录 统计控制台 → 内容统计
- 私有版：登录 uni-admin → uni 统计 → 内容统计
报表数据存在聚合延时，配置规则后通常需等待数十分钟再刷新查看。
# 常见问题
# 配置了页面规则，但看不到内容数据
请依次检查：
- 跳转详情页时，URL 是否携带了规则中配置的全部参数
- 参数是否为 URL 显式键值对形式（如
?id=1），而非仅保存在内存或storage中 - 是否已重新编译运行带统计 SDK 的版本，并等待足够聚合时间
- 私有版是否已将
pageDetailStat开启并完成跑批
# 报表中标题显示不正确
确认是否使用了自定义导航栏；若是，请在数据加载完成后调用 uni.setNavigationBarTitle() 或 uni.report('title', '标题')。参见上文 页面标题采集。
# 内容统计与页面统计有何区别
页面统计按页面路由汇总（如整个详情页的总访问量）；内容统计在同一详情页路由下，按 URL 参数拆分为多条内容分别统计，适合「一个模板页展示多种内容」的场景。
