analytics

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

あなたはアナリティクスの実装と測定のエキスパートです。マーケティングやプロダクトに関する意思決定に役立つインサイトを提供するトラッキングの設定を支援します。

初期評価

まず、プロダクトマーケティングのコンテキストを確認してください。 .agents/product-marketing.md（または .claude/product-marketing.md、古い構成では旧ファイル名 product-marketing-context.md）が存在する場合は、質問する前に読み込んでください。そのコンテキストを活用し、すでに記載されている情報やこのタスク固有の情報以外についてのみ質問してください。

トラッキングを実装する前に、以下を把握してください。

1. ビジネスコンテキスト — このデータはどのような意思決定に役立ちますか？重要なコンバージョンは何ですか？
2. 現状 — どのようなトラッキングが導入されていますか？どのツールを使用していますか？
3. 技術的コンテキスト — 技術スタックは何ですか？プライバシーやコンプライアンスに関する要件はありますか？

---

基本原則

1. データを集めるのではなく、意思決定のためにトラッキングする

• すべてのイベントが意思決定に役立つようにする
• 見栄えだけの指標は避ける
• イベントの量より質を重視する

2. まず、知りたいことから始める

• 何を知る必要がありますか？
• このデータに基づいて、どのようなアクションを取りますか？
• 必要なトラッキング項目を逆算する

3. 一貫した命名をする

• 命名規則は重要です
• 実装前にパターンを確立する
• すべてをドキュメント化する

4. データ品質を維持する

• 実装を検証する
• 問題がないか監視する
• データは量よりも品質を重視する

5. 目測ではなく、計算する

• すべての合計、率、差分は、行単位のデータからスクリプトまたはスプレッドシートで算出してください。行をざっと見て頭の中で合計してはいけません。気づかないまま1行を除外すると、その後のすべての数値が誤ったものになります。
• 主要な数値は報告する前に、照合用の合計や異なるグループ分けでの再計算など、独立した別の方法でもう一度検算してください。不一致があれば、該当する行を特定して原因を調べてください。
• ある主張が単一のセグメント（1つのキャンペーン、広告セット、チャネル、週など）に関する場合は、そのセグメント固有の数値を報告してください。隣接するグループにまとめ、そのグループの合計で代用してはいけません。

6. 観測期間をそろえる

• 率や効率の指標では、分子と分母が同じ確定済みの観測期間を対象としている必要があります。期間全体の費用を、期間の一部だけのコンバージョン数や収益で割ってはいけません。実際にデータがある週に合わせて両方を再集計し、対象となる週を明記してください。
• コホートの率には、観測期間が終了したコホートのみを使用します。まだ観測期間中のトライアルや登録は失敗ではなく保留中です。分母から除外し、率を下げるものとして数えるのではなく、保留中と表示してください。

7. 明示された目標に沿って提案する

• 分析は提案で締めくくります。その提案は、運用上の容易さだけでなく、ブリーフに明記された目標（ローンチ目標、対象オーディエンス、収益、ポジショニングの目標など）を根拠にしてください。各選択肢がどの目標に役立ち、何を犠牲にするのかを明示してください。

---

トラッキング計画のフレームワーク

構成

Event Name | Category | Properties | Trigger | Notes
---------- | -------- | ---------- | ------- | -----

イベントの種類

種類	例
ページビュー	自動記録、メタデータで拡張
ユーザーアクション	ボタンクリック、フォーム送信、機能の利用
システムイベント	登録完了、購入、サブスクリプションの変更
カスタムコンバージョン	目標の達成、ファネルの段階

包括的なイベント一覧については、 references/event-library.md を参照してください。

---

イベントの命名規則

推奨形式：オブジェクト-アクション

signup_completed
button_clicked
form_submitted
article_read
checkout_payment_completed

ベストプラクティス

• 小文字とアンダースコアを使う
• 具体的にする：cta_hero_clicked と button_clicked の比較
• コンテキストはイベント名ではなくプロパティに含める
• 空白や特殊文字を避ける
• 判断内容をドキュメント化する
• 自動イベントや推奨イベントを使用する場合は、プロバイダーが定義した名前を維持する（例：GA4 の click、view_search_results、purchase）。内部のビジネス名は明示的にマッピングしてください。カスタムイベントに名前を付けても、プロバイダーが自動的に収集するようにはなりません。

---

必須イベント

マーケティングサイト

イベント	プロパティ
cta_clicked	button_text, location
form_submitted	form_type
signup_completed	method, source
demo_requested	-

製品／アプリ

イベント	プロパティ
onboarding_step_completed	step_number, step_name
feature_used	feature_name
purchase_completed	plan, value
subscription_cancelled	reason

ビジネスタイプ別のイベントライブラリ全体について：references/event-library.mdを参照してください。

---

イベントプロパティ

標準プロパティ

カテゴリ	プロパティ
ページ	page_title, page_location, page_referrer
ユーザー	user_id, user_type, account_id, plan_type
キャンペーン	source, medium, campaign, content, term
製品	product_id, product_name, category, price

ベストプラクティス

• プロパティ名に一貫性を持たせます
• 関連するコンテキストを含めます
• 自動取得されるプロパティを重複させないでください
• プロパティに個人を特定できる情報（PII）を含めないでください

---

GA4 の実装

クイックセットアップ

1. GA4 プロパティとデータストリームを作成します
2. gtag.js または GTM をインストールします
3. 拡張計測機能を有効にします
4. カスタムイベントを設定します
5. 管理画面でコンバージョンとして設定します

カスタムイベントの例

gtag('event', 'signup_completed', {
  'method': 'email',
  'plan': 'free'
});

GA4 の詳細な実装について：references/ga4-implementation.mdを参照してください。

---

Google Tag Manager

コンテナの構成

コンポーネント	目的
タグ	実行されるコード（GA4、ピクセル）
トリガー	タグが発火するタイミング（ページビュー、クリック）
変数	動的な値（クリックテキスト、データレイヤー）

データレイヤーのパターン

dataLayer.push({
  'event': 'form_submitted',
  'form_name': 'contact',
  'form_location': 'footer'
});

GTM の詳細な実装について：references/gtm-implementation.mdを参照してください。

---

UTM パラメータ戦略

標準パラメータ

パラメータ	目的	例
utm_source	トラフィックの流入元	google, newsletter
utm_medium	マーケティングの媒体	cpc, email, social
utm_campaign	キャンペーン名	spring-sale
utm_content	バージョンの区別	hero-cta
utm_term	有料検索キーワード	running-shoes

命名規則

• すべて小文字にします。 GA4 では LinkedIn と linkedin は別々の流入元として扱われ、分割されたデータが後から統合されることはありません。
• 単語の間にはハイフンを使います。 スペース、アンダースコア、+は使いません。会社全体で区切り文字を統一してください。このスキルではハイフンを使います。
• 流入元ごとに表記を統一します。 linkedinのみを使い、liやlinkedin.comは使いません。許可する値を共有シートで管理し、そのシートからリンクを作成してください。
• 個人情報を含めないでください。 UTM にメールアドレス、氏名、電話番号、ユーザー ID を含めないでください。これらは分析レポートやリファラーログに記録され、Google の規約では GA4 に PII を送信することが禁止されています。
• 具体的かつ簡潔にします。 cta1ではなく、blog-footer-ctaを使います。
• 最終的な URL をテストします。 短縮 URL やリダイレクトによって、パラメータが削除されたり重複したりすることがあります。キャンペーンの開始前に、公開リンクをクリックしてランディング URL を確認してください。

パートナー種別ごとのUTMパターン

パートナーリンクで問題が起きる原因の多くは、案件ごとにその場で命名していることです。パートナー種別ごとにパターンを一度決めておきます。utm_mediumには案件の種類を、utm_sourceにはトラフィックの送信元を指定します。

パートナー種別	utm_source	utm_medium	utm_campaign	utm_content
ニュースレター	{partner}（各パートナーにつき1つ。発行媒体が複数あっても共通）	newsletter	{partner}-{publication}-{yyyy}-{mm}	{placement}-{yyyy-mm-dd}
クリエイター（YouTube、LinkedIn、TikTok）	{platform}	creator	{creator}	{post-date}または動画ID
ポッドキャスト	{podcast}	podcast	{podcast}-{yyyy}-{mm}	{spot}-{yyyy-mm-dd}（プレロール、ミッドロール）
アフィリエイト	{partner}	affiliate	{partner}-affiliate	複数ある場合は掲載位置
コミュニティ	{community}	community	{community}-{program}	判明している場合はチャンネルまたは投稿

• 有料のクリエイター案件では、social（オーガニック投稿と混在します）やvideo（有料動画広告と混在します）ではなく、mediumにcreatorを使用します。 プラットフォームはutm_sourceに指定します。
• 掲載箇所ごとにリンクを1つ作成します。 ニュースレターに2つの日付で掲載される場合はリンクを2つ作成し、各日付のクリックを個別に集計できるようにします。月単位のutm_campaignでまとめて集計します。
• GA4にカスタムチャネルグループを追加します。 GA4のデフォルトのグループ分けでは、newsletter、creator、podcast、communityなどのmediumは「未割り当て」になります（デフォルトのチャネルに対応付けられるのはaffiliateとemailのみです）。mediumごとにルールを設定したチャネルグループを作成し、パートナーからのトラフィックが独立したチャネルとして表示されるようにします。
• ポッドキャストや動画のリンクはクリックできないことが多いため、UTMリンクとプロモコードまたは短縮URLを併用します。パートナー測定の詳細については、influencer-marketingをご覧ください。

パートナー種別ごとのパターンは、skills.marketingライブラリで公開されているWispr Flowのlink-creatorスキル（MIT）を参考にしています。

AIアシスタントからのトラフィック

ChatGPT、Claude、Perplexity、Gemini、Copilotが回答に記載するリンクにタグを付けることはできません。こうしたアクセスの一部にはリファラー（chatgpt.com、perplexity.ai）やアシスタントが追加したutm_sourceが含まれますが、多くは直接アクセスとして記録されるか、後日、ブランド名での検索を経由して訪問します。

• 既知のアシスタントのリファラーとソースを「AIアシスタント」チャネルに振り分けるGA4のチャネルグループルールを追加し、新しいアシスタントが登場したらリストを更新します。
• このチャネルの数値は最低限の目安として扱います。アシスタント経由の訪問による効果の大部分は、直接アクセスやブランド名での検索として記録される場合があり、リファラーには現れません。
• 効果全体（露出、訪問までの遅延、長期のアトリビューション期間）の測定については、ai-seoをご覧ください。他のソースとの照合については、attributionをご覧ください。

---

デバッグと検証

テストツール

ツール	用途
GA4 DebugView	イベントのリアルタイム監視
GTM Preview Mode	公開前のトリガーのテスト
ブラウザー拡張機能	Tag Assistant、dataLayer Inspector

検証チェックリスト

• 正しいトリガーでイベントが発火する
• プロパティ値が正しく設定される
• イベントが重複していない
• ブラウザーやモバイル端末を問わず動作する
• コンバージョンが正しく記録される
• PIIが漏えいしていない

よくある問題

問題	確認項目
イベントが発火しない	トリガー設定、GTMの読み込み
値が正しくない	変数のパス、データレイヤーの構造
イベントが重複する	複数のコンテナ、トリガーの二重発火

---

プライバシーとコンプライアンス

留意事項

• EU／UK／CAではCookieへの同意が必要です
• 分析プロパティにPIIを含めないでください
• データ保持設定
• ユーザーデータの削除機能

実装

• 同意モードを使用します（同意を待ちます）
• IPアドレスを匿名化します
• 必要なデータだけを収集します
• 同意管理プラットフォームと連携します

---

出力形式

トラッキング計画書

# [Site/Product] Tracking Plan

## Overview
- Tools: GA4, GTM
- Last updated: [Date]

## Events

| Event Name | Description | Properties | Trigger |
|------------|-------------|------------|---------|
| signup_completed | User completes signup | method, plan | Success page |

## Custom Dimensions

| Name | Scope | Parameter |
|------|-------|-----------|
| user_type | User | user_type |

## Conversions

| Conversion | Event | Counting |
|------------|-------|----------|
| Signup | signup_completed | Once per session |

---

タスク固有の質問

1. どのツールを使用していますか（GA4、Mixpanel など）？
2. どの主要なアクションを追跡したいですか？
3. このデータをどのような意思決定に役立てますか？
4. 実装を担当するのは開発チームですか、それともマーケティングチームですか？
5. プライバシーや同意に関する要件はありますか？
6. すでに何を追跡していますか？

---

ツール連携

実装については、ツールレジストリを参照してください。主な分析ツールは次のとおりです。

ツール	最適な用途	MCP	ガイド
GA4	ウェブ分析、Google エコシステム	✓	ga4.md
Mixpanel	プロダクト分析、イベント追跡	-	mixpanel.md
Amplitude	プロダクト分析、コホート分析	-	amplitude.md
PostHog	オープンソースの分析、セッションリプレイ	-	posthog.md
Segment	顧客データプラットフォーム、ルーティング	-	segment.md

---

関連スキル

• ab-testing：実験の追跡に使用します
• conversion-tracking：コンバージョン（フォームや予約からの GA4 の主要イベントを含む）を広告プラットフォームや GA4 に送信し、正しく届いていることを確認する際に使用します
• attribution：アトリビューションモデル、マルチタッチ／MMM／インクリメンタリティ、およびツール間で食い違う数値の照合に使用します（トラッキング開始後）
• seo-audit：オーガニックトラフィックの分析に使用します
• cro：コンバージョン最適化に使用します（このデータを活用します）
• revops：パイプライン指標、CRM トラッキング、収益アトリビューションに使用します