HubSpot UTM Parameters for AEO: the canonical AI engine taxonomy

The utm_source, utm_medium, and utm_campaign values Lantern uses for AI engine traffic in HubSpot — a canonical taxonomy you can adopt whether or not you use Lantern.

Updated 2026-04-20 · HubSpot integration · ~6 min read

What this does

Most teams invent their own UTM taxonomy for AI traffic ad-hoc — some use utm_source=openai, others utm_source=chatgpt, others utm_source=ai. This fragmentation makes reports ugly and cross-team analysis impossible. Lantern publishes (and auto-applies) a canonical taxonomy: utm_source = engine lowercase, utm_medium = ai-referral, utm_campaign = prompt-category-when-known.

How Lantern fits

Lantern's JS snippet applies this taxonomy automatically. If your team already uses a different taxonomy, Lantern can translate on ingest (configurable in install). The recommended default: utm_source=chatgpt|perplexity|claude|gemini, utm_medium=ai-referral, utm_campaign=aeo-[category]. Consistent taxonomy means HubSpot reports group cleanly, CMO questions get clean answers.

Setup preview

Four UTM slots in HubSpot — utm_source, utm_medium, utm_campaign, utm_content, utm_term. Lantern uses the first three; utm_content and utm_term remain available for your paid ads and other campaigns. This means AEO data never collides with existing UTM investment — you can run Google Ads, LinkedIn Ads, and Lantern's AEO attribution side by side without conflict.

Canonical UTM taxonomy for AI engines (Lantern standard) · javascript
// Lantern canonical UTM taxonomy for AI engines
const LANTERN_UTM_MAP = {
  'chat.openai.com':    { source: 'chatgpt',    medium: 'ai-referral' },
  'chatgpt.com':        { source: 'chatgpt',    medium: 'ai-referral' },
  'openai.com':         { source: 'chatgpt',    medium: 'ai-referral' },
  'perplexity.ai':      { source: 'perplexity', medium: 'ai-referral' },
  'www.perplexity.ai':  { source: 'perplexity', medium: 'ai-referral' },
  'claude.ai':          { source: 'claude',     medium: 'ai-referral' },
  'gemini.google.com':  { source: 'gemini',     medium: 'ai-referral' },
  'bard.google.com':    { source: 'gemini',     medium: 'ai-referral' },
  'bing.com/chat':      { source: 'bing-chat',  medium: 'ai-referral' },
  'copilot.microsoft.com': { source: 'copilot', medium: 'ai-referral' },
  'you.com':            { source: 'you-com',    medium: 'ai-referral' },
  'arc.net':            { source: 'arc-search', medium: 'ai-referral' }
};

// Campaign category optionally derived from landing URL
function campaignFromPath(path) {
  if (path.includes('/compare/')) return 'aeo-comparison';
  if (path.includes('/learn/'))   return 'aeo-glossary';
  if (path.includes('/aeo-for/')) return 'aeo-vertical';
  if (path.includes('/blog/'))    return 'aeo-content';
  return 'aeo-other';
}

Where this fits in the bigger picture

This page describes one specific surface inside HubSpot where Lantern's AEO pipeline attribution plugs in. The full integration stitches together across HubSpot Contacts, Deals, Workflows, Lists, Reports, Forms, CMS, and the Marketing/Sales/Service Hub stack. If you're evaluating where to start, the comparison hub has side-by-side comparisons of Lantern against Profound, Scrunch, Peec AI, AthenaHQ, and HubSpot's own AEO product — scored on the dimensions that matter for a CMO buyer (CRM integration depth, reporting quality, prompt-scaling economics).

If you're about to walk this work into a renewal review or budget conversation, the CFO's Guide to AEO Budget Defense has the memo template, the five-slide deck structure, the attribution-math cheat sheet, and the three most-common CFO objections with counter-arguments. It's the long-form companion that translates the technical HubSpot setup on this page into a defensible dollar number for finance.

FAQ

Common questions.

Why utm_medium=ai-referral and not utm_medium=organic?
Lumping AI traffic into 'organic' is the most common mistake and the most damaging. Once in 'organic', AI traffic disappears into your SEO bucket and CMOs can't see it separately. 'ai-referral' keeps it visible and reportable as its own source.
What's utm_campaign for?
Optional category tag. Lantern uses it to mark what type of page earned the citation — comparison page (aeo-comparison), glossary term (aeo-glossary), vertical guide (aeo-vertical), blog post (aeo-content). Useful for understanding which content types drive AEO traffic.
Can I use my existing UTM scheme instead?
Yes. In Lantern install, choose 'custom UTM mapping' and provide your translation table. Common case: teams using utm_source=openai get mapped to utm_source=chatgpt in Lantern's reports, but HubSpot keeps the raw value.
What about HubSpot Tracking URLs (hubspot_source parameter)?
HubSpot's tracking URL feature uses hubspot_source as an override for Original Source. Lantern respects this — if you create a HubSpot tracking URL with hubspot_source=paid, it beats Lantern's utm_source. For AI traffic, don't use HubSpot tracking URLs; use the direct UTM approach.

Lantern ships this as a one-click HubSpot install.

Instead of hand-wiring properties, workflows, and tracking snippets, Lantern installs the full HubSpot integration in under 30 minutes — then ships the monthly AEO pipeline ROI report your CFO signs off on. $99/mo Starter or Enterprise. 14-day free trial.

Start free trial