add-analytics
jeftekhari tarafından
Data & AnalyticsÖzet
Add Google Analytics 4 tracking to any project.
Açıklama
Bu Beceri Ne Yapar
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.
Ne Zaman Kullanılır
- 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
Örnek İş Akışı
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
Gereksinimler
- Google Analytics 4 property with a Measurement ID (format: G-XXXXXXXXXX), obtained from analytics.google.com
Kurulum
clawhub install jeftekhari/add-analyticsCLI komutunu çalıştırın ya da istemi Claude Code, Cursor, Codex veya kullandığınız kodlama ajanına yapıştırın.