# TapTap CLI Skill: 数据表现

查询应用「数据表现」页的全部运营指标，覆盖商店 / 游戏 / 销售 / 评价 / 社区五个数据域共 28 个指标。

- 网页版: /v3/cli/#skill-taptap-dashboard-stats
- Markdown: /v3/cli/skills/taptap-dashboard-stats.md

## 摘要

| Skill ID | 分组 | 类型 | 作用域 | 主要命令数 | 确认要求 |
| --- | --- | --- | --- | --- | --- |
| taptap-dashboard-stats | Operation | 只读数据 | App | 2 | 无 |

## 行为与边界

`dashboard-stats get-dashboard-stats` 每次查询一个指标，返回按日数据和汇总。可按需指定日期范围、平台、推荐位或评价类型。该命令只读，不导出、不修改数据。评价数据使用 `review`，可按评价类型查看不同类别。

## 能力摘要

- 商店：PV、下载、预约、排行、转化位、投放、REP。

- 游戏：启动按钮、免安装 / 云玩 / 小游戏细分流程。

- 销售：订单数 / 金额与商品维度明细。

- 评价：每日评价（6 类）。

- 社区：帖子、关注、收藏。

## 指标分组

| 领域 | 指标 | 筛选 |
| --- | --- | --- |
| 商店 | pv（商店页访问） download（下载） reserve（预约） rank（榜单） position（推荐位曝光） advertisement（广告） rep_effect（投放效果） rep_revenue（投放收益） | 平台筛选（下载 / 预约）、推荐位筛选（推荐位指标） |
| 游戏 | launcher_button（启动按钮） tapplay_download（TapPlay 下载） tapplay_install（TapPlay 安装） tapplay_conversion（TapPlay 转化） cloud_request（云玩请求） cloud_start（云玩启动） cloud_conversion（云玩转化） cloud_duration（云玩时长） mini_device（小游戏设备） mini_ret（小游戏留存） mini_conversion（小游戏转化） mini_duration（小游戏时长） | — |
| 销售 | order（订单数） order_fee（订单金额） product_order（商品订单数） product_order_fee（商品订单金额） | 平台筛选 |
| 评价 | review（每日评价数） | 评价类型筛选 1–6 |
| 社区 | topic（帖子） friendship（关注） favorite（收藏） | — |

## 你可以这样问

- 这个游戏最近的数据表现怎么样？

- 为什么这段时间的下载量、转化或评分发生了变化？

- 我想看看某个推荐位的效果，可以查到吗？

## 示例

```bash
taptap-cli skills read taptap-dashboard-stats
taptap-cli schema dashboard-stats get-dashboard-stats
taptap-cli dashboard-stats get-dashboard-stats --dev-id <developerId> --app-id <appId> \
  --data '{"metric":"download","start_date":"2026-06-01","end_date":"2026-06-30"}'
```

## 用户可见输出边界

输出业务口径、时间范围、汇总值、关键趋势、异常 / 无数据说明。指标名翻成中文业务口径，明确实际时间窗口。默认**不转述** metric key / 字段 key / `key_map` raw / tool payload / raw JSON / 上游 path / proto 字段结构。

## 主要命令

| 命令 | 类型 | 说明 | 输入 | 输出 | 注意事项 |
| --- | --- | --- | --- | --- | --- |
| dashboard-stats get-dashboard-stats | 只读 | 查询任一 metric 在指定日期范围内的按日序列 + 汇总 | metric; date range (optional); platform (optional); position (optional); review type (optional) | Daily data and summary | 一次查询一个指标；不同指标支持的筛选条件不同 |
| dashboard-stats get-dashboard-position-options | 只读 | 读取转化效果数据当前可用的推荐位 / 展示位选项 | 当前游戏上下文 | 合法 position 候选 | 查询指定推荐位前先读取，不能猜 position key |

## 相关能力

- 排行榜能力 — 排行榜 / 榜单 / 分数不属于经营数据指标。