---
name: trackable-link-generator
description: Creates named, trackable Supademo share links per prospect, campaign, or channel — with naming conventions, UTM discipline, and expiry rules — so every view is attributable. Use when sharing demos anywhere you'll later want to know who watched.
---

# Trackable Link Generator

One generic share link tells you "someone watched." A link per prospect and per channel tells you *who*, *from where*, and *whether to follow up*.

## Prerequisites

- Supademo MCP connected
- What's being shared (demo or showcase) and at what grain: per-prospect, per-campaign, or per-channel

## Workflow

1. **Pick the grain.**
   - **Per-prospect** — outbound and active deals; one link per account so `share-link-follow-up` can read engagement per deal
   - **Per-campaign** — launches, newsletters, paid; one link per campaign per asset
   - **Per-channel** — the same demo embedded on the site vs linked in email vs posted on social gets separate links, or attribution is guesswork
2. **Apply a naming convention** so links stay legible at scale:
   `{asset}--{campaign-or-account}--{channel}--{yyyymm}` (e.g., `onboarding-demo--acme-corp--outbound--202608`)
3. **Create the links.** `manage_links` for demos, `manage_showcase_links` for showcases; `get_showcase_share_info` to confirm the shareable URL. Set expiry on deal-specific links where supported — a demo link in a lost deal's inbox shouldn't work forever.
4. **Add UTM discipline** for links landing in email/ads/social: consistent `utm_source` / `utm_medium` / `utm_campaign` matching the naming convention, so demo analytics and web analytics agree.
5. **Wire personalization (optional).** If the demo uses dynamic variables (see `demo-personalizer`), append the values as query params per link — `?name=Sam&company=Acme` — so each prospect's link renders their personalized demo.
6. **Output a link registry** the team can paste into the CRM or a sheet:
   | Link | Asset | Audience | Channel | Created | Expires |
7. **Close the loop.** These links are what make `share-link-follow-up` and `traffic-source-attributor` work — segment `get_demo_sessions` / `get_showcase_sessions` by link to read engagement per prospect or channel.

## Guardrails

- Never reuse a prospect link across accounts — it permanently poisons attribution for both.
- Keep personal data out of URL params beyond first name and company; emails, phone numbers, or anything sensitive belongs in a lead-capture form, not a query string.
- Expire or archive deal-room links when the deal closes; stale live links are a data-hygiene and confidentiality leak.