ai-referral-analytics
Skill2 starsChanged 5 months agoMITView on GitHub
Track the traffic answer engines send to a site — set up analytics to capture and attribute referrals from ChatGPT, Perplexity, Gemini, and other AI assistants, including the large share that hides in "direct." Works for any business, B2B or B2C, product or service. Use when the request is to track AI referral traffic, see visits from ChatGPT or Perplexity in GA4, fix AI traffic showing as direct, attribute AI-assistant conversions, or measure AI traffic quality. Pairs with ai-visibility-tracking.
In this repository26 other files it gives its agents.
- aeo-foundationSkill
- ai-capability-signalingSkill
- ai-crawler-accessSkill
- ai-retrievabilitySkill
- ai-visibility-auditSkill
- ai-visibility-trackingSkill
- answer-engineeringSkill
- author-authoritySkill
- chatgpt-optimizationSkill
- claim-accuracySkill
- claude-optimizationSkill
- community-and-reviewsSkill
- comparison-contentSkill
- competitor-ai-analysisSkill
- content-freshnessSkill
- crawler-log-analysisSkill
- digital-prSkill
- entity-optimizationSkill
- evidence-and-citationsSkill
- gemini-optimizationSkill
- google-ai-overviews-optimizationSkill
- llms-txtSkill
- multimodal-aeoSkill
- perplexity-optimizationSkill
- prompt-researchSkill
- structured-dataSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 32
Read aeo-foundation.md for the site/analytics context and the conversions that matter.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
AI Referral Analytics
This skill makes answer-engine traffic visible in analytics. Citations only matter if they drive outcomes, but a large share of AI-assistant traffic arrives with no referrer — from mobile apps, copy-paste, and in-assistant browsers — and lands in "Direct," so most brands badly undercount it. This skill captures and attributes that traffic and reads its quality. The examples use GA4 patterns; the approach maps to any analytics platform. It works for any business, B2B or B2C.
When to use this skill
- Setting up tracking for AI-assistant referral traffic.
- Recovering AI traffic that is misattributed as Direct.
- Attributing conversions and revenue to AI sources.
- Reporting AI traffic volume and quality alongside visibility metrics.
Before you start
Read aeo-foundation.md for the site/analytics context and the conversions that matter. If
it is missing, point to the aeo-foundation skill.
The core problem
AI-assistant visits often carry no referrer (native apps, copy-pasted links, assistant-embedded browsers), so analytics files them under Direct. Even referred visits may not be grouped as "AI" by default. Without deliberate setup, AI's contribution is invisible and undervalued.
Setup (GA4 patterns)
- Use the AI channel grouping if available. Newer analytics builds include an AI-assistant channel that classifies referred traffic from major assistants — enable and confirm it.
Create a custom channel group / segment for AI sources, matching the referrer/source domains of the assistants, for example:
chatgpt.com|chat.openai.com|openai.com|perplexity.ai|gemini.google.com| copilot.microsoft.com|claude.ai|you.com|grok.com|meta.ai|deepseek.comMatch on source/referrer to pull these out of generic Direct/Referral buckets.
- Tag links you control. Where you can influence a link the assistant shows (e.g. in
your own content or feeds), add UTM parameters (
utm_source,utm_medium=ai_assistant) for explicit attribution. - Track conversions by this segment. Attribute sign-ups, leads, or sales to the AI segment to measure outcome, not just sessions.
- Accept a residual gap. Some referrer-less AI traffic will remain in Direct; watch Direct for unexplained shifts that correlate with AI visibility gains, and report ranges rather than false precision.
Reading the data
- Volume & trend — AI sessions over time, by source.
- Quality — conversion rate and engagement of AI traffic vs. other channels (often high-intent, since the user asked an assistant and clicked through).
- Source mix — which assistants actually send traffic for this brand.
- Tie-back — correlate referral gains with citation/SOV gains from ai-visibility-tracking.
Output format
- The analytics configuration: channel group/segment definition and any UTM scheme.
- A reporting view: AI sessions, conversions, and quality vs. other channels.
- A caveat note on the residual Direct misattribution and how to read it.
(assumption)tags where platform specifics were unknown.
Common pitfalls
- Assuming Direct is "type-ins" when a chunk is unattributed AI traffic.
- Reporting AI sessions without conversions — volume without value.
- Over-claiming precision when referrer data is inherently incomplete.
- Setting it up once and not revisiting as assistants and referrer behavior change.
Related Skills
- ai-visibility-tracking — the citation/SOV side; pair both for the full picture.
- ai-visibility-audit — connects traffic outcomes back to readiness gaps.
- aeo-foundation — the conversions and goals worth attributing.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

