mcpField
U
utm-attribution-strategy

utm-attribution-strategy

github.com/thatrebeccaraeMarketing & growth187115 installsUpdated 24w ago
Repository

About utm-attribution-strategy

A Claude skill for planning consistent UTM campaign tags and choosing marketing attribution models. It includes naming guidance, channel templates, model comparisons, and an audit checklist for marketing teams.

Key features

  1. 01Five standard UTM parameter guide
  2. 02Naming rules and channel taxonomy
  3. 03Templates for common campaign URLs
  4. 04Attribution model comparison
  5. 05UTM audit checklist

Use cases

  1. 01Standardizing campaign tags across teams
  2. 02Building tagged URLs for ads and newsletters
  3. 03Selecting an attribution model by sales cycle
  4. 04Auditing tracking links for common errors

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thatrebeccarae/claude-marketing --skill utm-attribution-strategy

After installing, type/utm-attribution-strategyin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

EXAMPLES.md
LICENSE
REFERENCE.md

Details

From the project README

UTM & Attribution Strategy

Campaign tracking with UTM parameters and marketing attribution modeling.

Install

git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/utm-attribution-strategy ~/.claude/skills/

UTM Parameter Reference

The 5 Standard UTM Parameters
ParameterPurposeRequiredExample
utm_sourceWhere traffic comes fromYesgoogle, linkedin, newsletter
utm_mediumMarketing medium/channelYescpc, email, social, referral
utm_campaignCampaign nameYesspring-sale, product-launch-q1
utm_termPaid keyword (search ads)Noemail+marketing+software
utm_contentDifferentiate ad variantsNocta-button, sidebar-banner, video-ad
UTM Naming Convention

Rules:

  • All lowercase (Google Analytics is case-sensitive)
  • Use hyphens (-) as word separators, never spaces or underscores
  • Be descriptive but concise
  • Use consistent vocabulary across all teams
  • Document your taxonomy and enforce it
Recommended Taxonomy
utm_source
ValueWhen to Use
googleGoogle Ads, Google organic
facebookMeta/Facebook ads and organic
instagramInstagram ads and organic
linkedinLinkedIn ads and organic
tiktokTikTok ads
twitterTwitter/X
youtubeYouTube ads and organic
bingMicrosoft/Bing ads
newsletterYour email newsletter
emailTransactional or one-off emails
partner-[name]Partner/affiliate traffic
podcast-[name]Podcast mentions
utm_medium
ValueWhen to Use
cpcPaid search (cost per click)
paid-socialPaid social media
socialOrganic social media
emailEmail marketing
referralPartner/affiliate referrals
displayDisplay/banner ads
videoVideo ads (pre-roll, in-stream)
retargetingRetargeting/remarketing
influencerInfluencer partnerships
organicOrganic search (usually auto-tagged)
directDirect traffic (usually auto-tagged)
utm_campaign

Pattern: [initiative]-[audience]-[date]

Examples:

  • spring-sale-2026
  • product-launch-enterprise-q1
  • webinar-seo-masterclass-mar2026
  • blog-weekly-digest-w12
  • retarget-cart-abandoners-mar
utm_content

Pattern: [format]-[variant]-[placement]

Examples:

  • video-testimonial-feed
  • carousel-product-stories
  • cta-start-trial-hero
  • banner-logo-sidebar
  • text-ad-headline-v2

UTM Builder

URL Structure
https://example.com/landing-page?utm_source=linkedin&utm_medium=paid-social&utm_campaign=product-launch-q1&utm_content=video-demo-feed
Common UTM Templates
ChannelFull UTM String
Google Search Ad?utm_source=google&utm_medium=cpc&utm_campaign=[campaign]&utm_term=[keyword]&utm_content=[ad-group]
Facebook Ad?utm_source=facebook&utm_medium=paid-social&utm_campaign=[campaign]&utm_content=[ad-name]
LinkedIn Ad?utm_source=linkedin&utm_medium=paid-social&utm_campaign=[campaign]&utm_content=[creative-type]
Email Newsletter?utm_source=newsletter&utm_medium=email&utm_campaign=[newsletter-name]-[date]&utm_content=[link-position]
Organic LinkedIn Post?utm_source=linkedin&utm_medium=social&utm_campaign=[post-topic]
Partner Referral?utm_source=partner-[name]&utm_medium=referral&utm_campaign=[initiative]

Attribution Models

Model Comparison
ModelHow It WorksBest ForLimitation
Last Click100% credit to last touchpointShort sales cycles, direct responseIgnores awareness/consideration
First Click100% credit to first touchpointBrand awareness measurementIgnores conversion-driving touches
LinearEqual credit to all touchpointsSimple multi-touch viewOver-credits low-impact touches
Time DecayMore credit to recent touchesLong sales cycles with clear momentumUnder-values early awareness
Position-Based40% first, 40% last, 20% middleBalanced view of full funnelArbitrary weight distribution
Data-DrivenML-based credit allocationLarge datasets (1000+ conversions)Black box, requires volume
GA4 Attribution

GA4 uses data-driven attribution by default. Key settings:

  • Reporting attribution model: Set in Admin > Attribution Settings
  • Lookback window: 30 days (click) / 7 days (view) default
  • Conversion paths: Analyze in Advertising > Attribution > Conversion Paths
Choosing a Model
Sales cycle < 7 days → Last Click or Data-Driven
Sales cycle 7-30 days → Position-Based or Data-Driven
Sales cycle > 30 days → Time Decay or Data-Driven
Brand awareness focus → First Click
Performance marketing focus → Last Click
Balanced view needed → Position-Based
1000+ monthly conversions → Data-Driven (always)

UTM Audit Checklist

  • All paid campaigns have UTM parameters
  • Naming convention documented and shared with team
  • No mixed case (utm_source=Google vs google)
  • No spaces in parameter values (use hyphens)
  • utm_medium values align with GA4 default channel groupings
  • Internal links do NOT have UTM parameters (breaks attribution)
  • UTM parameters are on the landing page URL, not post-redirect
  • No PII in UTM parameters (names, emails, account IDs)
  • Short URLs / link shorteners preserve UTM parameters
  • Redirects preserve UTM parameters (302s can strip them)

Common Mistakes

  1. UTMs on internal links — breaks session attribution, inflates source counts
  2. Inconsistent naming — Facebook vs facebook vs fb creates 3 separate sources
  3. Missing utm_medium — traffic falls into "(other)" channel grouping
  4. Non-standard utm_medium values — use GA4 recognized values for proper channel grouping
  5. UTMs on organic search results — Google auto-tags organic; adding UTMs creates duplicate sources
  6. PII in UTM parameters — email addresses or user IDs in URLs violate privacy policies
  7. Forgetting post-click tracking — UTMs track the click, not what happens after

Integration with Other Skills

  • google-analytics — UTM data flows into GA4 for analysis
  • google-ads — Google auto-tags with gclid; UTMs are supplementary
  • facebook-ads — Meta auto-tags with fbclid; UTMs needed for GA4 attribution
  • linkedin-ads — LinkedIn requires manual UTM configuration
  • tiktok-ads — TikTok requires manual UTM configuration

Comments

Markdown supported