Conversion Tracker

Set up affiliate conversion tracking — generate UTM-tagged links, create link naming conventions, configure tracking pixel setup instructions, and build a tracking spreadsheet. Output is a Markdown tracking guide with a table of tagged links ready to deploy.

Stage

S6: Analytics — The difference between amateur and professional affiliates. You can't optimize what you don't measure. After deploying content (S5), you need UTM-tagged links for every platform and content piece to know exactly which channel drives conversions.

When to Use

User is about to launch a campaign and needs tracking links
User wants UTM-tagged links for different platforms
User says "set up tracking", "create UTM links", "organize my affiliate links"
User wants to track which content drives the most clicks and conversions
User is preparing to run ads and needs consistent link tagging
Chaining from S1 (product selected) → generate tracking links before creating content in S2-S5

Input Schema

product:
  name: string                 # REQUIRED — product name (e.g., "HeyGen")
  affiliate_url: string        # REQUIRED — base affiliate link

platforms:                     # OPTIONAL — where content will be published
  - string                     # e.g., ["linkedin", "twitter", "blog", "email", "reddit"]
                               # Default: ["blog", "twitter", "linkedin"]

campaign_name: string          # OPTIONAL — campaign identifier (e.g., "q1-2026-ai-tools")
                               # Default: auto-generated from product name + date

tracking_tool: string          # OPTIONAL — "google_analytics" | "voluum" | "clickmagick"
                               # | "manual_utm". Default: "manual_utm"

content_types:                 # OPTIONAL — types of content being created
  - string                     # e.g., ["blog_review", "social_post", "email", "landing_page"]

Chaining context: If S1 was run, pull recommended_program.affiliate_url and recommended_program.name. If S2-S5 outputs exist, use them to determine platforms and content types automatically.

Workflow

Step 1: Gather Product and Platform Info

Collect product name, affiliate URL, and target platforms. If not provided, default to blog + twitter + linkedin (the three most common affiliate channels).

Step 2: Generate UTM-Tagged Links

For each platform × content-type combination, create a UTM-tagged URL:

utm_source: platform name (e.g., linkedin, twitter, blog)
utm_medium: content type (e.g., social, article, email)
utm_campaign: campaign name (e.g., heygen-q1-2026)
utm_content: specific content identifier (e.g., review-post, cta-button, bio-link)

Append UTM parameters to the affiliate URL. Handle URLs that already have query parameters (use & not ?).

Step 3: Create Link Naming Convention

Establish a consistent naming scheme:

{product}-{platform}-{content_type}-{variant}

Example: heygen-linkedin-review-v1

Step 4: Build Tracking Setup Guide

Based on tracking_tool:

Google Analytics: Event tracking setup, goal configuration, UTM report location
Voluum / ClickMagick: Postback URL setup, conversion pixel placement
Manual UTM: Google Sheets tracking template with columns for link, platform, clicks, conversions

Step 5: Output Tracking Sheet

Present all links in a structured table with:

Link name
Platform
Content type
Full tagged URL
Notes

Step 6: Self-Validation

Before presenting output, verify:

UTM parameters correctly appended to all affiliate URLs
No URL encoding errors in generated links
Naming convention is consistent across all links
All links are under URL length limits
Setup guide steps match the recommended tracking tool

If any check fails, fix the output before delivering. Do not flag the checklist to the user — just ensure the output passes.

Output Schema

output_schema_version: "1.0.0"  # Semver — bump major on breaking changes
tracking:
  product: string
  campaign: string
  total_links: number

links:
  - name: string               # e.g., "heygen-linkedin-review-v1"
    platform: string
    content_type: string
    url: string                # full UTM-tagged URL
    utm_source: string
    utm_medium: string
    utm_campaign: string
    utm_content: string

naming_convention:
  pattern: string              # e.g., "{product}-{platform}-{type}-{variant}"
  examples: string[]

setup_guide:
  tool: string
  steps: string[]

Output Format

Tracking Links Table — Markdown table with all tagged links
Naming Convention — pattern + examples for consistency
Setup Guide — step-by-step instructions for the chosen tracking tool
Next Steps — what to do with these links (plug into S2-S5 content)

Error Handling

No affiliate URL provided: "I'll create the UTM structure and naming convention now. Replace [YOUR_AFFILIATE_LINK] with your actual affiliate URL when you have it."
URL already has UTM parameters: "Your affiliate URL already has UTM parameters. I'll append additional tracking parameters without overwriting the existing ones."
Too many platform × content combinations (>20): "That's a lot of links. I'll generate the most important ones (one per platform) and provide the naming convention so you can create the rest."

Examples

Example 1: Simple blog + social setup

User: "Set up tracking for my HeyGen affiliate link (heygen.com/ref/abc123) on my blog and Twitter" Action: Generate 4 links: blog-review, blog-comparison, twitter-post, twitter-thread. Each with proper UTM tags. Include Google Sheets tracking template.

Example 2: Multi-platform campaign

User: "I'm launching a campaign for Semrush across LinkedIn, Twitter, Reddit, my blog, and email newsletter. Create all my tracking links." Action: Generate 10+ links across all platforms and content types. Establish naming convention. Suggest Google Analytics goal setup for conversion tracking.

Example 3: Chained from S1

Context: S1 found HeyGen with affiliate URL heygen.com/ref/abc123. User: "Set up tracking for this before I start creating content." Action: Pull product info from S1 output. Generate links for the user's likely content types (infer from S1 context). Prepare tracking sheet that S6.3 (performance-report) can use later.

References

references/tracking-templates.md — Google Sheets template, UTM parameter reference, platform-specific tracking notes, S6 feedback loop
shared/references/affiliate-glossary.md — Definitions for tracking terms (EPC, CTR, conversion). Referenced in setup guide.
shared/references/flywheel-connections.md — master flywheel connection map

Flywheel Connections

Feeds Into

affiliate-program-search (S1) — top converting niches → search for more programs in winning niches
performance-report (S6) — conversion data for reports
ab-test-generator (S6) — conversion baselines for test evaluation

Fed By

bio-link-deployer (S5) — deployed link URLs to track
email-drip-sequence (S5) — email links to track
landing-page-creator (S4) — landing page conversions to track
github-pages-deployer (S5) — deployed site to track

Feedback Loop

Conversion data feeds back to S1 Research (which programs convert best) and S4 Landing (which page elements convert) — closing the flywheel loop

chain_metadata:
  skill_slug: "conversion-tracker"
  stage: "analytics"
  timestamp: string
  suggested_next:
    - "performance-report"
    - "ab-test-generator"
    - "affiliate-program-search"