Atribusi docs

Atribusi is a first-party analytics product. This guide covers install, goals, and custom events.

Install the tracker

Add this snippet before </body> on every page:

<script
  async
  id="a-tracker"
  data-api-key="YOUR_API_KEY"
  data-api-host="https://app.atribusi.com/api"
  src="https://app.atribusi.com/tracker.js"
></script>

Replace YOUR_API_KEY with the key from Websites → [your site].

Optional attributes:

• data-track-local-host="true" — also track localhost
• data-scl="true" — show a small “Powered by Atribusi” badge

The tracker auto-starts on load (unless the visitor is a bot). It:

• Creates a visitor cookie and session
• Sends pageviews on load and SPA navigations
• Tracks outbound link clicks by default

JavaScript API

When the script loads, window.atribusi exposes:

const { trackEvent, trackPageview, enableAutoPageviews, enableAutoOutboundTracking } =
  window.atribusi;

trackEvent(name, options?, eventData?)

Send a custom event (or goal event):

window.atribusi.trackEvent('signup');
window.atribusi.trackEvent('purchase', {
  props: { plan: 'pro', value: 49 },
});

props must be a JSON-serializable object. Props show in Deep Insights → Custom events (and property breakdowns when enabled).

trackPageview()

Send a pageview for the current path. Rarely needed — auto pageviews are on by default.

Goals

In the app, open Websites → [site] → Goals.

Atribusi records one conversion per goal per session.

Reports

• Overview — traffic, audience, devices, pages, sources
• Insights — conversion KPIs, channels, entry pages, UTM campaigns, custom events, CSV export
• Real-time — live visitors and session journeys

Team sharing

Owners can invite users from Websites → Shared Websites:

• Viewer — read analytics
• Editor — read analytics and manage goals

Privacy

From Account Settings you can export your account data or delete site analytics / your account (when those controls are enabled for your plan).

Cookieless mode

Pass data-cookieless="true" on the tracker script (when enabled) to keep visitor IDs in memory only for the current tab. See the cookieless release notes for limits.