Quickstart

AttractOS tracks AI traffic in 4 steps: Create an account, add your domain, install a single script tag, and watch real-time data flow into your dashboard. The entire setup takes under 5 minutes.

Create an Account

Go to attractos.com and sign up with your email address. We use magic link authentication—no password required.

Add Your Site

In the dashboard, click Add Site and enter your domain (e.g., example.com). You'll receive a unique site key that looks like ak_abc123xyz.

Install the Tracking Script

Add the following snippet to your website. Place it before the closing </head> tag:

Installation

<!-- Add to your <head> -->
<script>
(function(w,d,k){
  w.aos=w.aos||{q:[]};
  w.aos.k=k;
  var s=d.createElement('script');
  s.async=true;
  s.src='https://attractos.com/t.js';
  d.head.appendChild(s);
})(window,document,'YOUR_SITE_KEY');
</script>

// Next.js / React (app/layout.tsx or _document.tsx)
import Script from 'next/script';

export default function RootLayout({ children }) {
  return (
    <html>
      <head>
        <Script id="attractos" strategy="afterInteractive">
          {`(function(w,d,k){
            w.aos=w.aos||{q:[]};
            w.aos.k=k;
            var s=d.createElement('script');
            s.async=true;
            s.src='https://attractos.com/t.js';
            d.head.appendChild(s);
          })(window,document,'YOUR_SITE_KEY');`}
        </Script>
      </head>
      <body>{children}</body>
    </html>
  );
}

# For server-side tracking (e.g., Django, Flask)
# See the Cloudflare Logpush integration for production use

import requests

def track_bot(site_key, page_path, user_agent):
    response = requests.post(
        'https://attractos.com/api/t',
        json={
            't': 'bot',
            'k': site_key,
            'p': page_path,
            'ua': user_agent,
        }
    )
    return response.json()

Replace YOUR_SITE_KEY with the key from your dashboard.

Verify Installation

Open your website in a browser and visit a few pages. Then check the AttractOS dashboard—you should see:

Live indicator showing your site is connected
Referral events if you came from an LLM service
Bot visits as AI crawlers discover your pages

Next Steps

Set Up Conversions Track when AI referrals convert to paying customers Bot Detection See which AI bots are crawling your content API Reference Access your data programmatically

Frequently Asked Questions

How long does it take to see data in my dashboard?

Data appears in real-time. As soon as the script is installed and a visitor (or bot) hits your page, you'll see the event in your dashboard within seconds.

Does the tracking script affect page performance?

No. The AttractOS script is lightweight (under 2KB gzipped), loads asynchronously, and runs after your page has loaded. It has zero impact on Core Web Vitals.

Can I use AttractOS with any website platform?

Yes. AttractOS works with any website that can include JavaScript - static sites, WordPress, Shopify, Next.js, Astro, and more. We also support server-side tracking via Cloudflare Logpush.

What data does AttractOS collect?

AttractOS tracks AI bot visits (user agent), LLM referrals (referrer URL), page paths, country, and conversion events you explicitly send. We do not track individual users, cookies, or personal data.