週に一度、自作の WordPress プラグイン6本の数字を WordPress.org のプラグイン情報 API から取ってきて、前の週と並べるスクリプトを回しています。ある週のレポートで、Rapls AI Chatbot の有効インストールが 60 から 40 に下がっていました。その次の週は 50、その次は 40、次は 30。4週で半分に見えます。

これは読み違いでした。この記事では、active_installs という数字がどう作られて、どう読めばいいのかを、自分の記録を材料にまとめます。

先に断っておくと、active_installs が10未満で 0 になることや、10刻みで丸められることは既知の話です。WordPress 本体の管理画面のコードにもそのまま出てきますし、Gutenberg にも「0 active installations」ではなく「Less than 10」と出すべきだという issue があります。ここで足せるのは、実際の導入数が分かっているプラグインで、API の値がどう見えたかと、週ごとの上下の幅です。

12サイトに入れて、0 と出た

自作のキャッシュプラグイン Prime Cache は、自分が管理する12のサイトに入れています。顧客のサイトではなく、全部自分の管理下です。つまり実数が12だと分かっている状態です。

7月20日の計測では、API の active_installs は 0 でした。プラグインのページには「Fewer than 10」と出ます。

WordPress 本体で、プラグインの追加画面がこの値をどう表示しているかを見ると、こうなっていました（wp-admin/includes/class-wp-plugin-install-list-table.php）。

if ( $plugin['active_installs'] >= 1000000 ) {
	// 「%s+ Million」
} elseif ( 0 === $plugin['active_installs'] ) {
	$active_installs_text = _x( 'Less Than 10', 'Active plugin installations' );
} else {
	$active_installs_text = number_format_i18n( $plugin['active_installs'] ) . '+';
}

0 は「0人」ではなく「10未満」として扱われています。API の値そのものには、0人と9人の区別がありません。

1週間以上遅れて、10 になった

8月10日の計測で、Prime Cache は 10 になりました。12サイトに入れてから、反映に1週間以上かかっています。

そして 12 は 10 と出ます。今（9月27日）もページの表示は「10+」のままで、記録の上でも、入っているのは自分の管理するサイトだけです。

ここまでで分かったことは3つです。

0 は 0〜9 のどれか
10刻みで切り捨てられる（12 → 10）
入れてから反映されるまで、1週間以上かかることがある

60 → 40 → 50 → 40 → 30 → 50

冒頭の AI Chatbot に戻ります。週次の記録を並べるとこうです（最後が9月24日）。

回	1	2	3	4	5	6	7
active_installs	40	60	40	50	40	30	50

最後の回は、前の回から3日しか空いていません。その3日で 30 から 50 に戻っています。20サイトが3日で入れ直したとは考えにくいので、これは数字の揺れです。

同じ時期の別の数字も並べます。

指標	同じ期間の動き
Pro の販売数	8月末の8件 → 9月24日の11件
「openrouter」の検索順位	10位（前回から5つ上昇）
「ai chatbot」の検索順位	14位（前回から4つ上昇）

有効インストールだけが下がって見えていました。ほかの指標がそろって上を向いているときに、1つだけ逆を向いているなら、まずその1つを疑うべきでした。

この規模では、週ごとの ±10〜20 は揺れと見るのが妥当だと思います。10刻みの切り捨てだけでは 60 → 40 の幅は説明しきれないので、元になる集計自体も週ごとに揺れているのでしょう。そこは WordPress.org の内部の話なので、推測にとどめます。

順位が上がった週に、3割減った？

もう1本、Rapls Sitemap でも同じことが起きました。

9月21日から24日のあいだに説明文を書き直して、「サイトマップ」の日本語検索の順位が 37位から15位に上がりました。その同じ計測で、有効インストールは 30 から 20 に下がっています。

順位がこれだけ上がった週に、使っている人が3割減るとは考えにくいです。そして今日（9月27日）ページを見ると、「40+」になっていました。

時点	Rapls Sitemap の表示
9月21日	30
9月24日	20
9月27日	40+

余談ですが、同じ日にパスキーのプラグイン Rapls Passkey を見たら「20+」でした。数週間ずっと「10未満」だったものです。Thanks Mail for Stripe は「Fewer than 10」のまま。10未満から抜けるときも、ある週に急に出てきます。

どう読めばいいのか？

自分では、次のように読むことにしました。

0 は「10未満」と表示する。0人とは書かない
100未満の製品では、1週の上下では判断しない。4週ぶんの中央値で見る
有効インストールが逆を向いたら、ダウンロード数・評価件数・検索順位・販売数と並べる
入れてから1週間以上は、反映されない前提で待つ

スクリプトに入れ終わっているのは、0 を「10未満」と出すところと、累計の数字が減ったら警告するところです。累計ダウンロード数や評価件数は減らない数字なので、減ったら記録か計測の異常とみなします。有効インストールは減りうる数字なので、同じ警告は出しません。4週の中央値は、これから足します。

中央値にしたのは、平均だと 60 のような外れた1回に引っ張られるからです。AI Chatbot の7回ぶんの中央値は 40 で、最初の回と同じ値でした。

残っている問い

有効インストールの数字は、小さいプラグインほど粗く、揺れが大きく見えます。そういう数字を毎週見ることに、どれくらい意味があるのか。自分はいま、4週ぶんをまとめて見ることで折り合いをつけていますが、100 を超えたら、1000 を超えたら、どの幅を揺れとみなすのか。そこはまだ決められていません。

皆さんは、自分のプラグインの有効インストールを、どの間隔で見ていますか。

スクリプトの該当部分

表示と警告の部分は、いま動いているものからの抜き出しです。中央値の関数は、これから足す予定のものです。

import statistics

def fmt_installs(n):
    """API の active_installs を表示用にする。0 は 0〜9 を意味する。"""
    if n is None:
        return "?"
    return "10未満" if n == 0 else f"{n:,}"

def recent_median(history, slug, weeks=4):
    """直近 weeks 回の active_installs の中央値。記録が足りなければ None。"""
    values = [
        entry["plugins"][slug]["active_installs"]
        for entry in history[-weeks:]
        if slug in entry.get("plugins", {})
        and entry["plugins"][slug].get("active_installs") is not None
    ]
    return statistics.median(values) if len(values) >= 2 else None

MONOTONIC_KEYS = {"downloaded", "num_ratings", "sales_total"}

def delta(now, prev, key=None):
    """前回比。減らないはずの累計が減ったら警告する。"""
    if prev is None or now is None:
        return ""
    d = now - prev
    if d == 0:
        return " (±0)"
    if d < 0 and key in MONOTONIC_KEYS:
        return f" ({d} ⚠ 累計が減少)"
    return f" ({'+' if d > 0 else ''}{d})"

ふだんはraplsworks.comで、WordPressプラグイン開発やClaude Codeまわりのことを書いています。
https://raplsworks.com/