创建仪表盘
创建新的团队或项目仪表盘、整理散落的图表、构建高管报告，或设置定期复盘仪表盘。
使用说明
第0步：需求发现（如果不熟悉该功能）
在构建之前，先了解你要追踪的内容：
- 搜索与主题相关的现有仪表盘/图表
- 搜索相关事件：
Amplitude:search，entityTypes 参数设置为 ["EVENT", "CUSTOM_EVENT"] - 使用
get_event_properties了解可用的细分属性 - 向用户确认主要目标、关键细分群体或时间范围
第1步：定义仪表盘目标
明确：
- 目标受众是谁？
- 它将支持哪些决策？
- 多久复盘一次？
- 叙事结构是怎样的？
第2步：收集或创建图表
如果找到的现有图表超过5个：
- 使用
Amplitude:search查找相关现有图表 - 使用
Amplitude:get_charts获取它们的定义 - 识别需要新图表的缺口
如果找到的现有图表不足5个：
- 切换到“从零开始构建”模式
- 使用
Amplitude:query_dataset创建所需图表 - 在构建仪表盘前，使用
Amplitude:save_chart_edits保存所有图表 - 考虑先使用 entityTypes: ["EVENT", "CUSTOM_EVENT"] 搜索相关事件
创建新图表：
- 用
query_dataset进行原型验证数据 - 使用
save_chart_edits批量保存（更高效） - 在创建仪表盘前收集所有图表 ID
第3步：规划布局
按逻辑分区组织：
- 摘要行：关键指标一目了然（总览视图）
- 趋势部分：分析变化趋势
- 细分部分：分析细分群体与维度
- 详细部分：辅助分析
第4步：创建仪表盘
使用 Amplitude:create_dashboard 并设置：
- 清晰描述性的名称
- 行高设置适当（375、500、625 或 750px）
- 图表尺寸合适（3-12 列）
- 分区使用富文本标题
- 在 chartMetas 中配置图表显示：
metric_only：摘要 KPI（单一数字）series：趋势线（默认视图）converted：漏斗（转化视图）table：数据表
第5步：添加上下文说明
包含富文本块：
- 仪表盘目的与受众
- 如何解读关键指标
- 相关资源链接
- 最后更新时间或复盘日程
布局指南
| 内容类型 | 建议宽度 | 建议高度 |
|---|---|---|
| 摘要指标 | 3-4 列 | 375px |
| 趋势图 | 6-12 列 | 500px |
| 对比图 | 6 列 | 500px |
| 详细数据表 | 12 列 | 625px |
| 分区标题 | 12 列 | 375px |
最佳实践
- 将最重要的指标放在首屏上方
- 同一行内使用一致的图表尺寸
- 将相关指标分组在一起
- 为复杂指标添加说明文字
- 如果存在多个合理方向，可向用户询问重点关注领域
- 批量创建图表以最小化工具调用次数
常见问题
查询错误（500/400）：
- 简化：去除复杂 groupBy，缩小日期范围，避免嵌套属性
- 先使用搜索验证事件/属性是否存在
- 对于 Top N 列表，使用 eventsSegmentation 配合 groupBy 代替 dataTableV2
无数据返回：
- 检查事件名称是否完全匹配（区分大小写）
- 确认日期范围覆盖了事件被追踪的期间
- 确认用户细分条件不限制过严