Clycyo
Quickstart

Install Clycyo in minutes.

This quickstart is verified against the current live tracker and collector on 2026-04-26. It covers the fastest path to your first pageview, first custom event, and first identified subscriber.

01

Create a site in the dashboard

Use the Add Website flow to create a site and copy the generated tracking ID. The live app currently emits a tracker snippet that points to https://clycyo.com/tracker.js.

02

Install the tracker globally

Paste the script into the global head of your site so every page can send pageviews, SPA route changes, and heartbeats.

<script
  defer
  src="https://clycyo.com/tracker.js"
  data-tracking-id="YOUR_TRACKING_ID"
></script>
03

Verify your first pageview

Open the site once. The current live tracker sends a pageview immediately and then a heartbeat every 30 seconds. For SPA apps, it also tracks URL changes automatically via the History API.

04

Send your first custom event

Use the global browser API when something meaningful happens, for example signup completion, checkout start, or feature activation.

window.webanalytics.track('signup_completed', {
  plan: 'pro',
});
05

Identify known users or newsletter subscribers

When you know the visitor email, call identify so Clycyo can attach later activity to that identity. This is the current supported path for newsletter attribution as well.

window.webanalytics.identify('user@example.com', {
  source: 'newsletter',
  provider: 'beehiiv',
});
06

Tag newsletters and campaigns with UTM parameters

The live tracker reads utm_source, utm_medium, and utm_campaign from the current URL. Use them on every email link and paid campaign link so the dashboard can attribute traffic correctly.

Next reads