<script defer data-domain="yourdomain.com" src="https://app.qusto.io/js/qusto.js"></script>
Two rules: data-domain must exactly match the domain you added in Qusto,
and the tag must load on every page you want measured.
Shopify
Install the Qusto app and connect your store for order webhooks. Checkout revenue needs the Customer Events pixel — copy it in one click from Settings → Shopify checkout pixel (paste into Shopify Admin → Settings → Customer events). Storefront pageviews use the Tracking Snippet / theme install. Details: Qusto for Shopify.
CMS & website builders
Paste the tag once into your platform's site-wide header / custom code / head field. Publish or save so it goes live.
- WordPress / WooCommerce — preferred: install the Qusto Connector
plugin (zip from dashboard Settings → WooCommerce). It injects the tracking snippet and can
connect order webhooks. Fallback: paste the tag via a header plugin (WPCode / Insert Headers and Footers)
or your theme
<head>. - Builders (Webflow, Squarespace, Wix, Framer, Ghost…) — site-wide custom code / head field.
- Google Tag Manager — Custom HTML tag on All Pages, then publish the container. (Official gallery template is pending listing — Custom HTML works today.)
WooCommerce plugin (snippet + orders)
- In Qusto: add your store domain, then open Settings → WooCommerce.
- Download
qusto-connector.zipand install it in WordPress (Plugins → Add New → Upload). - WooCommerce → Qusto: set API URL
https://app.qusto.io, paste a Qusto API key (Settings → API Keys), set Site Domain to match Qusto exactly, Save. - Click Connect to Qusto. The plugin injects
qusto.json the storefront (wp_head) and registers order webhooks. - Confirm with Settings → Tracking Snippet → Verify install.
Private beta zip (not on WordPress.org yet). To remove later: deactivate/delete the plugin and revoke any Woo REST keys created for Qusto.
Your own code
Add the tag in the one shared layout that renders <head> on every page
(before </head>), then deploy as you normally do.
AI assistant prompt
If you use an AI coding assistant on your project, paste this (replace the domain first):
Install the Qusto analytics snippet. Keep the tag byte-for-byte identical.
Tag:
<script defer data-domain="REPLACE_WITH_YOUR_DOMAIN" src="https://app.qusto.io/js/qusto.js"></script>
Find the single shared place that renders <head> on every page. Insert the tag once before </head>
(or the framework equivalent). If qusto.js is already present, do not duplicate — update domain only if needed.
Change nothing else. Show a diff before applying. Do not add secrets or env vars.
Verify it works
- In the dashboard: Settings → Tracking Snippet → Verify install (Installed / Tag found — no data yet / Not found).
- Or view page source (or search the HTML) for
qusto.js. - Open your site in a private window with blockers off, browse 2–3 pages, then check Dashboard → Overview within a few minutes.
| If | Check |
|---|---|
| No data | data-domain matches Settings exactly (including www vs apex); tag is in <head>. |
| Still stuck | hello@qusto.io |
How we classify traffic into channels
Once the snippet is live, Qusto groups every channel-relevant visit into one of nine acquisition channels. The same classifier runs on every surface, so a channel cannot mean two things on two pages. Tag your paid and owned traffic with UTM parameters and you can predict the result yourself from the table below.
| Channel | What it means |
|---|---|
| AI Search | An AI assistant (ChatGPT, Google AI Mode, Perplexity, Claude…) referred the visit. |
| Paid Social | A paid social campaign — a social platform with a paid marker, or utm_medium=paid_social. |
| Paid Search | A paid search click, identified by utm_medium=cpc, ppc, paid or paidsearch. |
| Affiliate | An affiliate or partner programme link (utm_medium=affiliate or partner). |
| An email or newsletter click, or a visit from a known webmail host. | |
| Organic Social | An unpaid social visit — a social platform with no paid marker. |
| Organic Search | An unpaid search engine referral. |
| Referral | Any other external site, or a tagged link whose tagging does not name a channel. |
| Direct | No channel evidence at all — no referrer and no UTM parameters. |
When a visit matches more than one rule, Qusto applies them in this order and stops at the first match. This is why a paid social click is counted once, as Paid Social, and not also as social or as direct:
- AI platform referrer → AI Search
utm_mediumsays paid social → Paid Socialutm_mediumsays paid search → Paid Searchutm_mediumsays affiliate → Affiliateutm_mediumsays email → Email- referrer is a known webmail host → Email
- referrer is a social platform → Paid Social if a paid marker is present, else Organic Social
- referrer is a search engine → Organic Search
- referrer is any other external site → Referral
utm_sourceorutm_campaignpresent, but no rule above matched → Referral- no evidence at all → Direct
Need help installing
Email hello@qusto.io — we can guide you or install via the Shopify app. Keep access limited and revocable; never share account passwords.
To remove Qusto later: delete the script from your header / custom code / GTM tag (or uninstall the Shopify app). Support can walk you through the matching path.