gtm-reporting

GTM レポート - ドキュメント作成とインパクト分析

GTM トラッキング実装の包括的なドキュメントを作成し、レポートへの影響を分析します。

主な目的

技術的なトラッキング実装を、ビジネスに役立つドキュメントへと変換します。

1. 実装内容を説明する（技術ドキュメント）
2. 新たに得られるインサイトを示す（レポートへの影響）
3. 作成を推奨する具体的なレポートを提案する（GA4 の設定）
4. 価値の高いオーディエンスを定義する（リマーケティング／セグメンテーション）
5. イベントをビジネス価値に結び付ける（ステークホルダー向けサマリー）

ワークフロー

フェーズ 0：ビジネスコンテキストの読み込み（利用可能な場合）

プロジェクトのルートディレクトリにある gtm-context.md を確認します。

• 見つかった場合：ファイルを読み込みます（この操作については通知しません）。このスキルの実行中はビジネスコンテキストを使用します（サイトの種類、目標、レポートのステークホルダーに応じて、エグゼクティブサマリーのトーンとレポートの選定を調整します）。
• 見つからない場合：通常どおり進め、ワークフロー中にコンテキストについて質問します。

このファイルは、gtm-analytics-audit の初回実行の最後に自動作成されます。

フェーズ 1：コンテキストの読み込み

ステップ 1.1：実装の詳細を読み込む

Check for implementation artifacts:
- gtm-tracking-plan.json (from gtm-strategy)
- gtm-implementation-log.json (from gtm-implementation)
- gtm-test-results.json (from gtm-testing)

If missing → Ask user to describe what was implemented

ステップ 1.2：実装範囲を分析する

Extract key information:
- Events implemented (names, parameters)
- Elements tracked (CTAs, forms, navigation, etc.)
- Business model (SaaS, e-commerce, lead-gen)
- Primary goals (conversions, engagement, leads)

フェーズ 2：技術ドキュメントの作成

開発者やアナリスト向けに、包括的な実装ドキュメントを作成します。

ドキュメント 2.1：イベントスキーマのドキュメント

# GTM Tracking Implementation - Event Schema

Last Updated: [Date]
GTM Container: GTM-XXXXXX
Implementation Version: 1.0

## Events Overview

This document describes all custom events implemented in Google Tag Manager.

### Event: cta_click

**Description**: Fires when a user clicks any call-to-action button on the site

**Trigger**: Custom Event "cta_click"

**Parameters**:
| Parameter | Type | Description | Example Values | Required |
|-----------|------|-------------|----------------|----------|
| cta_location | string | Section of page where CTA is located | "hero", "pricing", "footer" | Yes |
| cta_type | string | Visual style of CTA | "primary", "secondary", "text" | No |
| cta_text | string | Text content of button | "Get Started", "Book Demo" | Yes |
| cta_destination | string | Target URL or action | "/signup", "/pricing" | Yes |

**Sample DataLayer Push**:
```javascript
{
  event: 'cta_click',
  cta_location: 'hero',
  cta_type: 'primary',
  cta_text: 'Get Started',
  cta_destination: '/signup'
}

GTM の設定：

• 変数：DLV - CTA Location、DLV - CTA Type、DLV - CTA Text、DLV - CTA Destination
• トリガー：CE - CTA Click
• タグ：GA4 - CTA Click

トラッキング対象の要素：サイト全体で 12 個の CTA ボタン

---

イベント：form_submit

説明：ユーザーがサイト上のフォームを送信したときに発火します

トリガー：カスタムイベント「form_submit」

パラメーター：

パラメーター	型	説明	値の例	必須
form_name	string	フォームを識別する値	"contact"、"newsletter"、"demo"	はい
form_location	string	フォームが配置されているページのセクション	"hero"、"footer"、"sidebar"	はい
form_type	string	フォームの目的／カテゴリ	"contact_request"、"email_capture"	はい

DataLayer のプッシュ例：

{
  event: 'form_submit',
  form_name: 'newsletter',
  form_location: 'footer',
  form_type: 'email_capture'
}

GTM の設定：

• 変数：DLV - Form Name、DLV - Form Location、DLV - Form Type
• トリガー：CE - Form Submit
• タグ：GA4 - Form Submit

トラッキング対象の要素：サイト全体で 3 個のフォーム

[すべてのイベントについて続けます…]

**Document 2.2: Implementation Summary**

```markdown
# GTM Implementation Summary

## Overview

This document summarizes the GTM tracking implementation completed on [Date].

## Scope

**Events Implemented**: 5 custom events
**Elements Tracked**: 23 total elements
- 12 CTA buttons
- 8 navigation links
- 3 forms

**Code Changes**: 8 files modified

## Technical Stack

- Framework: Next.js 16.1.6 (App Router)
- GTM Container: GTM-XXXXXX
- GA4 Property: [Property ID]
- Implementation Method: DataLayer + GTM API

## Events Summary

| Event Name | Purpose | Elements | Priority |
|------------|---------|----------|----------|
| cta_click | Track conversion intent via CTA clicks | 12 | P0 |
| form_submit | Capture lead submissions | 3 | P0 |
| form_start | Measure form abandonment | 3 | P0 |
| navigation_click | Understand user journey | 8 | P1 |
| video_play | Measure content engagement | 1 | P1 |

## GTM Configuration

**Created via API**:
- 12 Data Layer Variables
- 5 Custom Event Triggers
- 5 GA4 Event Tags

**Container Version**: 42
**Published**: [Date]

## Files Modified

1. `app/page.tsx` - Added CTA and form tracking (4 elements)
2. `components/Navbar.tsx` - Added navigation tracking (5 elements)
3. `components/Footer.tsx` - Added navigation and form tracking (4 elements)
... [list all files]

## Testing Status

All events validated across 3 tiers:
✓ Tier 1: Browser Console (dataLayer)
✓ Tier 2: GTM Preview Mode
✓ Tier 3: GA4 DebugView

## Maintenance

**Adding New Tracking**:
1. Add analytics classes to element (js-track js-cta js-click js-location)
2. Implement dataLayer.push() in onClick handler
3. Create GTM variable/trigger/tag (or use existing)
4. Test in Preview mode
5. Publish container

**Modifying Existing Tracking**:
1. Update dataLayer.push() parameters in code
2. Update GTM tag event parameters if needed
3. Test and publish

## Support

For questions or issues, contact: [Technical Owner]

フェーズ 3：レポートへの影響分析

このトラッキングで新たに利用できるレポートやインサイトを分析します。

分析 3.1：利用可能になった GA4 レポート

# Reporting Capabilities - GA4

## New Reports Enabled by Implementation

### 1. CTA Performance Dashboard

**Purpose**: Understand which CTAs drive conversions

**Metrics**:
- CTA clicks by location (hero vs pricing vs footer)
- CTA clicks by type (primary vs secondary)
- CTA click-through rate by page
- CTA → Form submission conversion rate

**How to Build**:
1. GA4 → Explore → Free Form
2. Dimensions: Event name, CTA location, CTA type, CTA text
3. Metrics: Event count, Conversions
4. Segment: Users who clicked CTA → Users who submitted form

**Business Value**: Optimize CTA placement and copy based on conversion data

---

### 2. Form Funnel Analysis

**Purpose**: Measure form abandonment and completion

**Funnel Steps**:
1. form_start (user begins filling form)
2. form_submit (user submits form)
3. /thank-you (confirmation page view)

**Metrics**:
- Abandonment rate: (form_start - form_submit) / form_start
- Completion rate: form_submit / form_start
- Average time to complete: form_submit timestamp - form_start timestamp

**How to Build**:
1. GA4 → Explore → Funnel Exploration
2. Step 1: form_start
3. Step 2: form_submit
4. Step 3: page_view (page_location contains /thank-you)
5. Breakdown by form_name

**Business Value**: Identify form friction points and improve conversion rates

---

### 3. User Journey Mapping

**Purpose**: Understand how users navigate the site

**Path Analysis**:
- Entry page → First navigation click → Second click → Conversion
- Most common paths to pricing page
- Navigation patterns of converting vs non-converting users

**How to Build**:
1. GA4 → Explore → Path Exploration
2. Starting point: page_view OR navigation_click
3. Step types: Events and pages
4. Ending point: form_submit OR trial_start

**Business Value**: Optimize site structure and content flow based on user behavior

[Continue for all report types...]

分析 3.2：カスタムダッシュボード

具体的なダッシュボード設定を提案します。

## Recommended Dashboards

### Executive Dashboard: Conversion Overview

**Audience**: C-suite, Marketing leadership

**Metrics** (Weekly):
- Total CTA clicks (trend)
- Form submissions (trend)
- CTA → Form conversion rate
- Top converting CTAs (by location)
- Form abandonment rate

**Format**: Looker Studio dashboard

**Value**: High-level conversion health monitoring

---

### Marketing Dashboard: Campaign Performance

**Audience**: Marketing team

**Metrics** (Daily):
- CTA clicks by traffic source (organic, paid, social)
- Form submissions by campaign
- Cost per form submission (CPC data + form_submit count)
- Landing page → CTA → Form funnel by campaign

**Format**: GA4 Custom Report

**Value**: Measure campaign ROI and optimize spend

---

### Product Dashboard: Engagement Metrics

**Audience**: Product team

**Metrics** (Weekly):
- Navigation patterns (top clicked links)
- Video engagement (play rate, completion rate)
- Feature page views → CTA clicks
- Time on site by engagement level

**Format**: GA4 Explorations

**Value**: Understand product interest and optimize content

フェーズ 4：オーディエンスの定義

トラッキング対象のイベントに基づいて、価値の高いリマーケティングオーディエンスを定義します。

オーディエンス 4.1：リマーケティングオーディエンス

# Remarketing Audience Definitions

## Audience: High-Intent Visitors

**Criteria**:
- Clicked pricing CTA (cta_click where cta_destination = /pricing)
  OR
- Submitted contact form (form_submit where form_type = contact_request)

Within last 7 days

**Size Estimate**: 5-10% of traffic

**Business Value**: Users showing strong purchase intent

**Remarketing Strategy**:
- Message: Case studies, testimonials, urgency ("Limited time offer")
- Channel: Google Ads, Facebook Ads
- Bid adjustment: +50% (high conversion probability)

**Expected ROI**: 3-5x higher conversion rate vs cold traffic

---

## Audience: Demo Requesters

**Criteria**:
- Clicked "Book Demo" CTA (cta_click where cta_text contains "Demo")
  OR
- Submitted demo form (form_submit where form_name = demo)

Within last 14 days

**Size Estimate**: 1-3% of traffic

**Business Value**: Highest-intent audience, sales-ready

**Use Cases**:
1. Sales follow-up priority list
2. Email nurture sequence
3. Retargeting with customer success stories

**Expected ROI**: 10-20x higher conversion rate

---

## Audience: Engaged Browsers

**Criteria**:
- Viewed 3+ pages
  AND
- Clicked 2+ CTAs (any type)
  AND
- Time on site > 2 minutes

Within last 30 days

**Size Estimate**: 15-20% of traffic

**Business Value**: Researching actively, not yet converted

**Remarketing Strategy**:
- Message: Educational content, comparison guides
- Channel: Display ads, email (if captured)
- Goal: Move to high-intent with valuable content

**Expected ROI**: 2-3x higher conversion rate

[Continue for all audience definitions...]

フェーズ 5：ステークホルダー向けサマリー

ビジネスのステークホルダー向けに、技術的な内容を含まないサマリーを作成します。

サマリー 5.1：エグゼクティブサマリー

# GTM Tracking Implementation - Executive Summary

## What We Built

We implemented comprehensive website analytics tracking that captures user behavior across all key conversion points.

## What This Means for the Business

### Before
- Limited visibility into which marketing efforts drive conversions
- No data on where users drop off in conversion funnel
- Guesswork for website optimization decisions
- Unable to identify high-value visitors for remarketing

### After
- Full visibility into user journey from landing to conversion
- Precise data on CTA performance and form abandonment
- Data-driven optimization of website and campaigns
- Ability to target high-intent visitors with personalized messaging

## Key Capabilities Unlocked

1. **CTA Optimization** ($)
   - See which call-to-action buttons drive conversions
   - A/B test button copy and placement with real data
   - **Impact**: 10-30% increase in conversion rate typical

2. **Form Funnel Analysis** ($$)
   - Identify exactly where users abandon forms
   - Reduce friction, improve completion rates
   - **Impact**: 5-15% increase in leads typical

3. **Campaign Attribution** ($$$)
   - Know which campaigns drive qualified leads
   - Optimize ad spend based on conversion data
   - **Impact**: 20-40% improvement in CAC typical

4. **High-Intent Audiences** ($$)
   - Target visitors who clicked pricing or requested demo
   - 3-5x higher conversion rate on retargeting
   - **Impact**: Significant ROI improvement on ad spend

## Investment vs Return

**Implementation Cost**:
- Time: 8 hours total (mostly automated)
- Ongoing: No additional cost (built on existing GA4/GTM)

**Expected Annual Value**:
- Improved conversion rates: $XXk-XXXk (depends on traffic)
- Reduced CAC from better targeting: $XXk
- Time saved vs manual reporting: $XXk

**ROI**: 10-50x typical (based on industry benchmarks)

## Next Steps

1. **Week 1-2**: Monitor data collection, validate accuracy
2. **Week 3-4**: Build recommended dashboards
3. **Month 2**: Launch remarketing to high-intent audiences
4. **Month 3**: Begin A/B testing CTAs based on data

## Questions?

Contact [Technical Owner] for implementation details or [Marketing Owner] for strategic questions.

フェーズ 6：成果物の生成

以下のドキュメントファイルをすべて生成します。

作成するファイル：

1. gtm-event-schema.md - 技術的なイベントドキュメント
2. gtm-implementation-summary.md - 実装の概要
3. gtm-reporting-capabilities.md - 利用可能になったレポートとインサイト
4. gtm-audience-definitions.md - リマーケティングオーディエンスの仕様
5. gtm-executive-summary.md - ステークホルダー向けサマリー（技術的な内容を含まない）

命名規則：すべてのファイル名の先頭に gtm- を付けると、簡単に識別できます。

フェーズ 7：次のステップの提案

実行可能な次のステップを提案します。

=== GTM Implementation Documentation Complete ===

Documentation generated:
✓ Event schema (technical)
✓ Implementation summary
✓ Reporting capabilities analysis
✓ Audience definitions
✓ Executive summary (stakeholder-friendly)

All files saved to project root.

--- Recommended Next Steps ---

Week 1-2: Data Validation
[ ] Monitor events in GA4 Reports (not DebugView)
[ ] Verify event counts match expectations
[ ] Check that parameters are populating correctly
[ ] Identify any gaps or issues

Week 3-4: Build Dashboards
[ ] Create CTA Performance dashboard in Looker Studio
[ ] Set up Form Funnel in GA4 Explorations
[ ] Build User Journey path analysis
[ ] Configure conversion tracking

Month 2: Activate Audiences
[ ] Create "High-Intent Visitors" audience in GA4
[ ] Export to Google Ads for remarketing
[ ] Set up personalized ad campaigns
[ ] Monitor performance vs cold traffic

Month 3: Optimize & Iterate
[ ] A/B test top-performing CTAs (new copy/placement)
[ ] Optimize forms based on abandonment data
[ ] Adjust marketing spend based on attribution data
[ ] Refine audience definitions based on conversion data

--- Support Resources ---

Technical Documentation: See gtm-event-schema.md
Business Case: See gtm-executive-summary.md
Reporting Guide: See gtm-reporting-capabilities.md

Questions? Review documentation or contact implementation team.

アセット

assets/doc-templates/implementation-summary.md

技術的な実装ドキュメントのテンプレート

assets/doc-templates/stakeholder-summary.md

エグゼクティブ／ビジネスサマリーのテンプレート

重要なガイドライン

ドキュメント作成の原則

1. 2 つの読者層、2 つの形式：

• 技術ドキュメント（エンジニア、アナリスト向け）：詳細、コード例、スキーマを含めます
• ビジネスドキュメント（経営幹部、マーケティング担当者向け）：概要を重視し、ROI に焦点を当て、専門用語は使いません

2. 実行可能な推奨事項：

• トラッキングを説明するだけでなく、データをどう活用するかも説明します
• 一般的なアイデアではなく、具体的なレポート設定を提示します
• 推奨事項ごとに期待されるビジネスへの効果を記載します

3. 現実的な ROI の推定値：

• 業界ベンチマークまたは保守的な前提に基づいて推定します
• 算出方法を説明します（例：「CTA の最適化によるコンバージョン率の向上は、一般的に 10% です」）
• 過大な約束は避け、控えめに見積もって期待を上回る成果を目指します

4. メンテナンスの重視：

• 新しいトラッキングを追加する手順を含めます
• GTM の設定の場所を記載します
• よくある問題のトラブルシューティングを提示します

技術向けからビジネス向けへの翻訳

技術向け：「4 つのパラメーターを持つ cta_click イベントを実装しました」

ビジネス向け：「どの行動喚起ボタンがコンバージョンにつながるかを追跡できるようになりました。これにより、ボタンの文言や配置をデータに基づいて最適化できます（コンバージョン率は一般的に 10～30% 向上します）」

技術向け：「form_start イベントと form_submit イベントを作成しました」

ビジネス向け：「フォームの離脱を測定して、ユーザーの障壁を特定し、見込み客の獲得を改善できます（フォーム完了数は一般的に 5～15% 増加します）」

技術向け：「ナビゲーションのトラッキング用に 3 つの Data Layer Variables を設定しました」

ビジネス向け：「サイト内のユーザージャーニーを把握し、コンテンツの流れを最適化してエンゲージメントを高めます」

補助ファイル

• template.md - Claude が記入するドキュメントテンプレート（event-schema、implementation-summary、reporting-capabilities、audience-definitions、executive-summary）
• examples/sample.md - コンソール出力と event-schema.md の抜粋を含むレポート出力の例

実行チェックリスト

• 実装の詳細を読み込み済み
• イベントスキーマのドキュメントを作成済み
• 実装概要を作成済み
• レポート機能を分析済み
• GA4 のレポート設定を指定済み
• オーディエンスの定義を記載済み
• ROI の推定値を算出済み
• エグゼクティブサマリーを作成済み
• 次のステップの推奨事項を提示済み
• すべてのドキュメントファイルを保存済み

よくある質問

Q：どのドキュメントを誰に渡せばよいですか？ A：技術ドキュメント → エンジニア／アナリスト。エグゼクティブサマリー → ビジネス関係者。レポートガイド → マーケティングチーム。

Q：ドキュメントはどのくらいの頻度で更新すべきですか？ A：イベントを追加または変更したときに更新してください。正確さを保つため、四半期ごとに見直してください。

Q：テンプレートをカスタマイズできますか？ A：できます。テンプレートは出発点です。組織のニーズに合わせて調整してください。

Q：ROI の推定値がわからない場合はどうすればよいですか？ A：業界ベンチマーク（コンバージョン率の向上は一般的に 10～30%）を使用するか、推定値を省いて機能に焦点を当ててください。