Install with one line, customize without limits

1. Install the package

npm install @cerez-io/sdk

2. Initialize at your app's entry point

Call init before any other tracker code (Google Analytics, Meta Pixel, GTM). Replace YOUR_SITE_KEY with the site key from the Installation page in the panel.

import { init, on, hasConsent } from '@cerez-io/sdk';

init({ key: 'YOUR_SITE_KEY' });

on('consent', () => {
  if (hasConsent('analytics')) {
    startAnalytics();
  }
});

3. Navigation in a single-page app

Call page() after client-side navigation; the first load is counted automatically. The example is for Vue Router.

import { page } from '@cerez-io/sdk';

router.afterEach(() => page());

Next.js

init must run in the browser; called on the server it does nothing. Add the component once to the root layout.

'use client';

import { useEffect } from 'react';
import { init } from '@cerez-io/sdk';

export default function CerezIo() {
  useEffect(() => {
    init({ key: 'YOUR_SITE_KEY' });
  }, []);

  return null;
}

Other functions: getConsent(), hasConsent(category), showBanner(), on('consent', fn). Options (host, lang, autoBlock, nonce, userId) are described on the package's npm page.

Inline Script Blocking

<!-- Inline script için: type="text/plain" + data-cb-category -->
<script type="text/plain" data-cb-category="marketing">
    fbq('init', 'PIXEL_ID');
    fbq('track', 'PageView');
</script>

Blocking Embedded Content (iframe)

For YouTube, Vimeo, Google Maps and social network embeds, write data-cb-src instead of src and set the category with data-cb-category. The content does not load until consent is given; a placeholder of the same size with "Allow and show" and "Preferences" buttons appears in its place. Once allowed, all embeds in the same category load; when consent is withdrawn they return to the placeholder. For YouTube the youtube-nocookie.com address is recommended.

<iframe data-cb-src="https://www.youtube-nocookie.com/embed/VIDEO_ID"
  data-cb-category="marketing" width="560" height="315" title="Video"></iframe>

Keyboard and Focus