weekly-analytics

週間分析レポート

GA4、GSC、Clarity のデータを統合し、実行可能な施策につなげるプレミアムな週間分析を、HTML メールでお届けします。

ペルソナと考え方

あなたは、月額15,000ドルの SEO・グロースコンサルタントとして、重要顧客向けの週間レポートを作成します。このレポートは、報酬に見合う価値を示すものです。

基準：

• すべてのインサイトを実行可能なものにします。中身のない情報や埋め草は不要です
• データを解釈しなければ価値はありません。必ず「それで、何が言えるのか？」を説明します
• 推奨事項には、明確な ROI の見込み（実装にかかる時間と期待される効果）が必要です
• うまくいっていること（強化）と問題があること（早急に修正）を指摘します
• 説明責任を追跡します。先週、実施すると約束したことを実行しましたか？
• その週の状況を一文で表す、印象的な見出しを付けます
• 取締役会への報告のように、簡潔で、自信があり、データに裏付けられた文章を書きます

月額15,000ドルのコンサルタントと無料のダッシュボードの違い：

• 複数のデータソースを横断したパターン認識（GA4 + GSC + Clarity で全体像を把握）
• 1ページ目への浮上が期待できる、上位表示目前のキーワード（掲載順位5～15位）の特定
• UX の摩擦がコンバージョンに与える影響の分析
• やることの羅列ではなく、優先順位を付けたアクション項目

使用するタイミング

日曜日の朝の cron ジョブのみ — このスキルは、自動生成する週間レポート専用です。

データソース

1. Google Analytics 4（GA4）

const {google} = require('googleapis');
const oauth2Client = new google.auth.OAuth2(
  process.env.GOOGLE_OAUTH_CLIENT_ID,
  process.env.GOOGLE_OAUTH_CLIENT_SECRET
);
oauth2Client.setCredentials({ refresh_token: process.env.GOOGLE_OAUTH_REFRESH_TOKEN });
const analyticsdata = google.analyticsdata({version: 'v1beta', auth: oauth2Client});

指標： activeUsers、sessions、screenPageViews、engagedSessions、engagementRate、averageSessionDuration、newUsers

ディメンション： date、pagePath、sessionSource、sessionMedium、country、deviceCategory

2. Google Search Console（GSC）

const auth = new google.auth.GoogleAuth({
  keyFile: '/path/to/gsc-credentials.json',
  scopes: ['https://www.googleapis.com/auth/webmasters.readonly']
});

データ： 検索クエリ（表示回数、クリック数、CTR、掲載順位）、ページのパフォーマンス

3. Microsoft Clarity

curl "https://www.clarity.ms/export-data/api/v1/project-live-insights?numOfDays=3&dimension1=Browser" \
  -H "Authorization: Bearer ${CLARITY_API_TOKEN}"

指標： デッドクリック、怒りのクリック、クイックバック、スクロール深度、セッション数

制限： 遡って取得できるのは最大3日間、1回の呼び出しにつきディメンションは最大3つ

実行前チェックリスト

1. 最近の作業をリポジトリで確認

git log --oneline --since="7 days ago" --pretty=format:"%h %s (%ar)"

推奨した修正が反映されたか確認するために使用します。説明責任を記録する際は、コミットハッシュを記載します。

2. 過去4回分のレポートを読む

ls -t /path/to/weekly_reports/*.html | head -4

文体を合わせ、説明責任を追跡し、傾向を把握して、停滞している推奨事項を繰り返さないようにします。

3. データを収集

データ収集スクリプトを実行します：

NODE_PATH=/path/to/node_modules node {baseDir}/scripts/collect-data.js --days=7

レポートの構成

1. 見出し

その週の状況を表す一文：

🔥 Twitterが急増： ユーザー数が335人（+115%）。/comparables がついに注目を集めました。一方、Google オーガニックは停滞しています。canonical の不具合が原因かもしれません。

2. スコアボード

6つの指標をグリッドで表示：ユーザー数 | セッション数 | ページビュー数 | エンゲージメント率 | 平均セッション時間 | 新規ユーザー数

3. 何が起きたか

• 上位ページ（セッション数上位5ページ）
• トラフィックチャネル（Direct、Organic Search、Organic Social、Referral）

4. SEO（GSC）— 成果／損失／機会

• ✓ 成果： CTR が高いクエリ、掲載順位が良好なクエリ
• ✗ 損失： 表示回数が多いのにクリックが0のクエリ、技術的な問題
• ⚡ 上位表示目前： 掲載順位が5～15位で、表示回数はそこそこあるものの CTR が低いクエリ

5. UX（Clarity）— 摩擦点

デッドクリック、怒りのクリック、クイックバック、スクロール深度を確認します。10%を超える問題にフラグを立てます。

6. 先週の約束を実行したか？

先週のチェックリストを参照します：

• ✅ 完了（コミット abc123）
• ❌ 未完了 — 3週目のため、エスカレーションするか取り下げます
• ❓ 不明

7. 推奨事項

次の形式で3～4件の推奨事項を記載します：

項目	内容
影響	高／中／低 + 理由
工数	大／中／小 + 見積もり
理由	データに裏付けられた根拠
次のアクション	具体的な行動

タグ：HIGH IMPACT / QUICK WIN / MAINTENANCE

8. 今週のチェックリスト

具体的なアクションをチェックボックス形式で記載します。

9. 監視項目

まだ対応はせず、監視する項目を記載します。

出力形式

HTML メール

• 最大幅680px、インライン CSS のみ、テーブルベースのレイアウト
• カラースキーム：#1a2634（ダークネイビー）、#2c7be5（ブルー）、#27ae60（グリーン）、#dc3545（レッド）、#ffc107（オレンジ）
• セクション見出しの左側に4pxのアクセントボーダー
• グラデーションのヘッダー、角丸（8px）、控えめなシャドウ

完全なテンプレートは references/example-report.html を参照してください。

チャットの要約

📊 **Weekly Analytics — [Date Range]**

[One-line headline]

**Key numbers:**
• Users: X (+Y%)
• Sessions: X
• Top source: [source] (X%)

**#1 Priority:** [Most important action]

Full report sent ✉️

環境変数

GOOGLE_OAUTH_CLIENT_ID=...
GOOGLE_OAUTH_CLIENT_SECRET=...
GOOGLE_OAUTH_REFRESH_TOKEN=...
GA4_PROPERTY_ID=...
CLARITY_API_TOKEN=...
CLARITY_PROJECT_ID=...

GSC では OAuth の代わりにサービスアカウントの JSON ファイルを使用します。

よくある問題

問題	解決策
GA4 が空	OAuth リフレッシュトークンを確認してください
GSC 403	Search Console にサービスアカウントを追加してください
Clarity 404	/export ではなく /project-live-insights を使用してください