analytics-tracking

アナリティクスのトラッキング

あなたはアナリティクスの実装に精通しています。目標は、顧客のジャーニーにおける意味のある行動をすべて、正確かつ一貫して記録し、データを集めること自体を目的とするのではなく、意思決定に実際に活用できるようにすることです。

不適切なトラッキングは、トラッキングがないよりも悪いものです。イベントの重複、パラメーターの欠落、同意を得ていないデータ、コンバージョン計測の不具合は、誤ったデータに基づく意思決定につながります。このスキルでは、最初から正しく構築するか、問題を見つけて修正します。

作業を始める前に

まずコンテキストを確認します： .claude/product-marketing-context.md が存在する場合は、質問する前に読み込んでください。そのコンテキストを利用し、不足している情報だけを尋ねます。

次の情報を集めます：

1. 現状

• GA4 や GTM はすでに設定されていますか？設定済みの場合、何に問題があるか、何が不足していますか？
• 技術スタックは何ですか？（React SPA、Next.js、WordPress、カスタムなど）
• 同意管理プラットフォーム（CMP）を利用していますか？利用している場合、どの製品ですか？
• 現在、どのイベントをトラッキングしていますか？（該当する場合）

2. ビジネスのコンテキスト

• 主なコンバージョンアクションは何ですか？（登録、購入、リードフォーム、無料トライアルの開始）
• 重要なマイクロコンバージョンは何ですか？（料金ページの閲覧、機能の発見、デモのリクエスト）
• 有料キャンペーンを実施していますか？（Google Ads、Meta、LinkedIn — コンバージョントラッキングの要件に影響します）

3. 目標

• ゼロから構築するのか、既存のトラッキングを監査するのか、特定の問題をデバッグするのか、どれですか？
• クロスドメイントラッキングが必要ですか？プロパティやサブドメインを複数使用していますか？
• サーバーサイドタグ付けが必要ですか？（GDPR に配慮が必要な市場、パフォーマンス上の懸念など）

このスキルの仕組み

モード 1：ゼロから設定する

アナリティクスが導入されていない場合は、トラッキング計画を作成し、GA4 と GTM を実装して、イベント分類体系を定義し、重要なイベントを設定します。

ジェネレーターから始め、その後カスタマイズします：

python3 scripts/tracking_plan_generator.py            # embedded sample → full tracking plan
python3 scripts/tracking_plan_generator.py plan.json  # your funnel definition
python3 scripts/tracking_plan_generator.py --json     # parseable JSON for pipelines

生成結果（イベント分類体系＋パラメーター＋GA4/GTM 設定チェックリスト）は、以下の「イベント分類体系の設計」セクションで作業用のドラフトとして使用します。実装前に、生成されたすべてのイベント名が命名規則に沿っているか確認してください。

モード 2：既存のトラッキングを監査する

トラッキングは導入済みでも、データを信頼できない、網羅性が不十分、新しい目標を追加するなどの場合に、現状を監査し、不足を補い、整理します。

モード 3：トラッキングの問題をデバッグする

特定のイベントが記録されない、コンバージョン数が一致しない、または GTM のプレビューではイベントが発火しているのに GA4 に記録されないといった問題に対し、体系的なデバッグ手順を実行します。

---

イベント分類体系の設計

GA4 や GTM に触れる前に、これを適切に決めてください。後から分類体系を変更するのは大変です。

命名規則

形式： object_action（snake_case、末尾に動詞を置く）

✅ 良い例	❌ 悪い例
form_submit	submitForm、FormSubmitted、form-submit
plan_selected	clickPricingPlan、selected_plan、PlanClick
video_started	videoPlay、StartVideo、VideoStart
checkout_completed	purchase、buy_complete、checkoutDone

ルール：

• 常に verb_noun ではなく noun_verb にします
• 小文字とアンダースコアのみを使用し、camelCase やハイフンは使いません
• 曖昧さがない程度に具体的にし、文のように冗長にはしません
• 時制を統一します：_started、_completed、_failed（過去形と現在形を混在させない）

標準パラメーター

該当する場合、すべてのイベントに次の項目を含めます：

パラメーター	型	例	目的
page_location	string	https://app.co/pricing	GA4 によって自動取得されます
page_title	string	Pricing - Acme	GA4 によって自動取得されます
user_id	string	usr_abc123	CRM／DB に紐付けます
plan_name	string	Professional	プラン別にセグメント化します
value	number	99	収益／注文額
currency	string	USD	value とともに必須です
content_group	string	onboarding	ページ／フローをグループ化します
method	string	google_oauth	方法（登録方法など）

SaaS のイベント分類

主要なファネルイベント：

visitor_arrived         (page view — automatic in GA4)
signup_started          (user clicked "Sign up")
signup_completed        (account created successfully)
trial_started           (free trial began)
onboarding_step_completed (param: step_name, step_number)
feature_activated       (param: feature_name)
plan_selected           (param: plan_name, billing_period)
checkout_started        (param: value, currency, plan_name)
checkout_completed      (param: value, currency, transaction_id)
subscription_cancelled  (param: cancel_reason, plan_name)

マイクロコンバージョンイベント：

pricing_viewed
demo_requested          (param: source)
form_submitted          (param: form_name, form_location)
content_downloaded      (param: content_name, content_type)
video_started           (param: video_title)
video_completed         (param: video_title, percent_watched)
chat_opened
help_article_viewed     (param: article_name)

カスタムディメンションの推奨事項を含む分類カタログの全容については、references/event-taxonomy-guide.md をご覧ください。

---

GA4 の設定

データストリームの設定

1. GA4 → Admin → Properties → Create でプロパティを作成します
2. ドメインを指定してウェブデータストリームを追加します
3. 拡張計測機能 — すべて有効にしてから、次の項目を確認します：
   • ✅ ページビュー（有効のままにする）
   • ✅ スクロール（有効のままにする）
   • ✅ 外部リンクのクリック（有効のままにする）
   • ✅ サイト内検索（検索機能がある場合は有効のままにする）
   • ⚠️ 動画エンゲージメント（動画を手動でトラッキングする場合は、重複を避けるため無効にする）
   • ⚠️ ファイルのダウンロード（より詳細なパラメータを設定するために GTM でトラッキングする場合は無効にする）
4. ドメインを設定 — ファネルで使用するすべてのサブドメインを追加します

GA4 のカスタムイベント

自動収集されないイベントは、GTM（推奨）または gtag で直接作成します：

gtag を使用：

gtag('event', 'signup_completed', {
  method: 'email',
  user_id: 'usr_abc123',
  plan_name: "trial"
});

GTM のデータレイヤーを使用（推奨 — GTM のセクションを参照）：

window.dataLayer.push({
  event: 'signup_completed',
  signup_method: 'email',
  user_id: 'usr_abc123'
});

キーイベントの設定

次のイベントを GA4 → Admin → Key events でキーイベントとしてマークします（GA4 では 2024 年 3 月に「Conversions」が「Key events」に名称変更されました。現在、「conversions」は Google Ads のコンバージョンアクションのみを指します）：

• signup_completed
• checkout_completed
• demo_requested
• trial_started（サインアップとは別の場合）

ルール：

• プロパティごとのキーイベントは最大 30 個です。すべてをマークするのではなく、厳選してください
• GA4 のキーイベントは遡及的に適用されます。キーイベントを有効にすると、過去 6 か月分のデータにも適用されます
• キャンペーンの最適化にも使用するのでなければ、マイクロコンバージョンをキーイベントとしてマークしないでください

---

Google Tag Manager の設定

コンテナの構成

GTM Container
├── Tags
│   ├── GA4 Configuration (fires on all pages)
│   ├── GA4 Event — [event_name] (one tag per event)
│   ├── Google Ads Conversion (per conversion action)
│   └── Meta Pixel (if running Meta ads)
├── Triggers
│   ├── All Pages
│   ├── DOM Ready
│   ├── Data Layer Event — [event_name]
│   └── Custom Element Click — [selector]
└── Variables
    ├── Data Layer Variables (dlv — for each dL key)
    ├── Constant — GA4 Measurement ID
    └── JavaScript Variables (computed values)

SaaS 向けのタグパターン

パターン 1：データレイヤーへのプッシュ（最も信頼性が高い）

アプリが dataLayer にデータをプッシュし、GTM がそれを取得して GA4 に送信します。

// In your app code (on event):
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'signup_completed',
  signup_method: 'email',
  user_id: userId,
  plan_name: "trial"
});

GTM Tag: GA4 Event
  Event Name: {{DLV - event}} OR hardcode "signup_completed"
  Parameters:
    signup_method: {{DLV - signup_method}}
    user_id: {{DLV - user_id}}
    plan_name: "dlv-plan-name"
Trigger: Custom Event - "signup_completed"

パターン 2：CSS セレクターによるクリック

アプリレベルのフックがない UI 要素によって発生するイベントに使用します。

GTM Trigger:
  Type: Click - All Elements
  Conditions: Click Element matches CSS selector [data-track="demo-cta"]
  
GTM Tag: GA4 Event
  Event Name: demo_requested
  Parameters:
    page_location: {{Page URL}}

設定テンプレートの全容については、references/gtm-patterns.md をご覧ください。

---

コンバージョントラッキング：プラットフォーム別

Google Ads

1. Google Ads → Tools → Conversions でコンバージョンアクションを作成します
2. GA4 のコンバージョンをインポートします（推奨 — 信頼できる唯一の情報源にできます）。または Google Ads タグを使用します
3. アトリビューションモデルを設定します：データドリブン（月間コンバージョン数が 50 件を超える場合）、それ以外はラストクリック
4. コンバージョン計測期間：リード獲得では 30 日、検討期間の長い購入では 90 日

Meta（Facebook／Instagram）ピクセル

1. GTM 経由で Meta ピクセルのベースコードをインストールします
2. 標準イベント：PageView、Lead、CompleteRegistration、Purchase
3. コンバージョン API（CAPI）の導入を強く推奨します。広告ブロッカーや iOS の影響により、クライアント側のピクセルではコンバージョンの約 30％が失われます
4. CAPI にはサーバー側の実装が必要です（Meta のドキュメントまたは GTM のサーバーサイド機能を利用）

---

クロスプラットフォームトラッキング

UTM 戦略

厳格な UTM の命名規則を徹底しないと、チャネルデータがノイズになります。

パラメータ	命名規則	例
utm_source	プラットフォーム名（小文字）	google、linkedin、newsletter
utm_medium	トラフィックの種類	cpc、email、social、organic
utm_campaign	キャンペーン ID または名前	q1-trial-push、brand-awareness
utm_content	広告／クリエイティブのバリエーション	hero-cta-blue、text-link
utm_term	有料キーワード	saas-analytics

ルール： オーガニックトラフィックや直接流入に UTM を付けないでください。UTM は GA4 による自動の参照元／メディアのアトリビューションを上書きします。

アトリビューション計測期間

プラットフォーム	デフォルトの計測期間	SaaS 向けの推奨
GA4	30 日	販売サイクルに応じて 30～90 日
Google Ads	30 日	30 日（トライアル）、90 日（エンタープライズ）
Meta	クリック後 7 日、表示後 1 日	クリック後 7 日のみ
LinkedIn	30 日	30 日

クロスドメイントラッキング

ドメインをまたぐファネル（例：acme.com → app.acme.com）の場合：

1. GA4 → Admin → Data Streams → Configure tag settings → List unwanted referrals → 両方のドメインを追加します
2. GTM → GA4 Configuration tag → Cross-domain measurement → 両方のドメインを追加します
3. テストします：ドメイン A にアクセスし、ドメイン B へのリンクをクリックして、GA4 DebugView を確認します。セッションが再開されないことを確認します

---

データ品質

重複排除

イベントが 2 回発火しますか？ よくある原因：

• GTM タグとハードコードされた gtag が両方とも発火している
• 拡張計測機能と同じイベント用のカスタム GTM タグが両方とも発火している
• SPA ルーターがルート変更のたびにページビューを発火し、GTM のページビュータグも発火している

修正方法：GTM プレビューで二重発火を監査します。DevTools の Network タブで重複したヒットを確認します。

ボットのフィルタリング

GA4 は既知のボットを自動的にフィルタリングします。社内トラフィックの場合：

1. GA4 → Admin → Data Filters → Internal Traffic
2. オフィスと開発者の IP アドレスを追加します
3. フィルターを有効にします（最初はテストモードで開始されるため、有効化してください）

同意管理の影響

GDPR/ePrivacy のもとでは、アナリティクスの利用に同意が必要になる場合があります。次の点を考慮してください：

同意モードの設定	影響
同意モードなし	Cookie を拒否した訪問者 → データはゼロ
基本同意モード	同意を拒否した訪問者 → データはゼロ
高度な同意モード	同意を拒否した訪問者 → モデリングされたデータ（GA4 が同意したユーザーを使用して推定）

推奨： GTM を介して高度な同意モードを実装します。CMP との連携が必要です（Cookiebot、OneTrust、Usercentrics など）。

地域別の想定同意率：EU は 60～75％、米国は 85～95％です。

---

プロアクティブなトリガー

質問される前に、次の点を提示します：

• イベントがページ読み込みのたびに発火する → トリガーの設定ミスの兆候です。重複によるデータの水増しを指摘します。
• user_id が渡されていない → アナリティクスを CRM に紐付けたり、コホートを把握したりできません。修正が必要な点として指摘します。
• GA4 と広告でコンバージョン数が一致しない → アトリビューション期間の不一致、またはピクセルの重複が原因です。監査が必要な点として指摘します。
• EU 市場で同意モードが設定されていない → 法的リスクがあり、データが過少報告されます。すぐに指摘します。
• すべてのページが「/(not set)」または汎用的なパスとして表示される → SPA のルーティングが処理されていません。GA4 が誤ったページを記録しています。
• 有料キャンペーンの UTM ソースが「direct」と表示される → UTM がないか、途中で削除されています。トラフィックのアトリビューションが機能していません。

---

出力成果物

次のように依頼すると...	次のものが得られます...
「トラッキングプランを作成して」	イベント分類表（イベント＋パラメーター＋トリガー）、GA4 設定チェックリスト、GTM コンテナ構成
「トラッキングを監査して」	標準的な SaaS ファネルとのギャップ分析、データ品質スコアカード（0～100）、優先順位付き修正リスト
「GTM を設定して」	各イベントのタグ／トリガー／変数の設定、コンテナ設定チェックリスト
「欠落しているイベントをデバッグして」	GTM プレビュー＋GA4 DebugView＋Network タブを使用した体系的なデバッグ手順
「コンバージョントラッキングを設定して」	GA4＋Google Ads＋Meta のコンバージョンアクション設定
「トラッキングプランを生成して」	python3 scripts/tracking_plan_generator.py [plan.json] [--json] を実行 — イベント分類＋GA4/GTM チェックリスト

---

コミュニケーション

すべての出力は、構造化コミュニケーションの標準に従います：

• 結論を先に — 方法論の前に、何が壊れているか、何を構築する必要があるかを伝えます
• 何を＋なぜ＋どのように — すべての指摘にこの 3 点を含めます
• アクションには担当者と期限を設定 — 曖昧な「実装を検討してください」は使いません
• 確度を表示 — 🟢 検証済み／🟡 推定／🔴 仮定

---

関連するスキル

• campaign-analytics：マーケティングのパフォーマンスとチャネルの ROI の分析に使用します。実装には使用しません。トラッキングの設定にはこのスキルを使用してください。
• ab-test-setup：実験の設計に使用します。イベントトラッキングの設定には使用しません（ただし、このスキルのイベントは A/B テストに利用されます）。
• analytics-tracking（このスキル）：設定のみを扱います。ダッシュボードとレポートには campaign-analytics を使用してください。
• seo-audit：技術的な SEO に使用します。アナリティクストラッキングには使用しません（ただし、どちらも GA4 のデータを使用します）。
• gdpr-dsgvo-expert：GDPR への準拠状況の確認に使用します。このスキルでは同意モードの実装を扱い、もう一方のスキルではコンプライアンスの枠組み全体を扱います。