客戶（Customer）資料模型與 LTV

【這篇解決什麼問題】

你想清楚理解客戶資料在帳獸中的角色、欄位意義，以及 LTV 的計算方式。

【客戶在帳獸中的角色】

客戶代表實際下單與付款的消費者，是訂單、訂閱與客戶價值分析的核心。

【重要欄位】

• email：必填，且在同一商家下必須唯一
• name：客戶名稱
• phone：電話（選填）
• metadata：可放自定義 JSON 擴充資料
• first_payment_at：首次付款時間
• last_payment_at：最近付款時間

【LTV 計算方式】

LTV（客戶終身價值）採即時計算：

• 所有已付款訂單總額
• 減去退款訂單總額

【常見問題】

Q1：客戶一定要手動建立嗎？

不一定。系統可從訂單資料自動提取客戶，也支援你先透過 API 主動建立。

Q2：不同商家會看到彼此客戶嗎？

不會。資料會套用商家隔離（MerchantScope），確保多租戶隔離。

【下一步】

• 搭配閱讀「訂單狀態流程與來源」了解客戶與訂單關係
• 若你要批次導入，請看「資料匯入完整流程」