# CLAUDE.md — サイト分析コンテキスト定義書【ECサイト版】

<!--
使い方: {{ }} を自社の値に置換。該当しない行は削除。記入のコツと詳しい解説は
汎用版テンプレートの冒頭を参照してください。
EC版は「purchase を頂点とするファネル」を前提に、各項目に既定値を入れてあります。
既定値が自社と違う場合は必ず書き換えてください（そのまま使うと分析がズレます）。
-->

## 1. サイト基本情報

- **サイト名**: {{サイト名}}
- **URL**: {{https://www.example.com/}}
- **サイトタイプ**: ECサイト
- **事業内容の一言説明**: {{誰に・何を売っているか。例: 30〜40代女性向けスキンケア用品の自社EC。定期購入が売上の6割}}

### 接続データソース
- **GA4プロパティID**: {{000000000}}
- **BigQueryデータセット**: {{project.analytics_000000000}}（エクスポート開始日: {{YYYY-MM-DD}}）
- **Search Consoleプロパティ**: {{https://www.example.com/}}

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

- **収益モデル**: {{単発購入 / 定期購入 / 併売（定期比率00%）}}
- **平均注文額（AOV）**: {{00,000円}}
- **粗利率の目安**: {{00%}}
- **リピート購入周期**: {{例: 消耗品で約45日 / 耐久財で年1回}}
- **送料・決済**: {{例: 00円以上送料無料。決済はカード7割・後払い2割・代引き1割}}
  <!-- 送料無料ラインはカート放棄分析の重要文脈です。必ず記入 -->

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

- **メインターゲット**: {{年齢層・性別・特徴}}
- **利用デバイス傾向**: {{例: モバイル75% / PC25%}}
- **検討プロセス**: {{例: SNSで認知→レビュー確認→初回はお試し品から。検討期間は数日以内}}
- **競合・比較対象**: {{競合ブランド・モール（Amazon/楽天）との使い分け状況}}

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

### ゴール（月次目標）
| 指標 | 目標値 | 備考 |
|---|---|---|
| purchaseRevenue（売上） | {{0,000万円/月}} | {{前年同月+00%}} |
| transactions（購入件数） | {{0,000件/月}} | |
| 購入CVR | {{0.0%}} | セッションベース |

### キーイベント定義
| イベント名 | 意味 | 主要度 |
|---|---|---|
| purchase | 購入完了 | 主 |
| begin_checkout | チェックアウト開始 | 副 |
| add_to_cart | カート追加 | 副 |
| sign_up | 会員登録 | 副 |
| {{first_subscription}} | {{定期購入申込（定期モデルの場合）}} | {{主}} |

### 中間KPI
- カート追加率（add_to_carts/sessions）: {{0%以上}}
- カート→購入完了率: {{00%以上}}（カート放棄率 {{00%}}以下）
- リピート購入比率: 売上の{{00%}}以上
- 新規会員登録: {{000件/月}}

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

- **主要チャネル**: {{例: Paid Search 30% / Organic 25% / Email 20% / Paid Social 15% / Direct 10%}}
- **注力チャネル**: {{例: EmailとOrganic（利益率が高いため）}}
- **広告運用状況**: {{例: Google広告は指名+ショッピング。Meta広告は新規獲得用で予算変動}}
- **utm命名規則**: {{例: utm_campaign=YYYYMM_施策名。メールはutm_medium=email固定}}
- **モール・外部販路**: {{例: 楽天店あり（本CLAUDE.mdの対象外。自社EC分のみ分析）}}

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

| 時期 | 施策 | 結果 | 学び |
|---|---|---|---|
| {{YYYY-MM}} | {{例: カートページに送料無料まであと○円を表示}} | {{AOV +8%}} | {{送料閾値の可視化は効く}} |
| {{YYYY-MM}} | {{例: 決済手段にID決済追加}} | {{モバイルCVR +0.2pt}} | {{入力負荷の削減が効く}} |

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

- {{例: カートシステム（ASP）の改修を伴う施策 — プラットフォーム仕様で不可}}
- {{例: 大幅な値引き・クーポン乱発 — ブランド毀損のため不可}}
- {{例: 配送スピードの変更 — 物流体制上不可}}
- **使えるリソース**: {{例: 社内EC担当0名（月00時間）+ 制作外注 月00万円}}
- **施策提案時のルール**: 工数・コスト・評価指標・期待効果の計算式を必ず含めること

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

- **eコマース計測の実装状況**: {{例: purchase/add_to_cart/begin_checkout実装済み。view_item_listは未実装}}
- **item_category の粒度**: {{例: 大分類のみ入っている。中分類以下は判別不可}}
- **計測欠損・仕様変更**: {{例: YYYY-MM-DDにpurchase発火条件を変更。それ以前と比較不可}}
- **テスト注文**: {{例: 社内テスト注文が月数件混入。注文IDプレフィックス「TEST」は除外すること}}
- **bot・スパム**: {{例: YYYY年○月以降、海外発Direct流入が断続的に発生}}

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

- {{例: 6月・12月はセール月。売上2倍が正常。前月比でなく前年同月比を優先}}
- {{例: 給料日後（25日〜月末）に購入が集中}}
- {{例: 母の日・年末年始はギフト需要で新規比率が上がる}}

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

### レポート表記
- 表タイトルに集計期間を明記 / ページはtitleタグ表記
- 売上: カンマ区切り+円 / CVR: 小数点2桁% / 増減は比較軸を明記
- 提案には定量根拠と期待効果（売上換算）を必ず付す

### アラート条件（検出したら即報告）
- 購入CVRが{{0.0%}}未満
- カート放棄率が{{00%}}超
- 前週比で売上±{{30}}%以上の変動
- purchaseイベントの日次件数がゼロまたは前7日平均比−{{40}}%（計測トラブル疑い）

### BigQuery実行時の安全ルール
- スキャン量見積もり必須。{{10GB}}超は実行前確認
- `_TABLE_SUFFIX`で期間限定（全期間スキャン禁止）

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

- {{YYYY-MM-DD}}: {{例: メール経由はモバイルCVRがPCの2倍。メールLPはモバイル優先}}
- {{YYYY-MM-DD}}: {{例: レビュー20件超の商品はCVRが1.5倍。レビュー促進が先}}

---
*テンプレートバージョン: 1.0（2026-08）EC版 / MCP連携プロンプト集・完全版 同梱*
*主に使う章: 第6章（EC分析）＋第1〜5章*
