add-analytics
由 jeftekhari 提供
Data & Analytics简介
Add Google Analytics 4 tracking to any project.
描述
该技能的功能
Adds Google Analytics 4 tracking to a project by detecting the framework and inserting the appropriate gtag setup. Supports Next.js, Nuxt, Astro, SvelteKit, Remix, Gatsby, Vue, React (Vite/CRA), Angular, and plain HTML. Optional flags enable custom event helpers, cookie consent mode, and debug output.
Handles framework detection and generates the correct integration pattern automatically, avoiding the manual lookup and copy-paste errors that typically come with setting up gtag across different project types.
何时使用
- Adding GA4 to a Next.js app without manually writing gtag boilerplate
- Setting up page-view tracking in a SvelteKit or Astro site
- Adding cookie consent mode before launching to EU users
- Instrumenting form submissions and purchase events with typed helpers
- Configuring debug mode to verify tracking during development
示例工作流
User asks: add analytics G-ABC1234567 --events --consent
- 1
Scans project files to detect framework (e.g., finds next.config.ts, identifies Next.js App Router)
- 2
Validates measurement ID format matches G-XXXXXXXXXX
- 3
Creates components/GoogleAnalytics.tsx with Script tags and injects it into app/layout.tsx
- 4
Creates lib/analytics-events.ts with typed event helpers (trackClick, trackPurchase, etc.)
- 5
Creates lib/analytics-consent.ts with consent mode defaults and updateConsent helpers
- 6
Adds NEXT_PUBLIC_GA_MEASUREMENT_ID to .env.local and .env.example, ensures .env.local is in .gitignore
GA4 tracking is live with consent mode defaulting to denied, event helpers exported and ready to use, and environment variable documented
前置要求
- Google Analytics 4 property with a Measurement ID (format: G-XXXXXXXXXX), obtained from analytics.google.com
安装
clawhub install jeftekhari/add-analytics运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。