Cookie consent

Optionally show a consent banner to visitors in the regions you choose — and hold all tracking until they accept.

Piqo is privacy-first: no personal data, no third-party scripts, and a first-party cookie (or fully cookieless mode) instead of cross-site fingerprinting. Because of that, most sites don't need a consent banner at all. But if you operate where consent is expected — the EU (GDPR), California (CCPA/CIPA), or anywhere you'd rather be cautious — you can turn on a built-in, geo-targeted banner that blocks tracking until the visitor agrees.

This is an optional control to help you do what your lawyers advise — it isn't legal advice. You decide which regions need a banner and what it says.

How it works

  • A visitor in one of your chosen regions sees the banner, and nothing is tracked — no events, no cookie — until they click Accept.
  • If they Decline, Piqo tracks nothing for them.
  • Visitors outside your chosen regions are tracked normally and never see a banner.
  • The choice is remembered in their browser, so the banner only shows once.

1. Turn it on in Settings

Open your site's Settings → Cookie consent and enable the banner. Then:

  • Pick where to ask. Choose any of EU / EEA + UK, California, United States, or Everyone. Visitors are matched by IP location.
  • Customize the banner. Set the message, the Accept / Decline button labels, its position, and an optional link to your privacy policy. A live preview shows exactly how it looks.

2. Add data-consent to your snippet (once)

The consent gate only runs when your install snippet carries the data-consent flag. After saving, open the Tracking code tab, copy the updated snippet, and redeploy it:

<script defer data-site="YOUR_SITE_KEY" data-consent src="https://piqo.app/piqo.js"></script>
This is a one-time step. After the flag is in place, any later changes to your regions or banner text apply automatically — you never need to touch the snippet again.

3. That's it

Targeted visitors now see your banner and aren't tracked until they accept. To turn the feature off, just disable it in Settings — tracking returns to normal on the next pageview.

Using your own consent tool

Already running a consent manager (CookieYes, Osano, Cookiebot, a custom banner…)? You can drive Piqo from it instead of the built-in banner. Leave the regions empty (or simply keep your CMP in charge) and call:

// when the visitor accepts analytics cookies
window.piqo.consent('granted');

// when they decline
window.piqo.consent('denied');

Piqo holds all events until you call granted, then sends the queued pageview and everything after it. Calling denied keeps tracking off.

Good to know

  • The decision is stored in the visitor's browser (localStorage), not a cookie.
  • You can set how long a choice lasts before the banner asks again (default 180 days).
  • If Piqo can't determine a visitor's region, it fails closed — it won't track that visit rather than risk tracking without consent.
  • Works with both cookie and cookieless modes. Still no PII, ever.
  • You're responsible for the wording and which regions you target.