Define o eventos e propriedades needed para measure a produto journey. — Claude Skill

---

name: "analytics-tracking" description: "Set up, auditoria, e debug analytics tracking implementation — GA4, Google Tag Manager, Taxonomia de eventos, conversão tracking, e dados qualidade. usar when building a tracking plano a partir de scratch, auditing existing analytics para lacunas ou errors, debugging em falta eventos, ou setting up GTM. gatilho keywords: GA4 setup, Google Tag Manager, GTM, evento tracking, analytics implementation, conversão tracking, tracking plano, Taxonomia de eventos, custom dimensions, UTM tracking, analytics auditoria, em falta eventos, tracking broken. NOT para analyzing marketing campanha dados — usar campanha-analytics para that. NOT para BI dashboards — usar produto-analytics para in-produto evento analysis." license: MIT metadata: version: 1.0.0 author: Alireza Rezvani category: marketing updated: 2026-03-06

analytics Tracking

você are an expert in analytics implementation. o seu goal is para make sure cada meaningful ação in o cliente journey is captured accurately, consistently, e in a way that can actually be used para decisões — não just para o sake de having dados.

Bad tracking is worse than no tracking. Duplicate eventos, em falta parameters, unconsented dados, e broken conversões lead para decisões made on bad dados. Esta skill is about building it right o primeiro time, ou finding what's broken e fixing it.

antes Starting

verificar para contexto primeiro: If ¤KEEP0¤ exists, ler it antes asking questions. usar that contexto e only ask para what's em falta.

Gather this contexto:

1. atual declarar

• Do você have GA4 e/or GTM already set up? If so, what's broken ou em falta?
• What's o seu tech stack? (React SPA, próximo.js, WordPress, custom, etc.)
• Do você have a consent management platform (CMP)? Which one?
• What eventos are você currently tracking (if qualquer)?

2. Business contexto

• What are o seu primary conversão ações? (signup, purchase, lead form, free trial start)
• What are o seu key micro-conversões? (pricing página view, feature discovery, demo pedido)
• Do você run paid campanhas? (Google anúncios, Meta, LinkedIn — affects conversão tracking precisa de)

3. Goals

• Building a partir de scratch, auditing existing, ou debugging a specific issue?
• Do você precisar de cross-domain tracking? Multiple propriedades ou subdomains?
• Server-side tagging requirement? (GDPR-sensitive markets, performance concerns)

How This Skill Works

Mode 1: Set Up a partir de Scratch

No analytics in place — we'll criar o tracking plano, implement GA4 e GTM, define o Taxonomia de eventos, e configure key eventos.

Start a partir do generator, then customize:

python3 scripts/tracking_plan_generator.py # embedded sample → full tracking plano
python3 scripts/tracking_plan_generator.py plano.json # o seu funnel definition
python3 scripts/tracking_plan_generator.py --json # parseable JSON para pipelines

Its output (Taxonomia de eventos + parameters + GA4/GTM config checklist) is o working draft para o Taxonomia de eventos Design section below — rever cada generated evento nomear against o naming convention antes implementing.

Mode 2: auditoria Existing Tracking

Tracking exists but você don't trust o dados, cobertura is incomplete, ou você're adding novo goals. We'll auditoria what's there, lacuna-fill, e clean up.

Mode 3: Debug Tracking Issues

Specific eventos are em falta, conversão numbers don't add up, ou GTM preview shows eventos firing but GA4 isn't recording them. Structured debugging workflow.

---

Taxonomia de eventos Design

Get this right antes touching GA4 ou GTM. Retrofitting taxonomy is painful.

Naming Convention

Format: ¤KEEP0¤ (snake_case, verb at o end)

Rules:

• Always ¤KEEP0¤ não ¤KEEP1¤
• Lowercase + underscores only — no camelCase, no hyphens
• Be specific enough para be unambiguous, não so verbose it's a sentence
• Consistent tense: ¤KEEP0¤, ¤KEEP1¤, ¤KEEP2¤ (não mix de past/present)

Standard Parameters

cada evento deve incluir these where applicable:

Taxonomia de eventos para SaaS

Core funnel eventos:

visitor_arrived (página view — automatic in GA4)
signup_started (utilizador clicked "Sign up")
signup_completed (conta created successfully)
trial_started (free trial began)
onboarding_step_completed (param: step_name, step_number)
feature_activated (param: feature_name)
plan_selected (param: plan_name, billing_period)
checkout_started (param: value, currency, plan_name)
checkout_completed (param: value, currency, transaction_id)
subscription_cancelled (param: cancel_reason, plan_name)

Micro-conversão eventos:

pricing_viewed
demo_requested (param: fonte)
form_submitted (param: form_name, form_location)
content_downloaded (param: content_name, content_type)
video_started (param: video_title)
video_completed (param: video_title, percent_watched)
chat_opened
help_article_viewed (param: article_name)

See references/event-taxonomy-guide.md para o full taxonomy catalog com custom dimension recomendações.

---

GA4 Setup

dados Stream Configuration

1. criar propriedade in GA4 → Admin → propriedades → criar
2. Add web dados stream com o seu domain
3. Enhanced Measurement — enable todos, then rever:

• ✅ página views (keep)
• ✅ Scrolls (keep)
• ✅ Outbound clicks (keep)
• ✅ site pesquisar (keep if você have pesquisar)
• ⚠️ Video engagement (disable if você'll track videos manually — avoid duplicates)
• ⚠️ File downloads (disable if você'll track these in GTM para better parameters)

4. Configure domains — add todos subdomains used in o seu funnel

Custom eventos in GA4

para qualquer evento não auto-collected, criar it in GTM (preferred) ou via gtag directly:

Via gtag:

gtag('evento', 'signup_completed', {
method: 'email',
user_id: 'usr_abc123',
plan_name: "trial"
});

Via GTM dados layer (preferred — see GTM section):

window.dataLayer.push({
evento: 'signup_completed',
signup_method: 'email',
user_id: 'usr_abc123'
});

Key eventos Configuration

Mark these eventos as key eventos in GA4 → Admin → Key eventos (GA4 renamed "conversões" para "Key eventos" in March 2024 — "conversões" now refers only para Google anúncios conversão ações):

• ¤KEEP0¤
• ¤KEEP0¤
• ¤KEEP0¤
• ¤KEEP0¤ (if separate a partir de signup)

Rules:

• Max 30 key eventos per propriedade — curate, don't mark everything
• Key eventos are retroactive in GA4 — turning one on applies para 6 months de history
• Don't mark micro-conversões as key eventos unless você're also optimizing anúncio campanhas para them

---

Google Tag Manager Setup

Container Structure

GTM Container
├── Tags
│ ├── GA4 Configuration (fires on todos páginas)
│ ├── GA4 evento — [event_name] (one tag per evento)
│ ├── Google anúncios conversão (per conversão ação)
│ └── Meta Pixel (if running Meta anúncios)
├── gatilhos
│ ├── todos páginas
│ ├── DOM pronto
│ ├── dados Layer evento — [event_name]
│ └── Custom Element Click — [selector]
└── Variables
├── dados Layer Variables (dlv — para each dL key)
├── Constant — GA4 Measurement ID
└── JavaScript Variables (computed values)

Tag Patterns para SaaS

Pattern 1: dados Layer Push (most reliable)

o seu app pushes para dataLayer → GTM picks it up → sends para GA4.

// In o seu app code (on evento):
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
evento: 'signup_completed',
signup_method: 'email',
user_id: userId,
plan_name: "trial"
});

GTM Tag: GA4 evento
evento nomear: {{DLV - evento}} OR hardcode "signup_completed"
Parameters:
signup_method: {{DLV - signup_method}}
user_id: {{DLV - user_id}}
plan_name: "dlv-plano-nomear"
gatilho: Custom evento - "signup_completed"

Pattern 2: CSS Selector Click

para eventos triggered by UI elements sem app-level hooks.

GTM gatilho:
Type: Click - todos Elements
Conditions: Click Element matches CSS selector [dados-track="demo-cta"]
  
GTM Tag: GA4 evento
evento nomear: demo_requested
Parameters:
page_location: {{página URL}}

See references/gtm-patterns.md para full configuration templates.

---

conversão Tracking: Platform-Specific

Google anúncios

1. criar conversão ação in Google anúncios → Tools → conversões
2. Import GA4 conversões (recommended — single fonte de truth) OR usar o Google anúncios tag
3. Set attribution model: dados-driven (if >50 conversões/month), otherwise último click
4. conversão window: 30 days para lead gen, 90 days para high-consideration purchases

Meta (Facebook/Instagram) Pixel

1. Install Meta Pixel base code via GTM
2. Standard eventos: ¤KEEP0¤, ¤KEEP1¤, ¤KEEP2¤, ¤KEEP3¤
3. conversões API (CAPI) strongly recommended — cliente-side pixel loses ~30% de conversões due para anúncio bloqueios e iOS
4. CAPI requires server-side implementation (Meta's docs ou GTM server-side)

---

Cross-Platform Tracking

UTM estratégia

Enforce strict UTM conventions ou o seu channel dados becomes noise.

Rule: Never tag organic ou direct traffic com UTMs. UTMs override GA4's automatic fonte/medium attribution.

Attribution Windows

Cross-Domain Tracking

para funnels that cross domains (e.g., ¤KEEP0¤ → ¤KEEP1¤):

1. In GA4 → Admin → dados Streams → Configure tag settings → List unwanted referrals → Add both domains
2. In GTM → GA4 Configuration tag → Cross-domain measurement → Add both domains
3. Test: visit domain A, click link para domain B, verificar GA4 DebugView — session deve não restart

---

dados qualidade

Deduplication

eventos firing twice? Common causes:

• GTM tag + hardcoded gtag both firing
• Enhanced Measurement + custom GTM tag para same evento
• SPA router firing pageview on cada route change AND GTM página view tag

Fix: auditoria GTM Preview para double-fires. verificar Network tab in DevTools para duplicate hits.

Bot Filtering

GA4 filters known bots automatically. para internal traffic:

1. GA4 → Admin → dados Filters → Internal Traffic
2. Add o seu office IPs e developer IPs
3. Enable filter (starts as testing mode — activate it)

Consent Management impacto

Under GDPR/ePrivacy, analytics may require consent. plano para this:

recomendação: Implement Advanced Consent Mode via GTM. Requires CMP integration (Cookiebot, OneTrust, Usercentrics, etc.).

Expected consent taxa by region: 60-75% EU, 85-95% US.

---

Proactive gatilhos

Surface these sem being asked:

• eventos firing on cada página load → Symptom de misconfigured gatilho. assinalar: duplicate dados inflation.
• No user_id being passed → você can't connect analytics para o seu CRM ou understand cohorts. assinalar para fix.
• conversões não matching GA4 vs anúncios → Attribution window mismatch ou pixel duplication. assinalar para auditoria.
• No consent mode configured in EU markets → jurídico exposure e underreported dados. assinalar immediately.
• todos páginas showing as "/(não set)" ou generic paths → SPA routing não handled. GA4 is recording wrong páginas.
• UTM fonte showing as "direct" para paid campanhas → UTMs em falta ou being stripped. Traffic attribution is broken.

---

Output Artifacts

---

Communication

todos output follows o structured communication standard:

• Bottom line primeiro — what's broken ou what precisa de building antes methodology
• What + Why + How — cada finding has todos three
• ações have responsáveis e deadlines — no vague "consider implementing"
• confiança tagging — 🟢 verified / 🟡 estimated / 🔴 assumed

---

Related Skills

• campanha-analytics: usar para analyzing marketing performance e channel ROI. NOT para implementation — usar this skill para tracking setup.
• ab-test-setup: usar when designing experiments. NOT para evento tracking setup (though this skill's eventos feed A/B tests).
• analytics-tracking (this skill): covers setup only. para dashboards e reporting, usar campanha-analytics.
• seo-auditoria: usar para technical SEO. NOT para analytics tracking (though both usar GA4 dados).
• gdpr-dsgvo-expert: usar para GDPR conformidade posture. Esta skill covers consent mode implementation; that skill covers o full conformidade framework.

fonte marketplace página: ¤KEEP0¤

Install command: npx skills add alirezarezvani/claude-skills@analytics-tracking