> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecliro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI referrals

> Track visits and sessions that AI assistants send to your website with the Cliro tracking snippet.

**AI referrals** measure the visitors that arrive at your site from AI assistants like ChatGPT, Claude, Gemini, Copilot, Perplexity and others — the real traffic your AI visibility generates.

## How it works

You add a small Cliro tracking snippet to your site. It loads asynchronously, detects when a visit comes from a known AI assistant, and reports the event to Cliro. It's lightweight and designed not to affect your site's performance.

## Set up tracking

<Steps>
  <Step title="Copy your snippet">
    Go to **Analytics → AI referrals → Setup** and copy the HTML snippet. It contains a unique **tracking key** for your brand.
  </Step>

  <Step title="Paste it in your site's head">
    Add the snippet inside the `<head>` of every page you want to track, as close to the top as possible.
  </Step>

  <Step title="Publish">
    Deploy your site. Cliro starts recording AI-referred visits automatically.
  </Step>
</Steps>

## Improve attribution with tagged links

Many AI assistants open links without passing a referrer, which can hide where a visit came from. To capture attribution reliably, encourage links that carry an explicit marker — for example:

```
https://yourbrand.com/product?ref_llm=chatgpt
https://yourbrand.com/product?utm_source=gemini&utm_medium=llm
```

The snippet reads `?ref_llm=` and `?utm_source=` before falling back to the referrer, so attribution works even when the assistant hides it.

## What's captured

For each AI-referred visit, Cliro records the **AI assistant** and detection method, the **page** visited, the **referrer**, any **UTM parameters**, a **session ID**, and basic browser info. IP addresses are **hashed** — the raw IP is never stored, and only known AI traffic is tracked.

<Note>
  AI referral events count toward a monthly limit based on your plan, which resets each billing cycle. Once the limit is reached, additional events are not counted but your site keeps working normally.
</Note>

## Rotating your tracking key

If you think your tracking key was exposed, you can **rotate** it from the setup screen. The old key stops working immediately, so update the snippet on your site with the new one.

## Attribution caveats

* If a visitor copies and pastes your link, the referrer is lost.
* If they read an AI answer, then search Google and click from there, the visit is attributed to Google (last click).
* Some assistants navigate via preview or proxy, so the referrer may not be the assistant itself.
