建立儀表板
建立新的團隊或專案儀表板、整理零散的圖表、建置主管報告，或設定定期回顧儀表板。
操作說明
步驟 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 欄）
- 區段的 Rich Text 標題
- 在 chartMetas 中設定圖表顯示方式：
metric_only：重點 KPI（單一數值）series：趨勢線（預設檢視）converted：漏斗圖（轉換檢視）table：資料表格
步驟 5：加入說明文字
包含 Rich Text 區塊來說明：
- 儀表板的目的與受眾
- 如何解讀關鍵指標
- 相關資源的連結
- 最後更新時間或檢視排程
版面指南
| 內容類型 | 建議寬度 | 建議高度 |
|---|---|---|
| 重點指標 | 3-4 欄 | 375px |
| 趨勢圖 | 6-12 欄 | 500px |
| 比較圖 | 6 欄 | 500px |
| 詳細表格 | 12 欄 | 625px |
| 區段標題 | 12 欄 | 375px |
最佳做法
- 將最重要的指標置於上方（頁面摺疊以上）
- 在同一行內保持圖表尺寸一致
- 將相關指標分組在一起
- 為複雜的指標加上說明文字
- 若有多種合理做法，詢問使用者關注的領域
- 批次建立圖表以減少工具呼叫次數
常見問題
查詢錯誤（500/400）：
- 簡化：移除複雜的 groupBy、縮短日期範圍、避免巢狀屬性
- 先使用搜尋功能驗證事件/屬性是否存在
- 使用搭配 groupBy 的 eventsSegmentation，而非使用 dataTableV2 來取得前 N 名清單
無資料回傳：
- 檢查事件名稱是否完全相符（區分大小寫）
- 確認日期範圍涵蓋事件被追蹤的時間
- 確認使用者分群條件不會過於嚴格