# Clear Saga documentation

> The clear story of every sale. Every page below is plain Markdown. The whole documentation in one file is at https://clearsaga.com/llms-full.txt.

## Get started

- [Clear Saga documentation](https://clearsaga.com/docs.md): Install the tracker, read your dashboard, track what matters to you and connect an AI agent. Every page describes what the product does today.
- [Quick start](https://clearsaga.com/docs/getting-started.md): From a new account to the first visit on your dashboard: create the account, add a site, paste one tag and watch it arrive.
- [Add the tracker](https://clearsaga.com/docs/tracker.md): The script tag that counts visits on your site: what to paste, where it goes, which of the two scripts to load and what it sends.
- [Script options](https://clearsaga.com/docs/script-options.md): Every attribute the tag understands, what each one does, which script it needs, and how the switches in the dashboard relate to them.
- [Troubleshooting](https://clearsaga.com/docs/troubleshooting.md): What to check when no visits arrive, when visits stop after a key change, when numbers look low or when a dashboard is locked.

## Install guides

- [Install guides](https://clearsaga.com/docs/install.md): Where the tag goes on your platform. Pick the tool your site is built with, or use the plain HTML steps that work on any website.
- [Install on a framework](https://clearsaga.com/docs/install/frameworks.md): Where the tag goes in an app built with a web framework, with the code written the way each framework wants it.
- [Install on a CMS or site builder](https://clearsaga.com/docs/install/site-builders.md): Where to paste the tag on a content management system, a site builder or a shop, step by step and without a plugin.
- [Install on a no-code or hosted tool](https://clearsaga.com/docs/install/hosted.md): Where to paste the tag on a no-code tool, a hosted site or an app made with an AI builder, step by step.
- [Install with a tag manager](https://clearsaga.com/docs/install/tag-managers.md): Load the tag through Google Tag Manager with a Custom HTML tag, and what to watch for when a tag manager is in between.

## Track

- [Custom events](https://clearsaga.com/docs/custom-events.md): Count the things visitors do on your site, such as a signup or a click on a button, with one attribute or one line of JavaScript.
- [Conversion goals](https://clearsaga.com/docs/conversion-goals.md): Mark the events and pages that matter to you, such as a signup or a thank-you page, and see what share of your visitors reach them.
- [Funnels](https://clearsaga.com/docs/funnels.md): See how many visitors get through a series of pages and events in order, such as a signup flow, and at which step the rest leave.
- [Campaigns and UTM tags](https://clearsaga.com/docs/campaigns.md): Tell your newsletters, ads and posts apart by tagging their links, and see which ones bring visitors and conversions.
- [Revenue](https://clearsaga.com/docs/revenue.md): What the Revenue screen shows, how an order is tied to a visit, and how a Shopify store sends its real orders.
- [Connect Shopify](https://clearsaga.com/docs/connect-shopify.md): Send the paid orders and refunds of a Shopify store to a site, so revenue is credited to the visits behind it.
- [Ad attribution](https://clearsaga.com/docs/ad-attribution.md): Switch on Match sales to ads to keep the ad click behind a visit and a private customer key on each Shopify order, and learn what is stored and what stays.
- [Performance and web vitals](https://clearsaga.com/docs/web-vitals.md): Measure how fast your pages load and respond for real visitors, find the slow ones, and know what counts as a good value.
- [404 tracking](https://clearsaga.com/docs/404-tracking.md): Find the broken links that send visitors to pages that do not exist, and see which page each broken link sits on.
- [Subdomains, several domains and hash routes](https://clearsaga.com/docs/subdomains-and-hash-routes.md): Count a site that spans subdomains or several domains, tell the hostnames apart, and record pages in apps that keep their routes in the URL hash.

## Store

- [Store summary](https://clearsaga.com/docs/store-summary.md): The Store page in one read: every tile of the Store section and of each ad platform, what each number covers, and the check that credit adds up.
- [Which ads earned sales](https://clearsaga.com/docs/which-ads-earned-sales.md): The Ads page of a store: credit by channel, campaign, ad set and ad, how a visit is matched to an ad, every column and its formula, overlap and live orders.
- [Attribution models](https://clearsaga.com/docs/attribution-models.md): The models of the store pages: who gets the credit for an order, what counts as a click, why the view models are estimates, and the check that credit adds up.
- [Creative report](https://clearsaga.com/docs/creative-report.md): The Creatives page of a store: every ad with its picture, status and numbers, where the thumbnails come from, and why uploaded spend has no creatives.
- [Profit report](https://clearsaga.com/docs/profit-report.md): The Profit page of a store: every line from gross sales to net profit, how each is worked out, how monthly costs are shared out, and what is left out.
- [New customers](https://clearsaga.com/docs/new-customers.md): The Customers page of a store: what makes an order new, returning or unknown, cohorts, repeat rate, and lifetime value by first product and first channel.
- [Costs and CSV upload](https://clearsaga.com/docs/costs.md): Enter what a store pays: the four cost rules, product costs by hand or from a CSV file, other costs, and ad spend uploaded as a CSV until accounts connect.

## Dashboard

- [The dashboard](https://clearsaga.com/docs/dashboard.md): What each screen of a site is for, what every number on the Overview means, and how the date range, the comparison and the cards work.
- [Filters and saved segments](https://clearsaga.com/docs/filters-and-segments.md): Narrow every number on a screen to one page, source, country or device, combine several filters, and save a set of them as a segment.
- [Realtime](https://clearsaga.com/docs/realtime.md): See who is on your site right now and what happened in the last 30 minutes, and know how fresh those numbers are.
- [Returning visitors](https://clearsaga.com/docs/returning-visitors.md): Switch on Remember returning visitors for a site, handle consent, read the Visitors pages and delete a visitor, and know what the cookie can and cannot do.
- [Shared dashboards](https://clearsaga.com/docs/shared-dashboards.md): Give someone a read-only link to the dashboard of one site, choose what it shows and when it ends, and take it back at any time.
- [Embed widgets](https://clearsaga.com/docs/embed-widgets.md): Put a small live card with your visitor numbers on a page of your own website, choose its colour and theme, and switch it off again.
- [Data export](https://clearsaga.com/docs/data-export.md): Download the page views and custom events of a site as a CSV file, and know exactly what the file holds and what it leaves out.

## Account and data

- [Team and roles](https://clearsaga.com/docs/team-and-roles.md): Give other people access to a workspace or to one site, see what each role can do, and change or end that access later.
- [Managing a site](https://clearsaga.com/docs/site-settings.md): Rename a site, change its domain or time zone, replace its site key, reset its statistics or delete it, and know what each change does.
- [Your account and signing in](https://clearsaga.com/docs/account.md): Create an account, sign in, change your name, email address or password, manage your sessions, and delete a workspace or your account.
- [Plans, usage and limits](https://clearsaga.com/docs/plans-and-usage.md): How plans are sized by monthly events, what counts as an event, how the trial works and what happens when a workspace reaches its allowance.
- [Privacy: cookieless by default](https://clearsaga.com/docs/privacy.md): How visitors are counted without cookies by default, what the returning-visitors switch adds, what is kept for each visit and how long data stays.
- [Bot filtering](https://clearsaga.com/docs/bot-filtering.md): Which automated traffic is left out of your numbers, why your own scripted test does not show up, and what no filter can catch.
- [Excluding visits](https://clearsaga.com/docs/excluding-visits.md): Leave out traffic you do not want counted, by path, hostname, country or IP address, and keep your own visits out of the numbers.
- [What works today](https://clearsaga.com/docs/status.md): One honest list of what is built and working, what waits for an outside connection and what is not built.

## Agents and API

- [Connect an AI agent](https://clearsaga.com/docs/agents.md): Create a workspace token and let an AI agent, a script or the command line tool read your numbers and manage funnels, goals and more.
- [MCP server](https://clearsaga.com/docs/mcp.md): Connect an AI agent to your workspace over the Model Context Protocol: the address, the setup for coding tools, and what the tools can do.
- [Command line](https://clearsaga.com/docs/cli.md): Read your numbers and manage funnels, goals and more from a terminal or a script: install the tool, sign in with a token and run commands.
- [Alerts and webhooks](https://clearsaga.com/docs/alerts-and-webhooks.md): Hear when a goal or a funnel crosses a threshold through a signed webhook, and see what the traffic alert and report emails do today.

## API reference

- [API reference](https://clearsaga.com/docs/api.md): How to call the API with a workspace token: requests, permissions, limits, filters, errors, and every operation.
- [Sites](https://clearsaga.com/docs/api/sites.md): The API operations about sites, each with its input, its output and an example.
- [Overview reports](https://clearsaga.com/docs/api/overview.md): The API operations about overview reports, each with its input, its output and an example.
- [Events](https://clearsaga.com/docs/api/events.md): The API operations about events, each with its input, its output and an example.
- [Realtime](https://clearsaga.com/docs/api/realtime.md): The API operations about realtime, each with its input, its output and an example.
- [Remembered visitors](https://clearsaga.com/docs/api/visitors.md): The API operations about remembered visitors, each with its input, its output and an example.
- [Funnels](https://clearsaga.com/docs/api/funnels.md): The API operations about funnels, each with its input, its output and an example.
- [Campaign links](https://clearsaga.com/docs/api/campaigns.md): The API operations about campaign links, each with its input, its output and an example.
- [Conversion goals](https://clearsaga.com/docs/api/goals.md): The API operations about conversion goals, each with its input, its output and an example.
- [Revenue](https://clearsaga.com/docs/api/revenue.md): The API operations about revenue, each with its input, its output and an example.
- [Performance](https://clearsaga.com/docs/api/performance.md): The API operations about performance, each with its input, its output and an example.
- [Store reports and costs](https://clearsaga.com/docs/api/store.md): The API operations about store reports and costs, each with its input, its output and an example.
- [Chart notes](https://clearsaga.com/docs/api/notes.md): The API operations about chart notes, each with its input, its output and an example.
- [Saved segments](https://clearsaga.com/docs/api/segments.md): The API operations about saved segments, each with its input, its output and an example.
- [Alert rules](https://clearsaga.com/docs/api/alerts.md): The API operations about alert rules, each with its input, its output and an example.
- [Embed widgets](https://clearsaga.com/docs/api/embeds.md): The API operations about embed widgets, each with its input, its output and an example.
- [The workspace](https://clearsaga.com/docs/api/workspace.md): The API operations about the workspace, each with its input, its output and an example.
- [Usage](https://clearsaga.com/docs/api/usage.md): The API operations about usage, each with its input, its output and an example.
- [Connections](https://clearsaga.com/docs/api/connections.md): The API operations about connections, each with its input, its output and an example.