← 一覧に戻る

study-timer-ops

GitHub ↗ HTML 最終push: 2026/7/15 21:45

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)

次にやること:

  1. GCS 疎通確認(SA play-console-mcp@ichirokisanuki.iamgs://pubsite_prod_rev_16697972298450990339/stats/installs/ が読めるか)→ 開通したらインストール数 CSV の取得テスト
  2. 残りのコンテキスト受け渡し: 広告構成(ネットワーク・フォーマット)/ 課金プラン設計意図 / アップデート計画

要観測: 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 リポジトリとの関係を決める必要があった。

決定: .gitignorestudy-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

概要

(記入予定)

セットアップ

(記入予定)

使い方

(記入予定)