UTM Tracker Plugin – Documentation

Track. Persist. Replace. Analyze. This plugin turns UTM chaos into clean data pipelines across domains, links, and email contact points.

📜 Table of Contents

1. Installation & Setup

  • Upload the ZIP via Plugins > Add New > Upload Plugin
  • Activate it
  • Navigate to Settings > UTM Tracker to start configuring

2. Feature Breakdown

  • UTM Parameters: Specify which UTM values to track (e.g., utm_source, utm_medium). They're stored in session and automatically appended to links.
  • Host Propagation: Extend UTM tracking across multiple domains. Link to other sites without losing campaign attribution.
  • Email Replacement: Swap visible email addresses based on the UTM source — know exactly where that contact came from.
  • Hide UTM Parameters: Clean URLs automatically after data is stored. Cleaner links, same tracking power.
  • Debug Logs: View UTM tracking events in your browser’s console for dev inspection and troubleshooting.
  • Bypass Cache (NEW): Prevent UTM loss when using aggressive caching systems like WP Rocket, W3 Total Cache, or Cloudflare.

3. Email Replacement Rules

  1. Go to Settings > UTM Tracker
  2. Scroll to Replace Emails with UTM Versions
  3. Add a rule: original email → UTM replacement email
  4. Save
  5. Users with UTM session data will now see the modified email

4. Using with Caching Plugins

If you're using a caching plugin (WP Rocket, W3TC, etc.):

  • Enable “Bypass Cache” in UTM Tracker settings
  • Or manually exclude these URL patterns from cache:
    • *utm_campaign*
    • *utm_source*
    • *utm_medium*
    • *utm_content*
    • *utm_term*
  • Exclude utm_tracker session cookie from cache

5. Troubleshooting

  • UTM values disappear? Enable Hide UTM Parameters to store them in session.
  • Emails not replacing? Double check the original email **matches exactly** what’s displayed on your site.
  • Tracking inconsistent? Enable Bypass Cache in plugin settings.
  • Console noise? Turn off Debug Mode once you're done testing.
  • Still weird? Clear your WordPress & browser cache after saving settings.

6. FAQs

  • Does this modify the database? Nope. All tracking is session-based.
  • Affiliate tracking? Works for attribution, not commissions.
  • Google Analytics compatible? 100%. Make sure GA or GTM can read URL/session UTMs.
  • User clears cookies? Tracking resets.