# 公開ページの実表示から「料金の階段」を逆算し、変更の前後を対照群つきで比べる 管理画面の設定値ではなく、**客が実際に見ている画面の総額**から料金構造（閾値と単価）を割り出し、 設定変更の効果を exit code で判定するための指示書。宿泊・チケット・レンタル・SaaS の人数課金など、 「N を増やすと総額が増える」形の料金すべてに使える。 ## この指示書が防ぐ失敗 1. **両端2点で割って、実在しない単価を報告する** 最小 N と最大 N の総額差を N 差で割ると滑らかな数字が出るが、料金表が階段だとその数字は どの区間にも存在しない。実例: 総額が N=2,3,4 で同額、N=5 から段が付く料金で、両端割りは 「750/人」を出した。実体は「4 まで無料・5 から 1,500/人」。この嘘を信じると、既に正しく 設定されている項目を「未反映」と誤判定して二重に触ることになる。 2. **同じ名前の別ユニットを比べる** 一覧型ページは N によって表示される商品が入れ替わる。名前だけを鍵にすると、N=2 のときの 「標準プラン（定員6）」と N=6 のときの「標準プラン（定員12）」を突き合わせて嘘の差額が出る。 3. **取れなかったを 0 と混同する** 抽出に失敗した点を「差なし」として扱うと、変更が入っていないのに「入った」と読める。 4. **1回の順位・1回の価格で語る** 検索順位は測定ごとに揺れる。前後比較は中央値と、影響を受けないはずの帯（対照群）が 一緒に動いていないかの検定をセットにしないと、市場の揺れを効果と誤認する。 ## 作るもの（2本） ### A. 料金階段の計測器（exit 0/1/2） node tools/price-step-meter.mjs --url-template "" --vary 2,3,4,5,6 \ --expect-unit 1500 --expect-threshold 4 --json out.json 実装の要点: 1. **入力は連続にする**。`2,3,4,5,6` のように隙間なく測る。隙間があると閾値は範囲でしか 決まらない。範囲でしか決まらないときは `pinned: false` を出力に必ず入れる。 2. 各点で headless ブラウザ（playwright 等）でページを開き、描画待ちを置いてから `innerText` を取る。**API ではなく実表示**を読むのが目的。 3. 総額の抽出は**ラベル基準**にする。数字の最大値を拾うような当て推量はしない。 取れなかった点は `method: 'none'` として記録し、**その場で exit 2**。代替推定をしない。 4. 一覧型ページでは、商品名の行を上方向に探し、**画面部品の行を除外する** （「すべて表示」「詳細を見る」「〜を選択」など。これらは商品名と同じ語を含むことがある）。 鍵は **商品名＋容量（定員・席数など）** の組にする。名前だけでは衝突する。 5. 容量表記は**上にも下にもある**。単品ページでは価格枠の下にしか出ないことがある。 上方向を探して見つからなければ下方向も探す。 6. 逆算は**隣接区間の増分**で行う: `step(n_i → n_j) = (総額_j − 総額_i) / (n_j − n_i) / 単位数`（泊数・日数など） - 増分が 0 の区間 = 加算なし - 増分が出る最初の区間の下端 = **閾値** - 加算ありの区間の増分の中央値 = **単価** - 加算ありの区間どうしで増分がばらつく → 1つの数字で語れない形なので **exit 2** 7. 複数商品があるなら商品ごとに閾値と単価を出し、**商品間で一致しているか**も確認する。 食い違えば exit 2（設定が商品ごとに違うか、抽出が壊れている）。 8. **判定より先に表を全部出力する**。測定不能で落ちるときこそ、何をどう読んだかが残っていないと 原因を追えない。 出力例: 区間 2→3 | 増分=0 区間 3→4 | 増分=0 区間 4→5 | 増分=1500 区間 5→6 | 増分=1500 商品 A | 閾値=4 | 単価=1500 判定: 一致（1500） ### B. 前後比較（対照群つき・exit 0/1/2） 順位・露出・転換率など「変更で動くはずの指標」を、変更前後で複数回測って比べる。 node tools/rank-compare.mjs --before b1.json --before b2.json --before b3.json \ --after a1.json --after a2.json --after a3.json --margin 0.05 実装の要点: 1. **1回では判定しない**。片側 3 回程度を集め、指標はパーセンタイル （`順位 ÷ 母数`）に正規化してから**中央値**を取る。母数が回ごとに違っても比べられる。 2. **対照群を必ず持つ**。料金の閾値が 4 なら、`N ≤ 閾値` の帯は理屈上影響を受けない。 その帯を対照群として同じ計算をする。 3. 判定: - 影響を受ける帯が margin を超えて改善 → exit 0 - 改善なし・悪化 → exit 1 - **対照群も同じ向きに margin を超えて動いた → exit 2（効果と市場の揺れを切り分けられない）** - 前後で条件（日付・地理範囲・帯の一覧）が違う、測定回数が足りない → exit 2 4. 「不在」は最下位相当（パーセンタイル 1.0）として扱い、**absent の回数を必ず併記**する。 在庫切れなど正当な理由で出ないケースがあるので、不在を症状と決めつけない。 5. 自己検定: **before と after に同じファイルを渡して delta が 0 になること**を確認してから使う。 合成データで「対照群も動いた」ケースを作り、exit 2 が実際に出ることも確認する。 ## 手順（このまま AI に渡せる） 1. 対象ページの URL 形式と、変えるパラメータ（人数・枚数・席数）を確定する。 2. **まず1点だけ実際に開き、本文テキストをファイルに保存して目で見る。** ラベル（総額・容量）の実際の表記と、一覧型か単品型かをここで決める。推測で正規表現を書かない。 通貨記号の位置（前置か後置か）と**括弧が全角か半角か**もここで確認する。 3. A を実装し、既に正しい設定になっていると分かっている対象で **exit 0 が出ること**を確認する （＝対照群での検定）。これをせずに「異常」を報告しない。 4. 変更前の値と指標を測って保存する（生 JSON をリポジトリに残す）。 5. 設定を変更する。**管理画面がログイン必須で自動化できない場合、そこだけは人に頼む**。 その際は URL・変更する項目名・期待値・「変えられなかった場合の逃げ道」を1通に書く。 見たことのない画面の手順を創作しない（先にスクリーンショットを1枚もらう）。 6. A を `--expect-*` 付きで叩いて exit 0 を確認 → B で前後比較 → exit code で報告する。 ## 報告の作法 - 「反映した」ではなく「**この画面のこの数字がこうなった**」と、読み戻した値で言う。 - 0 件・0 円を報告するときは、**その 0 が何を数えた 0 か**を必ず併記する （母数・列挙数・抽出方法）。抽出に失敗した 0 と、本当に 0 の 0 は区別が付かない。 - 測定不能（exit 2）は失敗ではなく情報。無理に 0 か 1 に丸めない。 ---