Skip to content
Agent Analytics

Getting Started

This is the shortest path from zero to a working Agent Analytics setup.

1. Get your API key

Section titled “1. Get your API key”

Sign up at app.agentanalytics.sh and generate an API key from the dashboard.

  • Use the API key (aak_*) for reads, project management, and agent skill setup.
  • Use the project token (aat_*) in the tracking snippet that goes on your site.

2. Pick and complete an install path

Section titled “2. Pick and complete an install path”

Go to the installation hub and complete the setup for the environment you actually use:

If none of those are a fit, the API reference stays available for direct integration.

3. Create your first project

Section titled “3. Create your first project”

After your agent is connected, ask it to create the first project for you:

  • Create a project called my-site.com
  • Create a project called my-site.com and give me the tracking snippet

If your agent has code write access to your site, ask it:

  • Set up analytics for my-site.com

Your agent should create the project and either:

  • return the tracker snippet for you to paste, or
  • install the tracker itself if it can edit the site

4. Add the tracker manually if needed

Section titled “4. Add the tracker manually if needed”

If your agent already added the tracker to your site, skip this step.

If it only created the project and returned a snippet, add the script before </body>:

<script defer src="https://api.agentanalytics.sh/tracker.js"
        data-project="my-site"
        data-token="aat_..."></script>

Page views are tracked automatically. Add custom events later with data-aa-event attributes or window.aa.track().

If your site uses Astro, add is:inline to that tracker tag.

For advanced tracker options like declarative events, cross-domain identity, consent, scroll depth, vitals, and error tracking, use the Tracker.js guide. If you want your agent to launch your first browser-side A/B test after setup, continue with AI Agent Experiment Tracking.

5. Verify the loop

Section titled “5. Verify the loop”

Once the install is working and the tracker is live, ask your agent one of these:

  • List my projects
  • How is my-site doing this week?
  • What are the top pages for my-site this week?
  • Show bot traffic for my-site this week

If the setup is correct, the agent should answer without you hand-writing requests.

Next

Section titled “Next”