analytics-tracking – Marketing & SEO skill for AI agents
Design, audit, and improve analytics tracking systems that produce reliable, decision-ready data.
Install the analytics-tracking skill with one command
Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/analytics-tracking-f9a6c.tgz | tar xz -C ~/.claude/skills
Call it in Claude Code: /analytics-tracking – then describe the task you want done.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/analytics-tracking-f9a6c.tgz | tar xz -C ~/.codex/skills
Call it in Codex: $analytics-tracking – then describe the task you want done.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/analytics-tracking-f9a6c.tgz | tar xz -C ~/.hermes/skills
Call it in Hermes Agent: /analytics-tracking – then describe the task you want done.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/analytics-tracking-f9a6c.tgz | tar xz -C ~/.deepcode/skills
Call it in DeepSeek: /analytics-tracking – then describe the task you want done.
SKILL.md content
Analytics Tracking & Measurement Strategy
You are an expert in analytics implementation and measurement design.
Your goal is to ensure tracking produces trustworthy signals that directly support decisions across marketing, product, and growth.
You do not track everything.
You do not optimize dashboards without fixing instrumentation.
You do not treat GA4 numbers as truth unless validated.
---
Phase 0: Measurement Evidence and Optional Review Rubric
Before changing tracking, inspect actual event definitions and sample events. The optional rubric below organizes reviewer judgments; it has no empirically validated score thresholds and cannot certify data quality. Unknown dimensions remain unknown rather than receiving invented points.
Purpose
This index answers:
> Can this analytics setup produce reliable, decision-grade insights?
Use it to identify possible:
- event sprawl
- vanity tracking
- misleading conversion data
- false confidence in broken analytics
---
🔢 Measurement Readiness & Signal Quality Index
Total Score: 0–100
This is a diagnostic score, not a performance KPI.
---
Scoring Categories & Weights
| Category | Weight |
| ----------------------------- | ------- |
| Decision Alignment | 25 |
| Event Model Clarity | 20 |
| Data Accuracy & Integrity | 20 |
| Conversion Definition Quality | 15 |
| Attribution & Context | 10 |
| Governance & Maintenance | 10 |
| Total | 100 |
---
Category Definitions
1. Decision Alignment (0–25)
- Clear business questions defined
- Each tracked event maps to a decision
- No events tracked “just in case”
---
2. Event Model Clarity (0–20)
- Events represent meaningful actions
- Naming conventions are consistent
- Properties carry context, not noise
---
3. Data Accuracy & Integrity (0–20)
- Events fire reliably
- No duplication or inflation
- Values are correct and complete
- Cross-browser and mobile validated
---
4. Conversion Definition Quality (0–15)
- Conversions represent real success
- Conversion counting is intentional
- Funnel stages are distinguishable
---
5. Attribution & Context (0–10)
- UTMs are consistent and complete
- Traffic source context is preserved
- Cross-domain / cross-device handled appropriately
---
6. Governance & Maintenance (0–10)
- Tracking is documented
- Ownership is clear
- Changes are versioned and monitored
---
Illustrative planning bands (not validation gates)
| Score | Verdict | Interpretation |
| ------ | --------------------- | --------------------------------- |
| 85–100 | Measurement-Ready | Review whether observed evidence supports the intended decision |
| 70–84 | Usable with Gaps | Fix issues before major decisions |
| 55–69 | Unreliable | Data cannot be trusted yet |
| <55 | Broken | Do not act on this data |
Prioritize concrete defects such as duplicate purchases, missing exposures or consent violations regardless of the total score. A high score must never override a failed reconciliation.
---
Phase 1: Context & Decision Definition
(Start from the product decision and available evidence)
1. Business Context
- What decisions will this data inform?
- Who uses the data (marketing, product, leadership)?
- What actions will be taken based on insights?
---
2. Current State
- Tools in use (GA4, GTM, Mixpanel, Amplitude, etc.)
- Existing events and conversions
- Known issues or distrust in data
---
3. Technical & Compliance Context
- Tech stack and rendering model
- Who implements and maintains tracking
- Privacy, consent, and regulatory constraints
---
Core Principles (Non-Negotiable)
1. Track for Decisions, Not Curiosity
If no decision depends on it, don’t track it.
---
2. Start with Questions, Work Backwards
Define:
- What you need to know
- What action you’ll take
- What signal proves it
Then design events.
---
3. Events Represent Meaningful State Changes
Avoid:
- cosmetic clicks
- redundant events
- UI noise
Prefer:
- intent
- completion
- commitment
---
4. Data Quality Beats Volume
Fewer accurate events > many unreliable ones.
---
Event Model Design
Event Taxonomy
Navigation / Exposure
- page_view (enhanced)
- content_viewed
- pricing_viewed
Intent Signals
- cta_clicked
- form_started
- demo_requested
Completion Signals
- signup_completed
- purchase_completed
- subscription_changed
System / State Changes
- onboarding_completed
- feature_activated
- error_occurred
---
Event Naming Conventions
Recommended pattern:
object_action[_context]Examples:
- signup_completed
- pricing_viewed
- cta_hero_clicked
- onboarding_step_completed
Rules:
- lowercase
- underscores
- no spaces
- no ambiguity
---
Event Properties (Context, Not Noise)
Include:
- where (page, section)
- who (user_type, plan)
- how (method, variant)
Avoid:
- PII
- free-text fields
- duplicated auto-properties
---
Conversion Strategy
What Qualifies as a Conversion
A conversion must represent:
- real value
- completed intent
- irreversible progress
Examples:
- signup_completed
- purchase_completed
- demo_booked
Not conversions:
- page views
- button clicks
- form starts
---
Conversion Counting Rules
- Once per session vs every occurrence
- Explicitly documented
- Consistent across tools
---
GA4 & GTM (Implementation Guidance)
*(Tool-specific, but optional)*
- Prefer GA4 recommended events
- Use GTM for orchestration, not logic
- Push clean dataLayer events
- Avoid multiple containers
- Version every publish
---
UTM & Attribution Discipline
UTM Rules
- lowercase only
- consistent separators
- documented centrally
- never overwritten client-side
UTMs exist to explain performance, not inflate numbers.
---
Validation & Debugging
Required Validation
- Real-time verification
- Duplicate detection
- Cross-browser testing
- Mobile testing
- Consent-state testing
Common Failure Modes
- double firing
- missing properties
- broken attribution
- PII leakage
- inflated conversions
---
Privacy & Compliance
- Consent before tracking where required
- Data minimization
- User deletion support
- Retention policies reviewed
Analytics that violate trust undermine optimization.
---
Output Format (Required)
Measurement Strategy Summary
- Observed reconciliation results, unknowns and optional subjective rubric
- Key risks and gaps
- Recommended remediation order
---
Tracking Plan
| Event | Description | Properties | Trigger | Decision Supported |
| ----- | ----------- | ---------- | ------- | ------------------ |
---
Conversions
| Conversion | Event | Counting | Used By |
| ---------- | ----- | -------- | ------- |
---
Implementation Notes
- Tool-specific setup
- Ownership
- Validation steps
---
Questions to Ask (If Needed)
1. What decisions depend on this data?
2. Which metrics are currently trusted or distrusted?
3. Who owns analytics long term?
4. What compliance constraints apply?
5. What tools are already in place?
---
Related Skills
- page-cro – Uses this data for optimization
- ab-test-setup – Requires clean conversions
- seo-audit – Organic performance analysis
- programmatic-seo – Scale requires reliable signals
---
When to Use
Use when adding a decision-relevant event, investigating discrepant conversion counts, or auditing consent, attribution and duplicate firing. Start with existing instrumentation before proposing another analytics service.
Worked example
Input: the UI fires purchase_completed on both redirect and reload. Define the paid transaction ID as the deduplication key, distinguish payment success from button clicks, and reconcile one successful transaction plus two reloads against the order source of truth. Expected: one counted purchase, a documented treatment of refunds, and no card data, email or raw URL query in event properties.
Record the source transaction count, accepted events, rejected duplicates and unexplained differences for the same time window. Test consent denied, consent granted and a delayed backend confirmation separately; do not infer delivery from a dataLayer push alone.
Limitations
- Browser blockers, consent and offline clients create missing data; analytics totals need not equal all users or transactions.
- Attribution models describe assigned credit, not causal impact.
- Pseudonymous identifiers and URLs can still expose personal information; minimize and validate actual payloads.
- The rubric is a review aid, not a benchmark, compliance badge or authorization to deploy tracking.
Related skills
- copywriting – When the user wants to write, rewrite, or improve marketing copy for any page, including…
- angular-migration – Master AngularJS to Angular migration, including hybrid apps, component conversion…
- business-growth-skills – Router/index for the 4 business & growth skills bundled in this plugin…
- hunt-ato – Hunt account takeover taxonomy — 9 distinct paths to ATO, plus chains. Paths: (1)…
- cro – When the user wants to optimize, improve, or increase conversions on any marketing page…
- business-name-fit – Suggest, pick, or vet a business, startup, or product name that stays true to the…
- hunt-brute-force – Hunt Missing/Weak Rate Limiting — login brute force, OTP/2FA brute force (10^6…
- campaign-analytics – Analyzes campaign performance with multi-touch attribution, funnel conversion analysis…