analytics-tracking

概要

analytics-tracking スキルでできること

analytics-tracking スキルは、アナリティクス計測の設計・実装・監査を支援し、データを信頼してマーケティングやプロダクトの意思決定ができる状態をつくるためのスキルです。主に以下にフォーカスしています。

• ビジネス上の問いを、計測可能なイベントに落とし込む
• 分かりやすく一貫性のあるイベント名・パラメータ設計（ネーミング規約）を行う
• Google Analytics 4 (GA4) と Google Tag Manager (GTM) への計測実装
• 明確なアトリビューションのための UTM parameters とキャンペーン構造の設計
• レポーティングやパフォーマンス分析につながる tracking plan の構築

無造作にクリックやページビューを集めるのではなく、サイト・プロダクト・キャンペーンごとに「これはうまくいっているのか？」という問いに答えられるイベントに絞り込むのが analytics-tracking の役割です。

このスキルが役立つユーザー

analytics-tracking は次のような立場の方に有効です。

• キャンペーンの成果を正確に測りたい マーケティングマネージャー
• 機能の利用状況やアクティベーションを理解したい プロダクトマネージャー
• 施策や実験が効いているかを測りたい ファウンダー や グロース担当
• フロントエンドやタグマネージャーでイベント実装を任されている 開発者
• ダッシュボードやレポートのために、クリーンで一貫したイベントデータが必要な アナリスト

特に、GA4、GTM、Google Ads、Google Sheets、Google Docs で tracking plan を扱うなど、Google 系ツールを中心に利用しているチームに向いています。

analytics-tracking スキルが解決する課題

このスキルは、チームの誰かが次のようなことを言い出す状況を想定して設計されています。

• 「GA4 は入れたけど、数字をあまり信用できない」
• 「イベントがバラバラで統一感がない」
• 「新しい機能やファネルで、何をトラッキングすべきか分からない」
• 「UTM がバラバラで、どのチャネルが効いているのか見えない」
• 「GTM は動いているけれど、イベントの設定が正しいか自信がない」

リポジトリ内の各種リファレンスを活用して、このスキルは以下をサポートします。

• 現状の計測環境に対する 初期診断（initial assessment）
• 「データのためではなく、意思決定のためにトラッキングする」 という原則の適用
• 分かりやすいイベント名・トリガー・パラメータを備えた tracking plan の新規作成や改善
• gtag.js や GTM を使った GA4 イベント実装
• マーケティングサイト、SaaS、EC などビジネスモデルに合わせた、堅牢な event library の活用

analytics-tracking が向いているケース／向いていないケース

analytics-tracking が特にフィットするのは、次のようなケースです。

• GA4 + GTM の新規構築や改善 を行いたい
• イベント計測、コンバージョン、アトリビューション を設計・監査したい
• UTM 戦略 を定義したり、キャンペーン名を標準化したい
• サインアップや機能利用、アップグレードなどの プロダクトアナリティクス用イベント を設計したい

逆に、次のような場合はこのスキルが主役ではありません。

• A/B テストの設計と計測 のみが必要な場合（その場合は別スキル ab-test-setup を利用）
• データウェアハウスでの高度なモデリングや、BI 専用の分析が中心な場合（このスキルは SQL モデリングではなくインストルメンテーション／実装にフォーカスしています）

チームのメインの問いが「どうやってこれを計測すべきか？」「これがうまくいっているとどう分かるか？」であれば、analytics-tracking が適切な選択です。

リポジトリ内の主な参照ファイル

analytics-tracking スキルは、以下のような用途別リファレンスに支えられています。

• SKILL.md – スキルの中核となる挙動定義。初期診断ステップや基本原則を記載
• references/event-library.md – マーケティングサイト、プロダクト、マネタイズ、EC、B2B/SaaS などコンテキスト別の event library
• references/ga4-implementation.md – GA4 のセットアップと実装に関する詳細ガイド
• references/gtm-implementation.md – Google Tag Manager の構造と実装に関する詳細ガイド
• evals/evals.json – 具体的なシナリオと、望ましいベストプラクティス回答の例（SaaS 用 tracking plan や UTM 規約など）

これらのファイルにより、一般論ではなく、実装にそのまま使えるレベルの具体的なガイダンスを提供できます。

使い方

インストールとセットアップ

1. analytics-tracking スキルをインストールする

coreyhaines31/marketingskills リポジトリから Skills CLI を使ってスキルを追加します。

npx skills add https://github.com/coreyhaines31/marketingskills --skill analytics-tracking

これにより、analytics-tracking の設定・評価用プロンプト・各種リファレンスが取り込まれ、エージェントが実装寄りの詳細な回答を返せるようになります。

2. 同梱されているリファレンスを確認する

インストール後、コンテキスト把握のために以下のファイルを環境内で開いてください。

• SKILL.md – スコープ、前提、基本原則の理解
• references/event-library.md – 推奨イベントとパラメータの一覧
• references/ga4-implementation.md – GA4 の設定方法、カスタムイベント、コンバージョン、デバッグ手順
• references/gtm-implementation.md – コンテナ構造、トリガー、変数、data layer の使い方
• evals/evals.json – プロンプト例と期待される出力フォーマット（tracking plan など）

これらは「コピペ用チェックリスト」ではなく、テンプレート兼ガードレールとして使ってください。自社のプロダクト、コンプライアンス要件、技術スタックに合わせて調整する前提です。

このスキルが支援する主なワークフロー

1. ゼロから tracking plan を設計する

たとえば次のようにエージェントへ指示します。

「B2B SaaS プロダクトの GA4 + GTM 用 tracking を設計したいです。サインアップ、機能利用、アップグレードイベントを計測したい。」

analytics-tracking スキルは次のように動きます。

1. プロダクトマーケティングのコンテキストを確認

   • .agents/product-marketing-context.md （または旧 .claude/product-marketing-context.md）が存在する場合、まずそれを参照し、同じ質問を繰り返さないようにします。

2. 「データのためではなく意思決定のためにトラッキングする」原則の適用

   • 「どの機能がアップグレードを促しているか？」「どのチャネルがトライアル登録を生んでいるか？」など、意思決定で知りたいことを明確にします。

3. コアイベントとネーミング規約の定義

   • signup_completed などの object_action 形式のイベント命名規約を用います（例：signup_completed、feature_used、plan_upgraded）。
   • references/event-library.md から、次のような SaaS 向けイベントを参照します。
     • signup_completed
     • trial_started
     • feature_used
     • plan_upgraded
     • subscription_canceled

4. 構造化された tracking plan の作成

   • Google Sheets や Docs にそのまま貼れるような「テーブル形式」で出力し、以下を含めます。
     • Event name
     • Trigger（どのユーザー行動で発火するか）
     • Parameters（例：plan_name、feature_name、pricing_page_variant）
     • そのイベントが支える目的／意思決定

5. GA4 実装の詳細を提示

   • 推奨パラメータを含む GA4 イベント設定や、どのイベントをコンバージョンに指定すべきかなどを提案します。

6. GTM data layer パターンの提示

   • フロントエンド側で使える dataLayer.push のコード例と、それを GA4 Event タグにどう結びつけるかを具体的に示します。

このワークフローは、新規プロダクトローンチやファネルのリデザイン、レガシーな計測の整理などに特に有効です。

2. 既存の GA4 / GTM 実装を監査する

次のような問いかけを行うケースです。

「GA4 のデータがどうもおかしく見えます。トラッキングの監査を手伝ってもらえますか？」

この場合、スキルは次のようなステップを案内します。

• 現状の data streams と enhanced measurement の確認（references/ga4-implementation.md）
• conversion 設定、custom dimensions、audiences に誤設定がないかチェック
• GTM の container structure、tag naming、triggers、variables を確認（references/gtm-implementation.md）
• DebugView や GTM の Preview モードでイベントを検証
• 現在のイベント一覧を event library と突き合わせ、不足や重複を洗い出し

その上で、イベント統合、パラメータ名の整理、トリガーの標準化などの優先度を付けた改善案に落とし込みます。

3. UTM parameters とアトリビューション設計

次のような質問を想定しています。

「Google Ads、Meta、LinkedIn、ニュースレター用に、どんな UTM parameters を使うべきでしょうか？」

evals/evals.json の評価ガイドラインに基づき、analytics-tracking は次を支援します。

• utm_source、utm_medium、utm_campaign、utm_term、utm_content など、一貫した UTM 戦略の提案
• 次のようなチャネル別の推奨値例の提示：
  • utm_source: google, meta, linkedin, newsletter
  • utm_medium: cpc, paid_social, email, social
• GA4 でクリーンに集計できるよう、プラットフォームをまたいだ campaign naming の標準化 を支援
• UTMs が GA4 側で正しく取得・反映されているかを確認する方法を説明

こうしたルールを Google Sheets や社内 playbook にまとめることで、チーム全体でブレない運用ができます。

4. 開発チームへの引き継ぎ用ドキュメント作成

戦略レベルの tracking plan を、実装手順に落とし込みたい場合に、analytics-tracking は次のように役立ちます。

• tracking plan を元に、以下のような成果物を生成：
  • GTM data layer specs（例：dataLayer.push({ event: 'feature_used', feature_name: 'bulk_import' })）
  • どの frontend code にこれらの呼び出しを追加すべきかの注記
  • 対応する GA4 Event tags とトリガーを GTM 上でどう設定するかのガイド

特にフロントエンドエンジニアに対して、「どのイベント名を、どのパラメータ構造で、どのタイミングで発火させるべきか」を明示するのに向いています。

よい結果を得るためのコツ

• 最初にコンテキストを共有する: プロダクトタイプ（SaaS、EC、マーケットプレイスなど）、主要なビジネスゴール、利用ツール（GA4 only / GA4 + GTM / Segment など）を伝えてください。
• 意思決定を明確にする: 「どのチャネルがサインアップを生んでいるか」「機能 X はリテンションを高めているか」など、知りたいことを具体的にしましょう。
• 制約条件を伝える: プライバシーやコンプライアンス要件（例：同意管理、データ保持期間など）がある場合は事前に共有することで、現実的な tracking plan になります。
• 段階的に進める: まずは少数のコアイベントから始め、実装と学びに合わせて、スキルに改善や拡張を依頼する形で iterartion していきます。

FAQ

analytics-tracking と ab-test-setup はどう使い分ければいいですか？

analytics-tracking を使うべきなのは、次のような場合です。

• イベント、コンバージョン、UTM、GA4/GTM 設定 といった、計測の土台を設計・修正したいとき
• 「この機能・ページ・キャンペーンをどう計測すればいいか？」という問いに答えたいとき

一方で ab-test-setup を使うべきなのは、主な関心が次の場合です。

• A/B テスト の構成、バリアント、実験指標の設計
• 実験の計測が統計的に適切か、クリーンに行えているかの確認

現実的には、まず analytics-tracking でベースとなる計測基盤を整え、その上に A/B テスト計測を ab-test-setup で積み重ねていく使い方が一般的です。

analytics-tracking はどのツールを中心にカバーしていますか？

リポジトリ内のリファレンスに基づき、analytics-tracking は Google analytics stack に最適化されています。

• Google Analytics 4 (GA4) – 設定、カスタムイベント、コンバージョン、オーディエンス、デバッグ
• Google Tag Manager (GTM) – コンテナ構造、トリガー、変数、data layer パターン
• Google Ads 連携 – GA4 とのリンクやコンバージョンインポート（GA4 implementation ガイドで解説）

Mixpanel や Segment など、より広いアナリティクス文脈にも概念的には対応しています（イベント・プロパティ・tracking plan など）。ただし、実装レベルで最も具体的なガイドがあるのは GA4 + GTM です。

フロントエンド実装の細かい部分まで助けてもらえますか？

一定レベルまでは可能です。このスキルは次のような支援を行えます。

• フロントエンド計測に適した イベント名とパラメータ設計 の提案
• GTM 向けの dataLayer.push パターンのサンプルコード提示
• ボタンクリック、フォーム送信、ページロードなど、イベントが一般的にどのタイミングで発火するかの説明

一方で、React hooks や Vue components など、特定フレームワーク固有のコード実装については、開発者の判断が必要になることもあります。ただし analytics-tracking が「何を」「どのような形で」実装すべきかの青写真を提供するため、開発者はそれを元にコードへ落とし込みやすくなります。

GA4 / GTM のガイドはどの程度詳しいですか？

GA4 と GTM のリファレンスは比較的詳細で、次の内容をカバーしています。

• GA4 (references/ga4-implementation.md) では：

  • Data streams と enhanced measurement
  • 推奨イベント（EC 系イベントを含む）
  • Conversions、イベントパラメータ、カスタムディメンション／指標
  • オーディエンスの作成とデバッグツール
  • データ品質の観点や Google Ads 連携

• GTM (references/gtm-implementation.md) では：

  • Tags、triggers、variables
  • コンテナの命名規約
  • Data layer パターン
  • よくある GA4 や各種ピクセルタグのセットアップ
  • Preview / debugging、ワークスペース、バージョン管理

スキルはこれらを踏まえ、単なる概念レベルではなく、実装にそのまま使えるレベルのガイダンスを提供します。

自社ビジネス向けに、トラッキングすべきイベントを完全に指定してくれますか？

このスキルは、特にマーケティングサイト、SaaS、EC などに対して、event library とベストプラクティスに基づいた強めの推奨セットを提示します。ただし最終的には、次のような点について追加の質問を行います。

• ビジネスモデルや料金体系
• コアとなるコンバージョンアクション
• 主要な獲得チャネル
• 重要なユーザージャーニーや機能

これにより、画一的なイベント一覧ではなく、実際の意思決定とユーザーフローにきちんと紐づいた tracking plan になるよう調整します。

Google Sheets や Docs と一緒に使うには？

多くのチームが、tracking plan を Google Sheets や Google Docs で管理しています。analytics-tracking を使うと次のようなことができます。

• シートにそのまま貼り付けられる「テーブル形式」の tracking plan を依頼
• 社内ドキュメントに使える、パラメータ辞書やネーミング規約一覧の生成
• 実装を進めながら、エージェントと対話形式で tracking plan を継続的に改善

これにより、マーケター・プロダクトマネージャー・アナリスト・開発者の間で共有できる「生きたソース・オブ・トゥルース」をつくることができます。

「アナリティクスがうまく動いていない」またはイベントが発火していないときは？

「GA4 にイベントが出てこない」「コンバージョン数が合わない」「GTM のプレビューでタグが出ない」など、症状をそのまま伝えてください。analytics-tracking は次のようなステップで案内します。

• GTM の Preview でタグ発火状況を確認
• dataLayer のイベントやパラメータが正しく送信されているか検証
• GA4 の DebugView とリアルタイムレポートの確認
• コンバージョンが正しく定義され、データを受け取れているかの確認

そのうえで、GA4 / GTM リファレンスに基づき、具体的なデバッグ手順や設定チェックのポイントを示していきます。