SaaS指標計算機

MRRは subscribers に price を掛けた値、解約率は churned を subscribers で割った値、生涯価値は price をその解約率で割った値です。加入者数がゼロのときは invalid_input で失敗し課金されません。

三つの数字からMRR・解約率・顧客生涯価値が出る仕組み

月次経常収益は mrr として返り、subscribers に price を掛けたものです。解約率は churned を subscribers で割った値で、期間中に解約・期限切れ・離脱した基盤の割合です。計算機はその比を churn_rate（ゼロから一）と churn_rate_percent（ゼロから百）として返します。顧客生涯価値は price を月次解約率で割った値で、price に subscribers を掛けて churned で割るのと同じです。

入力契約、応答の形、エラー時の振る舞い

subscribers は期間の基準に使う顧客数です。ふつうは月初の有料顧客、または価値を見たい現在の有料帳簿で、ゼロより大きくなければなりません。price は加入者ひとりが払う月額で、帳簿が一つのプランなら ARPU とも呼ばれます。churned は期間中に去った顧客数です。解約率と生涯価値がゼロ除算になるためです。百パーセントを超える解約率は結果ではなくデータ誤りとして扱います。churned がゼロのとき解約率はゼロで、寿命欄は無限や null として印字せず省略します。送る解約に合う加入者スナップショット — 期首、期末、期間平均 — の規則は呼び出し側で決めてください。必須の有限数三つを含む JSON 本体を POST してください。別名 customers、customer_count、subscriber_count は同じ欄を指すので、表計算は列名を保てます。別名 arpu、monthly_price、price_per_subscriber を受け付けます。別名 churned_customers、cancelled、churn_count を受け付けます。各数値欄は JSON の数でも数値文字列でも構いません。欠落、空文字、非有限値 — NaN、Infinity、数として読めない文字列 — は欄名付きの invalid_input で失敗します。これらの失敗は課金されません。加入者数がゼロまたは負でも invalid_input になります。負の price と負の churned は拒否されます。churned は subscribers を超えられません。成功時、本体は subscribers、price、churned をエコーし、mrr を subscribers に price を掛け half-up で小数第二位、arr をその月次額に十二を掛けた値、churn_rate を churned を subscribers で割り half-up で小数第八位、churn_rate_percent をその比に百を掛け half-up で小数第六位、customer_lifetime_months を subscribers を churned で割り half-up で小数第四位、customer_lifetime_value を price に subscribers を掛け churned で割り half-up で小数第二位、さらに恒等式を述べる formula 文字列を返します。このエンドポイントは渡された二つの数を割るだけで、請求元帳を組み直さず、コホート規約も選びません。料金は成功した要求あたり定額の $0.002 です。

SaaS指標計算機が本領を発揮する場面

プロダクトチームは、課金エンジンを呼ばずに mrr、churn_rate_percent、customer_lifetime_value を固定しなければならないダッシュボード、CRM 出力、CI 固定具に契約を配線します。実装は純粋な parse のティア A なので、成功した呼び出しは公開された基本料金 $0.002 で、モデルトークンも外向きネットワークもありません。subscribers を正に保ち、churned をゼロ以上 subscribers 以下に保ち、price を非負に保ち、丸めた指標をテストに固定すれば、ティーザー、LMS プラグイン、エッジワーカー向けに再現可能な SaaS スナップショットが得られ、自前のサブスクリプション分析基盤を立てる必要はありません。