ForHosting KIT · 開発者向けツール

顧客・売上チャーン率計算ツール

チャーン率計算ツールは、期首に存在した顧客または売上に対して、対象期間中に失われた割合を測定します。指標を選び、期首値と損失値を入力すると、チャーン率と維持率を小数とパーセントの両方で確認できます。サブスクリプションの月次確認、継続売上の報告、コホート分析、計算根拠を明確に保つ必要がある業務ダッシュボードなどに適しています。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

入力前に対象集団と期間を明確にします

有用なチャーン率を得るには、対象集団と集計期間を明確に定義する必要があります。失われたアカウント、契約者、会員、契約件数を測る場合は顧客を選択します。解約、下位プランへの変更、更新停止によって失われた継続売上を測る場合は売上を選択します。分母には、対象期間が始まった時点の値を使用してください。月次の顧客チャーンであれば、月内に一度でも存在した全顧客ではなく、月初時点で有効だった顧客が対象です。売上チャーンでは、月初の月次経常収益と同じ月に失われた経常収益など、定義と期間がそろった値を使用します。年間契約額と月間の売上損失を混在させてはいけません。この計算ツールは選択された指標を結果に表示しますが、元データ同士の定義が整合しているかまでは判断できません。期間の境界、通貨、顧客ステータスの基準、一時停止や支払い遅延の扱いを記録しておくと、将来の結果も正しく比較できます。一貫した定義があってこそ、単純な割合が信頼できる経営指標になります。

チャーン率と維持率の計算方法を確認します

チャーン率は、期間中の損失値を期首値で割って求めます。期首に800人の顧客がいて期間中に52人を失った場合、顧客チャーン率は52を800で割った6.5パーセントです。残存値は期首値から損失値を引いた値であり、維持率は1からチャーン率を引いた値です。そのため、この簡潔なモデルではチャーン率と維持率の合計が100パーセントになります。売上にも同じ計算を適用できます。期首の継続売上150,000のうち7,500を失った場合、グロス売上チャーン率は5パーセントです。利用先のシステムによって表現方法が異なるため、結果は小数とパーセントの両方で返されます。小数の0.05とパーセントの5は同じ比率です。精度の設定は表示上の丸めだけに影響し、計算自体は丸める前の入力値で行われます。期首値はゼロより大きい必要があり、損失値は期首値を超えられません。そうでなければ、この定義では無効または誤解を招く比率になります。新規顧客や拡張売上は分母にも損失の相殺にも含めません。

同じ基準でチャーン率を比較します

チャーン率は、期間が変わっても定義を一定に保ち、顧客チャーンと売上チャーンを区別することで有用性が高まります。小規模な顧客を複数失っても売上の大部分を維持できる場合があります。反対に、大口顧客を1社失っただけで、顧客チャーン率は低く見えても売上への影響が大きい場合があります。顧客規模に差がある事業では、両方の指標をご確認ください。また、集計間隔も明示してください。月次の割合と年次の割合は直接比較できません。維持率には複利的な効果があるため、月次率を12倍しても年次率の概算にしかなりません。全体値が重要な差を隠す場合は、プラン、コホート、地域、獲得経路ごとに分けて分析します。ただし、各区分の期首集団と損失は必ず対応させてください。このツールは損失だけに基づくグロスチャーンを計算します。拡張、縮小、再開などを含むネット売上維持率は計算しません。自発的または非自発的な離脱の判定や、休止中の顧客を損失とみなす判断も行いません。結果とともに定義と元の数値を保存すると、後から割合を検証できます。

活用例

契約者の月次レビュー

月初の契約者のうち、月内に解約または更新停止した割合を測定します。

継続売上レポート

期首の継続売上と、解約や下位プランへの変更で失われた売上からグロスチャーンを計算します。

コホートとプランの比較

同じ計算式を個別のコホートやプランに適用し、損失率を公平に比較します。

よくある質問

チャーン率の計算式は何ですか？

期間中の損失値を期首値で割り、100を掛けるとパーセントで表したチャーン率になります。

顧客チャーンと売上チャーンの両方を計算できますか？

はい。アカウント数なら顧客、金額なら売上を選択し、選んだ指標に対応する期首値と損失値を使用してください。

新規顧客を期首値に含めますか？

いいえ。分母は期間開始時点の対象集団です。期間中に獲得した顧客は期首値に含めません。

ネット売上維持率も計算できますか？

いいえ。損失だけからグロス売上チャーンを計算します。ネット売上維持率には拡張、縮小などの集計方針が必要です。

API での計算料金はいくらですか？

API の各リクエストは $0.002 です。同じ決定論的な計算をブラウザーで無料実行することもできます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/finance/churn-rate

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/finance/churn-rate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"metric_type":"customers","starting_amount":800,"lost_amount":52}'

const res = await fetch("https://api.kit.forhosting.com/finance/churn-rate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "metric_type": "customers",
    "starting_amount": 800,
    "lost_amount": 52
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/churn-rate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "metric_type": "customers",
    "starting_amount": 800,
    "lost_amount": 52
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/churn-rate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"metric_type":"customers","starting_amount":800,"lost_amount":52}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"metric_type":"customers","starting_amount":800,"lost_amount":52}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/churn-rate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "metric_type": "customers",
  "starting_amount": 800,
  "lost_amount": 52
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.churn_rate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →