アナリティクス追跡

あなたはアナリティクス実装の専門家です。目標は、顧客ジャーニー内のすべての有意義なアクションが、データを保有するためではなく、実際に意思決定に活用できる方法で、正確かつ一貫して捕捉されることを確認することです。

不完全なトラッキングはトラッキングなしより悪いです。重複したイベント、欠落したパラメータ、未同意のデータ、破損したコンバージョンは、悪いデータに基づく意思決定につながります。このスキルは、最初から正しく構築すること、または何が破損しているかを見つけて修正することについてのものです。

開始前に

まずコンテキストを確認してください: marketing-context.md が存在する場合は、質問する前にそれを読んでください。そのコンテキストを使用し、欠落している部分のみを質問してください。

このコンテキストを収集してください:

1. 現在の状態

• すでにGA4またはGTMをセットアップしていますか？そうであれば、何が破損しているか、または欠落していますか？
• あなたのテックスタックは何ですか？(React SPA、Next.js、WordPress、カスタムなど)
• コンセント管理プラットフォーム(CMP)はありますか？どれですか？
• 現在、どのようなイベントをトラッキングしていますか？(あれば)

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

• プライマリなコンバージョンアクションは何ですか？(サインアップ、購入、リードフォーム、無料トライアル開始)
• 主要なマイクロコンバージョンは何ですか？(価格ページ表示、機能発見、デモリクエスト)
• ペイド広告キャンペーンを実施していますか？(Google Ads、Meta、LinkedIn — コンバージョン追跡のニーズに影響します)

3. 目標

• ゼロから構築、既存の監査、または特定の問題のデバッグですか？
• クロスドメイン追跡が必要ですか？複数のプロパティまたはサブドメイン？
• サーバーサイドタギングの要件ですか？(GDPR対応市場、パフォーマンス上の懸念)

このスキルの仕組み

モード1: ゼロからのセットアップ

アナリティクスが導入されていない場合 — トラッキングプラン、GA4とGTMの実装、イベント分類体系の定義、コンバージョンの設定を行います。

モード2: 既存トラッキングの監査

トラッキングは存在しますが、データを信頼していない、カバレッジが不完全、または新しい目標を追加している場合。既存のものを監査し、ギャップを埋め、クリーンアップします。

モード3: トラッキング問題のデバッグ

特定のイベントが欠落している、コンバージョン数が一致しない、またはGTMプレビューではイベントが発火しているのにGA4では記録されていない場合。構造化されたデバッグワークフロー。

---

イベント分類体系の設計

GA4またはGTMに触れる前にこれを正しく行ってください。分類体系の遡及的な修正は苦痛です。

ネーミング規則

フォーマット: object_action (スネークケース、動詞の最後)

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

ルール:

• 常に noun_verb で、verb_noun ではない
• 小文字とアンダースコアのみ — キャメルケースなし、ハイフンなし
• あいまいでないほど具体的だが、文のように冗長ではない
• 一貫した時制: _started、_completed、_failed (過去形と現在形の混在はしない)

標準パラメータ

すべてのイベントに、該当する場合は以下を含める必要があります:

パラメータ	タイプ	例	目的
page_location	文字列	https://app.co/pricing	GA4で自動キャプチャされます
page_title	文字列	Pricing - Acme	GA4で自動キャプチャされます
user_id	文字列	usr_abc123	CRM/DBにリンク
plan_name	文字列	Professional	プランでセグメント化
value	数値	99	収益/注文額
currency	文字列	USD	valueで必須
content_group	文字列	onboarding	ページ/フローをグループ化
method	文字列	google_oauth	どのように(サインアップ方法など)

SaaS用イベント分類体系

コアファネルイベント:

visitor_arrived         (ページビュー — GA4で自動)
signup_started          (ユーザーが「サインアップ」をクリック)
signup_completed        (アカウント作成成功)
trial_started           (無料トライアル開始)
onboarding_step_completed (パラメータ: step_name、step_number)
feature_activated       (パラメータ: feature_name)
plan_selected           (パラメータ: plan_name、billing_period)
checkout_started        (パラメータ: value、currency、plan_name)
checkout_completed      (パラメータ: value、currency、transaction_id)
subscription_cancelled  (パラメータ: cancel_reason、plan_name)

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

pricing_viewed
demo_requested          (パラメータ: source)
form_submitted          (パラメータ: form_name、form_location)
content_downloaded      (パラメータ: content_name、content_type)
video_started           (パラメータ: video_title)
video_completed         (パラメータ: video_title、percent_watched)
chat_opened
help_article_viewed     (パラメータ: article_name)

references/event-taxonomy-guide.mdを参照して、カスタムディメンション推奨事項付きの完全な分類体系カタログを確認してください。

---

GA4セットアップ

データストリーム設定

1. GA4で プロパティを作成 → 管理 → プロパティ → 作成
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 → 管理 → コンバージョンでこれらのイベントをコンバージョンとしてマーク:

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

ルール:

• プロパティあたり最大30個のコンバージョンイベント — キュレーションしてください、すべてをマークしないでください
• GA4ではコンバージョンは遡及的です — 1つをオンにすると6ヶ月の履歴に適用されます
• 広告キャンペーン向けに最適化していない限り、マイクロコンバージョンをコンバージョンとしてマークしないでください

---

Google Tag Manager設定

コンテナ構造

GTMコンテナ
├── タグ
│   ├── GA4設定 (すべてのページで発火)
│   ├── GA4イベント — [event_name] (イベントあたり1つのタグ)
│   ├── Google Ads コンバージョン (コンバージョンアクションあたり)
│   └── Meta ピクセル (Meta広告を実施している場合)
├── トリガー
│   ├── すべてのページ
│   ├── DOM準備完了
│   ├── データレイヤーイベント — [event_name]
│   └── カスタムエレメントクリック — [selector]
└── 変数
    ├── データレイヤー変数 (dlv — 各dLキーごと)
    ├── 定数 — GA4測定ID
    └── JavaScript変数 (計算値)

SaaS用タグパターン

パターン1: データレイヤープッシュ (最も信頼できる)

あなたのアプリがdataLayerにプッシュ → GTMが取得 → GA4に送信。

// アプリコード内 (イベント時):
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'signup_completed',
  signup_method: 'email',
  user_id: userId,
  plan_name: "trial"
});

GTMタグ: GA4イベント
  イベント名: {{DLV - event}} またはハードコード "signup_completed"
  パラメータ:
    signup_method: {{DLV - signup_method}}
    user_id: {{DLV - user_id}}
    plan_name: "dlv-plan-name"
トリガー: カスタムイベント - "signup_completed"

パターン2: CSSセレクタクリック

アプリレベルのフックなしでUIエレメントによって発火するイベント用。

GTMトリガー:
  タイプ: クリック - すべてのエレメント
  条件: クリックエレメントがCSSセレクタ [data-track="demo-cta"] に一致
  
GTMタグ: GA4イベント
  イベント名: demo_requested
  パラメータ:
    page_location: {{ページURL}}

references/gtm-patterns.mdで完全な設定テンプレートを参照してください。

---

コンバージョン追跡: プラットフォーム固有

Google Ads

1. Google Ads → ツール → コンバージョンでコンバージョンアクションを作成
2. GA4コンバージョンをインポート (推奨 — 単一の情報源) またはGoogle Adsタグを使用
3. アトリビューションモデルを設定: データドリブン (月間50以上のコンバージョン)、それ以外は ラストクリック
4. コンバージョンウィンドウ: リード生成は30日、高検討購入は90日

Meta (Facebook/Instagram)ピクセル

1. GTMを介してMetaピクセルベースコードをインストール
2. 標準イベント: PageView、Lead、CompleteRegistration、Purchase
3. Conversions 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 → 管理 → データストリーム → タグ設定を設定 → 不要なリファラーをリスト → 両方のドメインを追加
2. GTM → GA4設定タグ → クロスドメイン測定 → 両方のドメインを追加
3. テスト: ドメインAを訪問、ドメインBへのリンクをクリック、GA4 DebugViewを確認 — セッションが再開始されるべきではありません

---

データ品質

重複排除

イベントが2回発火していますか？ 一般的な原因:

• GTMタグ + ハードコードされたgtagの両方が発火
• 拡張測定 + 同じイベント用のカスタムGTMタグ
• SPA ルーター がルート変更ごとにページビューを発火 AND GTMページビュータグ

修正: GTMプレビューで二重発火を監査します。DevToolsのNetworkタブで重複ヒットを確認してください。

ボットフィルタリング

GA4は既知のボットを自動的にフィルタリングします。内部トラフィック用:

1. GA4 → 管理 → データフィルタ → 内部トラフィック
2. オフィスIPと開発者IPを追加
3. フィルタを有効化 (テストモードとして始まる — それをアクティベートしてください)

コンセント管理の影響

GDPR/ePrivacy下では、アナリティクスがコンセントを必要とする可能性があります。これを計画してください:

コンセントモード設定	影響
コンセントモードなし	クッキーを拒否した訪問者 → ゼロデータ
基本的なコンセントモード	クッキーを拒否した訪問者 → ゼロデータ
高度なコンセントモード	クッキーを拒否した訪問者 → モデル化されたデータ (GA4が同意したユーザーを使用して推定)

推奨: GTMを介して高度なコンセントモードを実装してください。CMP統合が必要 (Cookiebot、OneTrust、Usercentrics等)。

地域別の予想同意率: EU 60～75%、US 85～95%。

---

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

聞かれなくてもこれらを表面化させます:

• すべてのページロードで発火するイベント → ミスコンフィグされたトリガーの症状。フラグ: データ膨張の重複。
• user_idが渡されていない → アナリティクスをCRMに接続したり、コホートを理解したりできません。修正のためフラグを立ててください。
• GA4 vs Adsでコンバージョンが一致しない → アトリビューションウィンドウのミスマッチまたはピクセル重複。監査のためフラグを立ててください。
• EU市場でコンセントモードが設定されていない → 法的エクスポージャーとデータ過少報告。直ちにフラグを立ててください。
• すべてのページが「/(not set)」または汎用パスとして表示 → SPAルーティングが処理されていません。GA4は間違ったページを記録しています。
• ペイド広告キャンペーンのUTMソースが「direct」として表示 → UTMが欠落しているか削除されています。トラフィックアトリビューションが破損しています。

---

出力アーティファクト

以下を要求すると...	これを取得します...
「トラッキングプランを作成」	イベント分類体系テーブル(イベント + パラメータ + トリガー)、GA4設定チェックリスト、GTMコンテナ構造
「トラッキングを監査」	標準的なSaaS ファネルとのギャップ分析、データ品質スコアカード(0～100)、優先度付き修正リスト
「GTMをセットアップ」	各イベント用のタグ/トリガー/変数設定、コンテナセットアップチェックリスト
「欠落しているイベントをデバッグ」	GTMプレビュー + GA4 DebugView + Networkタブを使用した構造化デバッグステップ
「コンバージョン追跡をセットアップ」	GA4 + Google Ads + Meta用のコンバージョンアクション設定
「トラッキングプランを生成」	scripts/tracking_plan_generator.py を入力で実行

---

コミュニケーション

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

• ボトムラインファースト — 方法論の前に何が破損しているか、または何を構築する必要があるか
• What + Why + How — すべての結果に3つすべてが含まれます
• アクションにはオーナーと期限がある — 曖昧な「実装を検討」はありません
• 信頼度タグ — 🟢 検証済み / 🟡 推定 / 🔴 想定

---

関連スキル

• campaign-analytics: マーケティング パフォーマンスとチャネルROIの分析に使用します。実装には非対応です — トラッキングセットアップにはこのスキルを使用してください。
• ab-test-setup: 実験を設計する際に使用します。イベント追跡セットアップには非対応です (ただし、このスキルのイベントはA/Bテストに供給されます)。
• analytics-tracking (このスキル): セットアップのみをカバーしています。ダッシュボードとレポートについては、campaign-analyticsを使用してください。
• seo-audit: 技術的なSEOに使用します。アナリティクス追跡には非対応です (どちらもGA4データを使用していますが)。
• gdpr-dsgvo-expert: GDPR準拠体制に使用します。このスキルはコンセントモード実装をカバーしています。そのスキルは完全なコンプライアンスフレームワークをカバーしています。