Skip to content

feat: UTM builder tool and naming standard#38

Open
thalescb wants to merge 1 commit into
masterfrom
feat/utm-builder
Open

feat: UTM builder tool and naming standard#38
thalescb wants to merge 1 commit into
masterfrom
feat/utm-builder

Conversation

@thalescb

@thalescb thalescb commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

Adds a self-contained UTM URL builder and org-wide naming standard for campaign attribution.

What's included

  • UTM Builder (tools/utm-builder/index.html) — dark-mode web tool with dropdown validation, tooltips, and copy-to-clipboard. Enforces the naming convention so nobody can free-type broken UTMs.
  • Config (tools/utm-builder/config.json) — controlled values for sources, mediums, initiatives, and goals. Edit this file to add/remove options; the builder reads it at runtime.
  • UTM Master Standard (tools/utm-builder/UTM_STANDARD.md) — the reference doc explaining rules, governance, and per-channel conventions.

How it works

  1. Open the builder page
  2. Fill dropdowns + campaign name
  3. Copy the generated URL
  4. Share it

Config.json is the single source of truth for valid values. The builder renders them as dropdowns and in a collapsible reference section.

Deployment

Designed for GitHub Pages at /utm-builder/. Workflow update to add it alongside dbt docs coming in a follow-up.

Self-contained URL builder for generating UTM-tagged campaign links.
Enforces the org-wide naming convention via dropdown validation.
Config-driven (config.json) for easy maintenance of controlled values.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant