add-analytics
oleh jeftekhari
Data & AnalyticsRingkasan
Add Google Analytics 4 tracking to any project.
Deskripsi
Apa yang Dilakukan Skill Ini
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.
Kapan Menggunakannya
- 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
Contoh Alur Kerja
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
Persyaratan
- Google Analytics 4 property with a Measurement ID (format: G-XXXXXXXXXX), obtained from analytics.google.com
Instalasi
clawhub install jeftekhari/add-analyticsJalankan perintah CLI-nya, atau tempel prompt ke Claude Code, Cursor, Codex, atau coding agent apa pun yang Anda pakai.