> ## Documentation Index
> Fetch the complete documentation index at: https://developers.zangsho.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SaaS 指標

> 帳獸支援的 20 項 SaaS 核心指標，含計算方式與分析頁面說明

## 概覽

帳獸提供 **20 項 SaaS 核心指標**，幫助你全面了解訂閱業務的健康狀況。這些指標分為四大類別，並在後台提供五個專屬的分析子頁面。

<Note>
  SaaS 指標模組需要先在**商家設定**中啟用。啟用後，系統會每日凌晨 06:00 自動計算指標並快取，同時支援當日增量更新。
</Note>

## 指標分類

### 客戶指標（7 項）

| 指標                      | 說明                         |
| ----------------------- | -------------------------- |
| **Active Customers**    | 在有效訂閱期間內、狀態為 `active` 的客戶數 |
| **New Customers**       | 期間內首次訂閱的客戶數                |
| **Churned Customers**   | 期間內取消訂閱的客戶數                |
| **Net Customer Growth** | 新客戶 − 流失客戶 = 淨增長           |
| **Reactivations**       | 期間內重新啟用訂閱的客戶數              |
| **Customer Churn Rate** | 流失客戶數 ÷ 期初活躍客戶數 × 100%     |
| **LTV**                 | 客戶終身價值：已付款訂單總額 − 退款總額      |

### 營收指標（9 項）

| 指標                     | 說明                                |
| ---------------------- | --------------------------------- |
| **MRR**（月經常性收入）        | 所有活躍訂閱的月度正規化營收加總                  |
| **ARR**（年經常性收入）        | MRR × 12                          |
| **ARPU**（每用戶平均收入）      | MRR ÷ Active Customers            |
| **MRR Growth Rate**    | (本月 MRR − 上月 MRR) ÷ 上月 MRR × 100% |
| **New MRR**            | 來自新客戶的 MRR                        |
| **Expansion MRR**      | 來自升級的 MRR 增加量                     |
| **Contraction MRR**    | 來自降級的 MRR 減少量                     |
| **Churned MRR**        | 因客戶流失而損失的 MRR                     |
| **Revenue Churn Rate** | Churned MRR ÷ 期初 MRR × 100%       |

### 進階指標（2 項）

| 指標              | 說明                                                           |
| --------------- | ------------------------------------------------------------ |
| **Quick Ratio** | (New MRR + Expansion MRR) ÷ (Churned MRR + Contraction MRR)  |
| **NRR**（淨營收留存率） | (期初 MRR + Expansion − Contraction − Churned) ÷ 期初 MRR × 100% |

<Tip>
  **Quick Ratio** 是衡量成長效率的關鍵指標。一般認為 Quick Ratio > 4 代表良好的成長動能。如果 Quick Ratio \< 1，代表流失速度超過新增速度。
</Tip>

### 風險指標（2 項）

| 指標                 | 說明             |
| ------------------ | -------------- |
| **Failed Charges** | 期間內付款失敗的訂單數與金額 |
| **Refunds**        | 期間內退款的訂單數與金額   |

## MRR 正規化

不同訂閱週期的金額會被正規化為月度金額：

| 訂閱週期 | 正規化方式   | 範例                    |
| ---- | ------- | --------------------- |
| 月繳   | 金額 ÷ 1  | NT$990 → MRR NT$990   |
| 季繳   | 金額 ÷ 3  | NT$2,490 → MRR NT$830 |
| 半年繳  | 金額 ÷ 6  | NT$4,800 → MRR NT$800 |
| 年繳   | 金額 ÷ 12 | NT$9,600 → MRR NT$800 |

## 分析子頁面

帳獸後台提供五個 SaaS 分析子頁面，可透過頁面內的子導覽切換：

### 總覽

所有核心指標的卡片一覽，加上 MRR 趨勢圖，讓你快速掌握全局。

### MRR 分析

深入分析 MRR 的組成與變動：

* MRR 核心指標卡片（當月 MRR、成長率、ARR、Net MRR）
* MRR Breakdown 卡片（New / Expansion / Contraction / Churned MRR）
* MRR 趨勢圖
* MRR Breakdown 趨勢圖（堆疊面積圖）
* MRR 瀑布圖（視覺化營收變動來源）
* 訂閱週期分佈圓餅圖
* MRR 變動明細表
* MRR 貢獻排行 Top 10

### Churn 分析

專注於客戶與營收流失的分析：

* Customer Churn Rate 與 Revenue Churn Rate
* Churn 趨勢雙線圖
* 流失客戶列表
* Quick Ratio 與 NRR 進階指標及趨勢圖

### 客戶分析

了解客戶的流動與價值分佈：

* 客戶流動統計（活躍 / 新增 / 流失 / 淨增長）
* 客戶價值統計（ARPU / LTV / 重新啟用 / 客戶流失率）
* 客戶流動趨勢圖（堆疊柱狀圖，含 Reactivations）
* LTV 詳細資訊
* Reactivation 詳細資訊
* 客戶價值分佈表格（含 80/20 分析）

### 付款風險

監控付款健康度，預防營收損失：

* 付款失敗統計
* 退款統計
* 風險趨勢圖（含 5% 警戒線）
* 付款失敗明細表
* 退款明細表
* 建議行動

## 啟用 SaaS 指標模組

<Steps>
  <Step title="進入商家設定">
    登入後台，前往側邊欄的**商家設定**頁面。
  </Step>

  <Step title="啟用模組">
    找到 **SaaS 指標模組** 開關，將其切換為啟用狀態。
  </Step>

  <Step title="設定預設訂閱週期">
    選擇你的商家預設訂閱週期（月繳、季繳、半年繳或年繳）。當訂單未指定 `billing_cycle` 時，系統會使用此預設值。
  </Step>

  <Step title="等待資料計算">
    啟用後，系統會在下一個凌晨 06:00 自動計算歷史指標。你也可以立即在分析頁面查看當日的增量資料。
  </Step>
</Steps>

## 訂閱週期自動偵測

如果你整合了藍新金流，帳獸可以從藍新的商品描述（ItemDesc）自動判斷訂閱週期。系統會根據關鍵字對照表來偵測：

* 包含「月」→ `monthly`
* 包含「季」→ `quarterly`
* 包含「半年」→ `semi-annual`
* 包含「年」→ `yearly`

你可以在**商家設定**中自訂關鍵字對照規則。

## 下一步

<CardGroup cols={2}>
  <Card title="儀表板指南" icon="gauge" href="/guides/dashboard">
    了解如何在後台閱讀和操作分析頁面。
  </Card>

  <Card title="訂閱" icon="repeat" href="/concepts/subscriptions">
    深入了解訂閱的狀態管理與事件追蹤。
  </Card>
</CardGroup>