name: analytics description: GA4のデータ取得・分析、サイトパフォーマンス計測を行う。「アクセス解析」「PV確認」「トラフィック分析」「データ分析」「レポート生成」「パフォーマンス確認」「流入分析」などの作業に使う。初期セットアップ（GA4タグ設置、API有効化）にも対応。Search Console/SEOは seo-search-console スキルを参照。

Analytics Skill

アーキテクチャ概要

全プロダクトのGA4を1アカウント・マルチプロパティで一元管理。

Google Analytics Account: ktlabo (385747355)
├── 15 GA4 Properties（1プロジェクト = 1プロパティ）
├── Service Account: analytics-agent@craftgarden-488320.iam.gserviceaccount.com
│   └── 認証JSON: ~/.config/gcloud/service-accounts/craftgarden-analytics.json
└── Product Hub 管理基盤
    ├── scripts/config/ga4-registry.json  ← 全プロパティの一元レジストリ
    ├── scripts/ga4/setup-properties.js   ← Admin API でプロパティ一括作成
    ├── scripts/ga4/deploy-tags.js        ← 全プロジェクトにタグ自動配信
    └── scripts/ga4/collect-ga4.js        ← Data API で日次メトリクス収集

環境情報

項目	値
GA4 アカウント	ktlabo (385747355)
サービスアカウント	analytics-agent@craftgarden-488320.iam.gserviceaccount.com
認証JSON	~/.config/gcloud/service-accounts/craftgarden-analytics.json
レジストリ	~/Dev/product-hub/scripts/config/ga4-registry.json
メトリクス出力	~/Dev/product-hub/packages/dashboard/public/data/ga4-metrics.json
GCP プロジェクト	craftgarden-488320
有効API	Analytics Admin API, Analytics Data API

適用済みプロジェクト

15件のGA4プロパティが稼働中。測定ID・プロパティID一覧は以下を参照: -> references/ga4-properties.md

管理コマンド

GA4のメトリクス収集・プロパティ作成・タグ配信のコマンド集: -> scripts/manage-ga4.sh（collect, setup, deploy, deploy-project 等）

新規プロジェクトへのGA4追加

レジストリ追加 → プロパティ作成 → タグ配信 → Vercel環境変数 → commit/push の5ステップ。詳細手順は以下を参照: -> references/setup-new-project.md

フレームワーク別タグ設置パターン

Next.js App Router（@next/third-parties）と Vite/静的HTML（gtag.js）の2パターン。 GTM は現時点では不要（1人運用・追加JS不要のため）。 -> references/tag-patterns.md

データ取得

横断メトリクス収集

pnpm collect:ga4 で全15プロパティから一括取得。ダッシュボード /monitoring で可視化。

利用可能メトリクス・ディメンション

GA4 Data API で使用可能なメトリクス・ディメンション一覧: -> references/ga4-metrics-dimensions.md

Search Console / SEO

Search Console の運用・SEO最適化は seo-search-console スキル に移管済み。プロパティ登録、サイトマップ提出、検索可視性の定量評価、SEOファイル配備はそちらを参照。

分析パターン

日次チェック

pnpm collect:ga4 で全プロジェクトのメトリクス取得
ダッシュボード /monitoring の GA4 Analytics タブで横断確認
異常値（急激な変動）があれば報告

週次レビュー

GA4: プロジェクト別PV推移、ユーザー数トレンド
上位プロジェクトの流入元・デバイス別分析
エンゲージメント率の低いプロジェクトの改善検討

API認証

認証コード例とGCP設定の詳細: -> references/api-auth.md

よくある落とし穴

タグ配信後にデータが0のまま: GA4はタグ配信後、データ反映まで24-48時間かかる場合がある。即座に確認するにはGA4リアルタイムレポートを使う。.env.localとVercel環境変数の測定IDが一致しているかも確認すること
非標準レイアウトパスでdeploy-tags.jsが失敗する: monorepoやsrc/なし構成のプロジェクト（product-hub, content-studio, famiPrint, history-quiz-app）はlayout.tsxのパスが標準と異なるため手動対応が必要。--projectフラグで個別再実行可能
API認証エラー: craftgarden-analytics.jsonの存在確認、サービスアカウントがGA4アカウントの管理者として追加済みか確認。gcloud auth activate-service-account --key-file=...でテストできる
.env.localをcommitしてしまう: .env.localはsecrets（測定ID等）を含むためcommit禁止。.env.exampleのみcommitし、Vercel環境変数はvercel env addコマンドで設定する
Search ConsoleとGA4の混同: Search Console/SEOの運用はseo-search-consoleスキルに移管済み。このスキルではGA4のデータ取得・分析のみを扱う