Google Tag Manager

If your site already runs Google Tag Manager and you cannot touch the site's HTML, you can deploy Clickport as a Custom HTML tag. It works well; just know the trade-off below before choosing this route.

Direct install is more reliable. Ad blockers block GTM itself far more often than they block a first-party analytics script. When GTM is blocked, every tag inside it disappears, Clickport included. If you can paste one line into your site's <head>, prefer the direct install; use GTM when that is not an option.

Set up the tag

  1. In Clickport, add your site and copy your tracking snippet:
<script defer data-domain="yoursite.com"
  src="https://clickport.io/tracker.js"></script>
  1. In Tag Manager, go to Tags and click New.
  2. Click Tag Configuration and choose Custom HTML.
  3. Paste the full snippet, including the <script> tags, into the HTML field. Leave "Support document.write" unchecked; Clickport does not use it.
  4. Click Triggering and pick Initialization - All Pages. The standard All Pages page-view trigger works too; Initialization just fires earlier, so short visits are less likely to slip through untracked.
  5. Name the tag (for example "Clickport Analytics"), save it, then click Submit and Publish the workspace.

Then visit your site once and check the realtime view. Clickport's verify check also inspects your published Tag Manager container, so it can confirm the tag is in place even before the first visit arrives.

Consent mode

Clickport does not use cookies and does not collect personal data, which is why it runs without a consent banner. If your GTM setup gates every tag behind a consent prompt anyway, be aware that you are choosing to lose the visitors who decline; there is no compliance requirement to put Clickport behind consent.

Good to know

  • Custom HTML tags run in regular web containers. Server-side GTM containers do not execute custom HTML; if you run a server container, install the snippet directly on the site instead.
  • GTM may reformat quotes inside custom HTML when it minifies. The Clickport snippet is a single script tag and is not affected.
  • One tag covers your whole site, single-page apps included; the tracker handles client-side navigation itself. See SPA Tracking.
  • Exclude your own visits while you test. See Exclude Your Visits.

Related

  • Installation - The direct install, recommended where possible
  • Proxy Setup - Serve the tracker from your own domain for maximum reliability
  • Troubleshooting - If no data shows up after publishing