Conversion Tracker

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha 2515ce9634da · 15 Oct 2026Report an issue or request a re-scan

• PublisherAffitor GitHub organizationOwner of the repository this skill is read from
• Source folderAffitor/affiliate-skills/skills/analytics/conversion-trackerThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdict2515ce9634daA new audit runs when the source changes
• Repository statusNot archivedLast push 2 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Set up affiliate conversion tracking with UTM parameters and link tagging. Triggers on: "set up tracking", "create UTM links", "track my affiliate links", "tracking pixels", "click attribution", "organize my links",…

---
name: conversion-tracker
description: >
  Set up affiliate conversion tracking with UTM parameters and link tagging. Triggers on:
  "set up tracking", "create UTM links", "track my affiliate links", "tracking pixels",
  "click attribution", "organize my links", "UTM parameters", "tag my links",
  "campaign tracking", "link tracking setup", "prepare for launch",
  "debug attribution", "tracking spreadsheet".
license: MIT
version: "1.0.0"
tags: ["affiliate-marketing", "analytics", "optimization", "tracking", "conversion"]
compatibility: "Claude Code, ChatGPT, Gemini CLI, Cursor, Windsurf, OpenClaw, any AI agent"
metadata:
  author: affitor
  version: "1.0"
  stage: S6-Analytics
---

# 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

```yaml
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

```yaml
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

1. **Tracking Links Table** — Markdown table with all tagged links
2. **Naming Convention** — pattern + examples for consistency
3. **Setup Guide** — step-by-step instructions for the chosen tracking tool
4. **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 li

Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

1. 2026-10-15
   ✓SAFE B 89 / 100

   first audit · source 2515ce9634da

Questions about Conversion Tracker

• github.com/Affitor/affiliate-skills/tree/main/skills/analytics/c — the audited source at commit 2515ce9634da and every finding aboveObserved · 15 Oct 2026

Spotted something wrong? Report a correction · Methodology