More in Getting started
- Migrate from Google Analytics 4 or Baidu Tongji
- Add a website, app or mini-program
- How do I add TapCub to WordPress?
- How do I add TapCub to Shopify?
- Where do I paste the TapCub tracking code?
- Can I install TapCub with Google Tag Manager?
- How do I track a React, Vue or Next.js app?
- How do I check that TapCub is collecting data?
- Why does TapCub show no data after I installed it?
- What is a site, and how many can I add?
- Which time zone should I pick for a site?
- Which domains do I need to register?
- How do I keep my own visits out of the reports?
- Why does my visitor count differ from Google Analytics 4?
- Can I run TapCub alongside Google Analytics 4?
- How do I move my goals and events from GA4?
- Can I import my historical data from GA4?
- How do I add TapCub to Squarespace?
- How do I add TapCub to Wix?
- Which Content Security Policy rules does TapCub need?
- Do ad blockers block TapCub?
- How do I send events from my server?
- How do I install TapCub on React?
- How do I install TapCub on Nuxt?
- How do I install TapCub on Vue?
- How do I install TapCub on Next.js?
- How do I capture a HAR file for TapCub support?
- How do I create and manage API keys?
- How do I send events with the HTTP API?
- All guides in this category
Still have a question?
Could not find it? A person reads every message, usually within a few hours on business days.
Chat with usAnswered step by step on their own pages:
- How do I add TapCub to WordPress?
- How do I add TapCub to Shopify?
- Where do I paste the TapCub tracking code?
- Can I install TapCub with Google Tag Manager?
- How do I track a React, Vue or Next.js app?
- How do I check that TapCub is collecting data?
- Why does TapCub show no data after I installed it?
- How do I add TapCub to Squarespace?
- How do I add TapCub to Wix?
- Which Content Security Policy rules does TapCub need?
- Do ad blockers block TapCub?
- How do I send events from my server?
- How do I install TapCub on React?
- How do I install TapCub on Nuxt?
- How do I install TapCub on Vue?
- How do I install TapCub on Next.js?
Before you start
You need a TapCub account and a site created in the console. If you have not created one yet, follow Add a site first — it takes about two minutes and gives you the site key used below.
You also need to be able to edit the template that renders every page of your website, or the "custom code" area of your site builder. Nothing is installed on your server.
Analytics and live chat share this one script. Installing it does not show a chat bubble; chat stays off until you enable it in the widget guide.
Add the script
Open Web analyticsConfigurationSDK code and copy the snippet shown there. It already contains your site key. It looks like this:
<script defer src="https://static.pathclue.com/client.js" data-site="YOUR_SITE_KEY"></script>Paste it before the closing </head> tag on every page. The script is about 2 KB gzipped and loads asynchronously, so it never blocks rendering. It sends a pageview on the first load and on later in-site URL changes.
- Register the hostname. On the same SDK code page, add the domain visitors use, without
https://or a path. Subdomains are allowed. Hits from an unregistered host are dropped silently. - Paste the snippet. One copy per page. If a page ends up with two copies, only the first one runs.
- Deploy and open the site. Open a page on the registered hostname in a normal browser tab. A local file opened with
file://does not send.
Site builders and CMS
There is no plugin to install. Every site builder has a place for site-wide header code, and the snippet goes there once:
| Platform | Where to paste |
|---|---|
| WordPress | A header-code plugin, or a wp_head hook in a child theme. Once in the global header, not per post. WordPress steps |
| Shopify | theme.liquid, inside <head>. The platform-hosted checkout does not run theme scripts, so checkout pages are not tracked by this tag. Shopify steps |
| Webflow / Wix / Squarespace | Site settings → custom code → head. Use the site-wide field, not the page-level one. |
| Hugo, Hexo, Jekyll, Ghost, Typecho | The shared head partial of the theme. |
| Next.js, Nuxt, Vue, React | The root layout or app shell. Single-page apps are covered — the script listens for route changes. If your router uses # URLs, add data-hash="true" to the tag. Single-page apps |
| Google Tag Manager | A Custom HTML tag on All Pages. GTM steps |
If your theme caches rendered HTML, clear that cache after you change the header, or the old pages keep serving without the tag.
Verify the first visit
Open Web analyticsRealtime in one tab and load your site in another. The pageview should appear within a few seconds with the same path and title.
If it does not, open the browser's network panel and check two requests in order:
client.jsloaded. If it is missing, the tag is not in the page, or a browser extension blocked it.- A POST to
/api/v1/pulse. If the script loaded but no POST follows, the browser stopped the request (see below). If the POST exists but Realtime is empty, the hit was dropped on our side — most often because the hostname is not registered.
The collect endpoint answers 202 for stored and dropped hits. A 202 proves the request arrived, not that it was counted. Realtime is the only proof.
Common install problems
| What you see | Likely cause and fix |
|---|---|
| Script loads, no POST | The browser sent Do Not Track or Global Privacy Control. TapCub honors both by default and the script returns immediately. Test in a browser without those flags. |
| No POST, console shows a CSP error | Your Content-Security-Policy must allow script-src and connect-src for the TapCub origin. Identity and autocapture extensions load from the same directory; live chat loads from its own chat host, which the console error names when it is blocked. |
| POST exists, Realtime empty | Hostname not registered, site paused, monthly quota used up, or an exclusion rule matched. Check the SDK code page and plan usage. |
| Works on production, not locally | localhost does not send by default. While testing, add data-allow-local="true" to the tag and register localhost; remove both afterwards. Testing on localhost |
| Single-page app counts one pageview | Hash routing needs data-hash="true". Frameworks that replace history.pushState late may need the tag earlier in the head. |
Every cause and fix is in why TapCub shows no data. Still empty after these checks? Send us the page URL and a screenshot of the network panel through the contact page; that is usually enough to find it in one reply.
What to turn on next
- Enable live chat on the same snippet — a switch, not a second script.
- Keep your current analytics running for a week and follow the migration guide.
- Decide on cookieless vs identified collection before you send real traffic.
- Install the SDKs for apps and mini-programs if you have them; each gets its own site key.
See also
Did this answer your question?
We use your answers to fix and expand this page.
Couldn’t send. Please try again in a minute.
Thanks for the feedback. We’ll use it to improve this page.You’ve already sent feedback on this page. Thanks.