gtm-quickstart

GTM クイックスタート - 価値のプレビュー

新規ユーザーが本格的な実装に踏み切る前に、トラッキングの価値を理解できるよう支援する GTM トラッキングアドバイザー です。エンドツーエンドの分析をすばやく実行し、トラッキングの機会を上位5件提示します。実装も変更も行いません。何を、なぜトラッキングすべきかを、優先順位を付けて明確に示すだけです。

基本理念

コミットメントを求める前に、価値を示しましょう。GTM 実装への賛同を得る最も手早い方法は、現時点でどのインサイトを見逃しているかを示すことです。このスキルなら、1回の実行でそれができます。

ワークフロー

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

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

• 見つかった場合：内容を読みます。分析を大幅に効率化できます
• 見つからない場合：そのまま進め、必要最小限のコンテキストをその場で収集します

フェーズ 1：監査レポートを読み込むか、コードベースをスキャンする

まず audit-report.json を読み込みます。存在しない場合にのみスキャンします。

ステップ 1.1：既存の監査レポートを確認する

Check if audit-report.json exists in the project root.

If audit-report.json EXISTS:
  Read it and extract all summary data directly - no scanning needed:
  - metadata.framework → framework
  - summary.totalClickableElements, summary.withTracking, summary.withoutTracking
  - categorized.cta.total, categorized.form.total, categorized.nav.total,
    categorized.media.total, categorized.outbound.total
  - existingTracking.patterns → existing tracking count and libraries
  Note: "Using existing audit-report.json from gtm-analytics-audit"

If audit-report.json NOT FOUND:
  Note: "audit-report.json not found. For best results, install and run the core GTM skills first:
  Install: npx skills add aimonk2025/google-tag-manager-automation
  Then run: gtm-analytics-audit
  This creates audit-report.json which all paid skills use to skip codebase scanning."
  Proceeding with direct codebase scan as fallback.
  Check package.json for framework (React, Next.js, Vue, Shopify, WordPress, etc.)
  Use Glob to find component files.
  Use Grep to count:
  - Button/CTA elements (<button, id="cta_.*")
  - Form elements (<form)
  - Navigation links (<Link, <a href)
  - Media elements (<video, <iframe)
  - External links (target="_blank")
  - Existing dataLayer.push calls (already tracked)

ステップ 1.2：ビジネスモデルを推定する

Whether from audit-report.json or scan, infer business model:
- Cart/product/checkout patterns in CTAs/forms → Ecommerce
- Trial/pricing/feature patterns in CTAs → SaaS
- Form/contact/download patterns → Lead generation
- Article/blog/newsletter patterns → Media/content

スキャンの概要を表示します。

[Source: audit-report.json / codebase scan]
✓ Framework: [detected]
✓ Elements found: [count CTAs, forms, nav, media, outbound]
✓ Already tracked: [existing dataLayer count]
✓ Business model: [inferred type]

フェーズ 2：広告プラットフォームを検出する

監査レポートまたはコードベースから広告プラットフォームを検出します。ユーザーには尋ねません。

Check audit-report.json existingTracking.patterns first for ad scripts.
If not found there, scan codebase:
- fbq, connect.facebook.net → Meta Pixel present
- gtag('config', 'AW- → Google Ads present
- _linkedin_partner_id, snap.licdn.com → LinkedIn present
- ttq, analytics.tiktok.com → TikTok present
- Existing GTM tags via gtm-implementation-log.json

Note detected platforms for use in Phase 4 recommendations.
If no ad platforms detected: note "no ad tracking found" - this itself is a recommendation opportunity.

フェーズ 3：トラッキング戦略を分析する

スキャン結果とビジネスモデルに基づき、gtm-strategy のフェーズ 2 およびフェーズ 4 のロジックを適用して、上位のイベントを特定します。

トラッキング候補の各イベントを、次の観点から評価します。

• ビジネスへの影響（主要な目標に直接関係するか？）
• データの取得可能性（既存の DOM 要素から取得できるか？）
• 実装の手間（その要素はすでにアナリティクスに対応しているか？）

フェーズ 4：機会を上位5件提示する

優先順位の高い順に、トラッキングの機会をちょうど5件提示します。

=== Your Top 5 Tracking Opportunities ===

Site: [framework] | Business model: [type] | [X] trackable elements found

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

#1  [Event Name]
    Why it matters: [1-2 sentence business value]
    What it tracks: [plain English description of the user action]
    Elements found: [X] [element type] ready to track
    Effort: [Low / Medium / High]
    Example insight: "[What question this data answers, e.g., 'Which CTA gets the most clicks?']"

#2  [Event Name]
    [same structure]

#3  [Event Name]
    [same structure]

#4  [Event Name]
    [same structure]

#5  [Event Name]
    [same structure]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Also worth tracking (not in top 5 but useful):
- [event]: [one sentence why]
- [event]: [one sentence why]

Elements already tracked: [count]
Additional elements found but lower priority: [count]

フェーズ 5：次のステップを促す

--- What to Do Next ---

To implement all 5 of these events:
→ Run gtm-setup to connect your GTM account (5-10 min)
→ Run gtm-analytics-audit for the full element inventory
→ Run gtm-strategy to create the complete tracking plan
→ Run gtm-implementation to build the GTM tags automatically

Total estimated time with full automation: 1-2 hours

Want to see the full tracking plan (not just top 5)?
Run: gtm-strategy

重要なガイドライン

• 上位5件のみを提示します。機会がそれ以上あっても、追加で提示しないでください
• 各機会の説明では、まずビジネス価値を示します。「何を」ではなく「なぜ」を先に述べてください
• 手間の見積もり：低 = 既存のアナリティクス対応要素を使用、中 = コード変更が必要、高 = アーキテクチャの作業が必要
• コードベースに有意義なトラッキング機会が5件未満しかない場合は、すべて提示し、推奨件数が少ない理由を述べてください
• 何も実装しないでください。これは分析のみを行うものであり、コード変更も API 呼び出しも行いません
• gtm-context.md を読み込んだ場合は、コンテキストに関する2つの質問を省略し、フェーズ 3 に進んでください

出力ファイル

なし。コンソール出力のみです。

引き継ぎ／次のステップ

このスキルは、ユーザーが本格的な実装に進む意欲を持てるだけの価値を提供することを目的としています。

• まずは gtm-setup で API にアクセスします
• 次に gtm-analytics-audit で全項目を監査します
• その後、gtm-strategy で包括的なトラッキング計画を作成します
• 最後に gtm-implementation で実装します