# CLAUDE.md — サイト分析コンテキスト定義書【汎用版テンプレート】

<!--
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
このファイルの使い方
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. {{ }} で囲まれた箇所を自社の情報に置き換えてください
2. 該当しないセクションは削除して構いません（残すとAIが誤解します）
3. 「記入例」のコメントは記入後に削除してください
4. 完成したらClaude Codeのプロジェクトルート、または
   Claude Desktopのプロジェクト知識に配置してください
5. 分析で新しい学びが得られたら「11. 学習ログ」に追記してください。
   このファイルは"育てる"ドキュメントです

★記入のコツ：
「AIはこのビジネスで何が勝ち筋かを知らない」前提で書いてください。
情報がないと一般論の教科書が、情報があると自社の来週のタスクリストが
返ってきます。その差を生むのがこのファイルです。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-->

## 1. サイト基本情報

- **サイト名**: {{サイト名}}
- **URL**: {{https://www.example.com/}}
- **サイトタイプ**: {{ECサイト / B2Bリード獲得 / メディア / 店舗集客 / コーポレート}}
- **事業内容の一言説明**: {{誰に・何を・どう届けているか を1〜2文で}}
  <!-- 記入例: 30〜40代女性向けのスキンケア用品を自社ECで販売。定期購入が売上の6割 -->

### 接続データソース
- **GA4プロパティID**: {{000000000}}
- **BigQueryデータセット**: {{project.analytics_000000000}}（エクスポート開始日: {{YYYY-MM-DD}}）
- **Search Consoleプロパティ**: {{https://www.example.com/ または sc-domain:example.com}}
- **Microsoft Clarityプロジェクト**: {{プロジェクトID / 未接続}}
- **その他**: {{Looker Studio / Google Ads など}}

## 2. ビジネスモデルと収益構造

<!-- 同じ「CVR改善」でも、月額SaaSと単発ECでは打ち手が全く違います。
     AIが施策の優先順位を正しく判断するための最重要セクションです -->

- **収益モデル**: {{単発EC / 定期購入 / 月額サブスク / リード→営業成約 / 広告収益 など}}
- **平均単価**: {{00,000円}}
- **LTV（把握していれば）**: {{00,000円 / 未計測}}
- **粗利率の目安**: {{00% / 非公開なら「高粗利」「薄利多売」などの表現でも可}}
- **成約までのリードタイム**: {{即日 / 検討2週間 / 商談3〜6ヶ月 など}}

## 3. ターゲットと検討プロセス

- **メインターゲット**: {{年齢層・性別・職種・企業規模など}}
- **利用デバイス傾向**: {{モバイル中心(70%) / PC中心 など}}
- **検討プロセス**: {{初回訪問で即決 / 数回の再訪を経て比較検討 / 社内稟議あり など}}
- **競合・比較対象**: {{競合サイト名やカテゴリ}}
  <!-- 記入例: 検討期間3〜6ヶ月のB2B商材。決裁者は情シス部長、実務担当が情報収集する -->

## 4. サイトのゴールとKPI

### ゴール（最重要指標・月次目標）
| 指標 | 目標値 | 備考 |
|---|---|---|
| {{purchaseRevenue（売上）}} | {{0,000万円/月}} | {{前年同月+10%}} |
| {{transactions（購入件数）}} | {{0,000件/月}} | |
| {{form_submit（リード数）}} | {{000件/月}} | |

### キーイベント定義
<!-- ここが曖昧だと全分析がズレます。GA4管理画面のキーイベント設定と一致させてください -->
| イベント名 | 意味 | 主要度 |
|---|---|---|
| {{purchase}} | {{購入完了}} | 主 |
| {{form_submit_contact}} | {{問い合わせ送信}} | 副 |
| {{sign_up}} | {{会員登録}} | 副 |

### 中間KPI
- {{カート追加率: addToCarts/sessions 5%以上}}
- {{フォーム到達率: 3%以上 / フォーム完了率: 30%以上}}
- {{自然検索流入: 00,000セッション/月以上}}

## 5. 流入構造と主要チャネル

- **主要チャネル**: {{Organic Search, Paid Search, Direct, Email, Organic Social など実態に合わせて}}
- **注力チャネル**: {{例: Organic Search と Email}}
- **分析・改善提案から除外するチャネル**: {{例: Referral, Direct（改善打ち手がないため）}}
- **広告運用状況**: {{例: Paid SearchはGoogle9割/Yahoo1割・予算固定。SNS広告はInstagram中心・予算変動}}
- **utm命名規則**: {{例: utm_campaign=YYYYMM_施策名。メールは utm_medium=email 固定}}

## 6. 過去の施策と結果

<!-- これが抜けているとAIは「数年前に試して失敗した施策」を再提案してきます。
     効いたもの・効かなかったものの両方を書いてください -->

| 時期 | 施策 | 結果 | 学び |
|---|---|---|---|
| {{YYYY-MM}} | {{例: トップページFV改修}} | {{CVR 0.8%→1.1%}} | {{FVのCTA文言が効いた}} |
| {{YYYY-MM}} | {{例: リスティング予算1.5倍}} | {{CV微増・CPA悪化}} | {{予算増より受け皿改善が先}} |

## 7. 制約条件（実施不可能な施策）

<!-- 「LPを10本作りましょう」と言われても動けない状況を先に伝えます -->

- {{例: 決済プロセスの改修（機能追加含む）}}
- {{例: 広告予算の大幅増額}}
- {{例: 表示速度改善（Core Web Vitals対応）}}
- {{例: 現在行っていない新規集客チャネルの開始}}
- **使えるリソース**: {{例: 社内マーケ担当1名（月40時間）+ 外注制作費 月00万円}}
- **施策提案時のルール**: 工数とコスト（人件費{{00万円/月}}換算）、評価指標、期待効果の計算式を必ず含めること

## 8. データ品質の注意書き

<!-- ここを知らないAIは誤った結論を平気で出します。正直にすべて書いてください -->

- **計測欠損**: {{例: 2025年2月10〜14日 GTMタグ停止によりデータ欠損。この期間を含む比較は注記すること}}
- **自社アクセス除外**: {{例: 2025年6月以前は未除外。社内IPからのDirect流入が混在}}
- **bot・スパム**: {{例: 2025年秋以降、海外発の自動化Direct流入が断続的に発生。急増時はまずbot疑いから検証}}
- **二重計測・定義変更**: {{例: 2024年12月にpurchaseイベントの発火条件を変更。それ以前との比較は不可}}
- **BigQueryとGA4画面の差異**: {{例: しきい値・推定の影響でUI数値と最大数%ズレる。厳密な数値はBQを正とする}}

## 9. 季節要因・外部要因

- {{例: 12月・7月は繁忙期。前月比較より前年同月比較を優先}}
- {{例: 毎月末にセール開催。月末スパイクは正常}}
- {{例: 四半期末（3・6・9・12月）は問い合わせ増}}

## 10. 分析実行時の共通ルール

### レポート表記
- 表タイトルに集計期間（YYYY-MM-DD形式）を必ず明記
- ページは titleタグ文字列 で表記（URLやディメンション名の生値は不可）
- 売上: カンマ区切り+円 / 率: 小数点1桁% / CVR: 小数点2桁%
- 増減は比較軸を明記（前月比 / 前年同月比）
- すべての提案に定量的根拠と期待効果の数値を付す

### アラート条件（検出したら即座に報告）
- {{例: CVRが0.3%未満}}
- {{例: 前週比で売上±30%以上、検索流入±20%以上の変動}}

### BigQuery実行時の安全ルール
- クエリ実行前にスキャン量を見積もり、{{10GB}}を超える場合は実行前に確認を取る
- `_TABLE_SUFFIX` で対象期間を必ず限定する（全期間スキャン禁止）
- events_intraday（当日速報）と events_（確定値）を混在させない

## 11. 学習ログ（分析で得た知見の追記欄）

<!-- 「仮説→検証→ここに追記」のサイクルでこのファイルを育ててください。
     ここが貯まるほど、AIの提案は自社専用に賢くなります -->

- {{YYYY-MM-DD}}: {{例: メール経由はモバイルCVRがPCの2倍。メールLPはモバイル優先で設計する}}
- {{YYYY-MM-DD}}: {{例: ブランドワード除外で見ると自然検索CVRは0.4%。非指名の改善余地が大きい}}

---
*テンプレートバージョン: 1.0（2026-08）/ MCP連携プロンプト集・完全版 同梱*
