conversion-tracker

Files (4)

• LICENSE.txt
• SKILL.md
• openai.yaml · agents/
• tracking-templates.md · references/

SKILL.md (first lines)

# 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[]
```

From Affitor/affiliate-skills, MIT.

More from Affitor/affiliate-skills