study-timer-ops
WIP(現在進行中)
Work In Progress
このプロジェクトで現在進行中の作業と、過去のスナップショットを記録する。
現在の状況
(2026-07-15 21:43 時点)
フェーズ: 運用コンテキストの整備。 アプリ情報・収益・レビュー・データ接続の状況はすべて CLAUDE.md に集約済み。
データソース接続状況:
| ソース | 状態 |
|---|---|
| App Store Connect(MCP) | 済(売上・レビュー・財務) |
| GA4(プロパティ 347054291) | 済(次回セッションで .mcp.json の承認が必要) |
| Play レビュー API / Android vitals | 済 |
| Play 統計CSV(GCS バケット) | アカウントレベル権限の反映待ち(403) |
次にやること:
- GCS 疎通確認(SA
play-console-mcp@ichirokisanuki.iamでgs://pubsite_prod_rev_16697972298450990339/stats/installs/が読めるか)→ 開通したらインストール数 CSV の取得テスト - 残りのコンテキスト受け渡し: 広告構成(ネットワーク・フォーマット)/ 課金プラン設計意図 / アップデート計画
要観測: App Store 評価が 2026H1 に急落中(広告不満が主因)。ANR 率も Google 閾値に接近。アップデート方針検討の材料は CLAUDE.md「レビューデータ」参照。
過去のWIPアーカイブ
(新しい「現在の状況」を書く前に、古いものをここに追記でアーカイブする。新しいものが上)
ROADMAP(計画)
ロードマップ
今週
- Play Console 統計CSV(GCS)の疎通確認(アカウントレベル権限の反映待ち)→ 開通後インストール数 CSV の取得テスト
- 残りの運用コンテキスト受け渡し: 広告構成(ネットワーク・フォーマット)/ 課金プラン設計意図 / アップデート計画
今月
- 広告体験改善アップデートの方針検討(2026H1 評価急落への対応。候補: セッション中割込の禁止、復帰時広告のクールダウン、不快カテゴリのブロック、TikTok 系クリエイティブ対策)
- 「記録した時間が保存されず消える」バグの調査(iOS レビュー複数件)
- 月次収益 CSV(data/revenue-monthly.csv)の更新フロー確立(ASC finance report + 広告収益ソース)
今四半期
- ANR 率の定点観測運用(28日加重 約0.43%、Google 要注意閾値 0.47% に接近中)
- 価格・プラン構成の見直し検討(レビューの価格不満対応: 学生向け安価プラン・短期プランなど)
いつか
- クラッシュ監視の導入検討(Crashlytics 等。現状 iOS はクラッシュ可視性ゼロ)
- Android 機能パリティ: バックグラウンド再生対応、時計背景の表示バグ調査
- 外部音楽サービス連携の検討(Google Play レビュー要望)
DECISIONS(意思決定)
意思決定記録
このプロジェクトで下した重要な意思決定を記録する。 最新が上に来る。
2026-07-15: アプリ本体(study-timer-unity)は ops リポジトリの管理対象外とする
背景: アプリ本体の Unity プロジェクト(独立 git リポジトリ、履歴約15GB)がプロジェクト内にネストされており、GitHub 側 ops リポジトリとの関係を決める必要があった。
決定: .gitignore で study-timer-unity/ を除外し、アプリ本体は従来どおり AWS CodeCommit で管理を継続する。ops リポジトリには運用データ・ドキュメントのみを置く。
理由: 15GB の履歴は GitHub 移行が非現実的。submodule 化は個人開発には運用が重く、分離管理で十分。
2026-07-15: データ接続はサービスアカウント方式で統一し、GA4 はプロジェクト専用 .mcp.json で切り替える
背景: グローバルの ga4 MCP 設定は Football NEXT 向けで、勉強タイマーのプロパティ(347054291)に向ける手段が必要だった。Play Console のデータ接続も未整備だった。
決定: GA4 はプロジェクト直下の .mcp.json にプロパティ 347054291 向けのサーバー定義を追加(グローバル設定は変更しない)。Play Console は専用 SA play-console-mcp を新設して接続。ユーザー OAuth(ADC)方式は不採用。
理由: プロジェクト設定がグローバルより優先されるため他プロジェクトに影響しない。SA 方式はトークン失効がなく長期運用向き。gcloud 標準クライアントは analytics スコープの ADC ログインをブロックする問題もあった(GA 管理者への SA 追加依頼で解決)。
DEVLOG(作業ログ)
開発日誌
このプロジェクトでの作業を時系列で記録する。 最新のエントリが上に来る。
2026-07-15
21:43 - 運用コンテキスト整備とデータソース接続(7/14夜からの継続セッション)
やったこと:
- リポジトリ整備:
study-timer-unity/(アプリ本体、独立gitリポジトリ)を .gitignore に追加し、ops リポジトリと分離 - 収益データ整備: 収益レポートHTMLから35ヶ月分を抽出し
data/revenue-monthly.csvを作成。累計約435万円、iOS 94%、2024-11 の iOS 課金開始が転換点 - App Store Connect MCP 疎通確認。売上レポートは app_id 絞りだと IAP 行が漏れる・finance report は Apple 会計月(2026-03=暦2025年12月)という罠を発見し CLAUDE.md に記録。finance report と収益CSVの突合一致(¥128,962 ≒ ¥128,963)で課金列が Partner Share ベースと判明
- App Store レビュー473件を分析: 2026H1 に評価急落(半期平均 3.72、2026-05 は 2.83)。主因は広告不満(言及率 15%→41%)。セッション中割込・復帰時広告頻度・TikTok飛ばし・不快クリエイティブが具体点
- Google Play レビュー・基本情報を記録(評価 3.86。バックグラウンド再生不可など Android 固有指摘)
- GA4 接続: プロパティ 347054291。プロジェクト専用
.mcp.jsonで切替(グローバルは Football NEXT 用のまま)。GA 管理者に SA 追加を依頼し 7/15 完了、runReport 200 確認 - Play Console 接続: 専用 SA
play-console-mcp新設、androidpublisher / playdeveloperreporting 有効化。アプリ権限追加でレビュー API・Android vitals 開通。実測: クラッシュ率28日加重 約0.5%、ANR率 約0.43%(要注意閾値 0.47% に近い) - 統計CSV用 GCS バケットはアカウントレベル権限の反映待ち(自動監視を仕掛け済み)
気づき:
- 収益ピーク(2026-01 ¥328k)後の減少と評価急落が同時期。広告圧と評価のトレードオフが顕在化している
- gcloud 標準クライアントでは analytics スコープの ADC ログインがブロックされる。自前 OAuth クライアントで回避可能だが、今回は GA 管理者への SA 追加で解決
次回やること:
- GCS 疎通確認 → インストール数 CSV 取得テスト
- 残りコンテキスト受け渡し: 広告構成 / 課金設計 / アップデート計画
最近のコミット
README
study-timer-ops
概要
(記入予定)
セットアップ
(記入予定)
使い方
(記入予定)