Developer docs

Next steps after onboarding

Your snippet is live and data is flowing. Here is how to turn raw traffic into events, conversions, and a team that can act on it.

v3.0Updated May 2026

Where to go from here

Onboarding installs the tracker and confirms datakant is receiving data. This guide covers the setup that turns that raw traffic into something you can report on and share — it takes about fifteen minutes and none of it needs a developer.

Work through the steps in order. Each one builds on the last, and you can always come back and refine.

  1. Assign your consent signals so datakant knows what it is allowed to collect.
  2. Import your most important elements by clicking through your live site.
  3. Add events and flag conversions for the actions that matter.
  4. Enable event forwarding to send events on to GA4 and Meta.
  5. Add server-side tracking if you want to beat ad blockers and ITP.
  6. Invite your team so colleagues can see the same dashboards.

Open Data Settings from the sidebar (it sits under Configuration) — or go straight to /dashboard/settings. It opens on the Mode & Consent tab. Your collection mode is already set from onboarding — here you tie each tracking system to a consent signal from your cookie banner.

  1. The page opens on the Mode & Consent tab by default. Step 1 (your collection mode) is already set from onboarding — go straight to Step 2.
  2. Under Step 2 · Map signals, assign a signal to each tracking system (datakant, GA4, Meta) in the Mapped consent signal column. This is how you tell datakant which consent your CMP grants for analytics and marketing.
  3. Click Save changes in the bar that slides up at the bottom. Each mapped row then shows an Active status.
No signals to choose from yet? The dropdown fills once datakant has seen consent events from your CMP or dataLayer. If nothing appears, confirm your consent banner is live, use the Re-detect button, or paste the consent snippet the tab offers. PII fields and geo only flow once the mapped signal is granted.
Who can change this: Owners, Admins, and Managers assigned to the property can edit and save. Viewers see the tab read-only.

2. Import your most important elements

You never have to write a CSS selector. The tracker watches real clicks on your site and builds a catalog of elements visitors interact with — buttons, links, and form submits. You pick from that visual list when you define an event.

To seed the catalog quickly, open your live website in a normal browser and click the things that matter, a few times each, across the pages where they appear:

  1. With the snippet installed, open your live site in a normal browser tab (not a private or automated one — bot traffic is ignored).
  2. Click your primary CTAs, signup and checkout buttons, form submit buttons, and key navigation links.
  3. datakant records each click and adds the element to your catalog, with a confidence score and a screenshot preview.
  4. The elements then appear under Data Settings → Events & Conversions → Add Event → Element click, ready for you to name in the next step.
Give it a little time. An element needs a handful of observations before it shows up, so a brand-new button may take a few hours of real traffic to appear. The screenshot preview lands slightly after the element itself, so give it a moment.

3. Add your events and flag conversions

Go to Data Settings → Events & Conversions (/dashboard/settings?tab=events). The table lists every element datakant detected plus any events you define manually. An event is simply an action worth counting; a conversion is an event that matters to the business.

Add an event

  1. Click Add Event at the top right. A three-step wizard opens.
  2. On the first step, Trigger, pick how the event fires — Element click, URL match, or Scroll depth — then click Continue.
  3. On the Configure step, set up the trigger: for Element click, pick your element from the catalog list (the screenshot preview confirms you have the right one); for URL match, enter the path and match type; for Scroll depth, pick 25, 50, 75, or 100 %. Click Continue.
  4. On the final step, Finalize, review the Event name (lowercase snake_case, e.g. checkout_complete) and add an optional description.
  5. Turn on Treat as a conversion if this action counts as a goal. The Default value and Currency fields light up — enter a value if the conversion has a monetary worth.
  6. Click Save event. It now appears in the table.

Flag an existing event as a conversion

Already have the event in the list? Flip the toggle in the Conversion column of its row. It saves immediately, and the Conversions tile at the top of the tab increments.

Why conversions matter: Only conversions feed your funnels, attribution, and ROI reports — and when forwarding is enabled, they are sent to GA4 and Meta as conversions. Give the ones with a monetary value a Default value so revenue attribution works.

4. Enable event forwarding

Forwarding relays your events on to GA4 and Meta so you can keep using those tools while datakant handles collection. You connect each destination separately under Data Settings → Destinations.

  1. Open Data Settings → Destinations for the property.
  2. On the Google Analytics 4 or Meta Pixel card, click Connect.
  3. Enter the credentials for that destination (see the two cards below).
  4. Map a consent signal — this is required. Forwarding only sends events for visitors who granted the matching consent, so datakant will not let you save without it.
  5. Read the compliance notice, tick the box, and click Save changes to activate. The notice appears every time you switch a destination on — you remain the data controller for what GA4 or Meta receives.

Google Analytics 4

Paste your Measurement ID (G-XXXXXXXXXX) and choose a data region (EU or US). Find the ID under GA4 Admin → Data Streams.

Meta Pixel + CAPI

Enter your Pixel ID (15–16 digits) and a Conversions API access token, then map your datakant events to Meta's standard events (Purchase, Lead, …).

Avoid duplicate events

The one thing that can go wrong is double-counting. If you already send data to GA4 or Meta directly from your site, that tag and datakant would both report the same events. Remove the old tag so datakant is the only sender.

Already running GA4 on your site? Remove your existing GA4 tag — the gtag.js snippet, or the GA4 tag in Google Tag Manager — before you connect GA4 here. If both your own tag and datakant send to the same Measurement ID, GA4 double-counts pageviews and reports two users for every visitor. datakant should be the only sender to that property.
Already have a Meta Pixel on your site? Remove the standalone Pixel snippet (or the Pixel tag in GTM) and let datakant own both the Pixel and the Conversions API for that Pixel ID. datakant shares one event_id across the browser Pixel and the server-side CAPI so Meta counts each conversion exactly once — a separate on-site Pixel breaks that dedup and inflates your conversions and match quality.
Consent is always enforced. "Require consent before forwarding" is locked on: GA4 needs analytics consent, Meta needs marketing consent, and events for which consent was denied are never forwarded.

5. Add server-side tracking (optional)

Server-side tracking is a paid, per-property add-on that routes your analytics through a subdomain of your own domain (a first-party CNAME to datakant's EU edge) instead of sending events straight to a third-party endpoint. Same events, same data — a more resilient route. The dedicated Server-side tracking guide has the full walkthrough.

Why enable it

Survives ad blockers and ITP

Because requests are same-site, privacy browsers and ad blockers treat them like any other call to your own domain — recovering signal you would otherwise lose.

Longer, more stable sessions

First-party cookies are not subject to Safari ITP's seven-day cap on script-set cookies, so sessions stay intact and counts are cleaner.

More reliable data capture

The same events arrive far more consistently, which means fewer gaps in your reports and attribution.

Your own domain

Analytics runs through analytics.yoursite.com, a subdomain you control via a one-time DNS change.

Unlocks server-side forwarding

Events are relayed to GA4 and Meta from the edge rather than the browser — the same resilience benefits apply to your forwarded destinations.

EU-edge minimisation

Every event is processed on datakant's EU edge, where the IP is truncated, the user-agent is reduced to a device class, and consent is enforced before anything is stored or forwarded.

How to enable it

  1. Buy the Server-side tracking add-on for the property from your billing settings (some plans already include one).
  2. Open Data Settings → Server-side tracking and copy the subdomain datakant suggests.
  3. Add the DNS TXT and CNAME records shown at your DNS provider, then click Verify.
  4. Once the domain verifies, replace your snippet with the first-party snippet and deploy. Swap the snippet last — keep the standard one until the CNAME resolves.
Pricing and inclusions vary by plan. Server-side tracking is billed per property; check the Billing tab for the current price, and note that Professional and Enterprise plans include one or more at no extra cost.

6. Invite your team

Open the user menu in the top-right corner and click Account settings — or go straight to /dashboard/account-settings directly. Only Owners and Admins can invite people.

  1. In Account settings, open the Account users tab.
  2. Click Invite User.
  3. Enter the person's email, an optional full name, and choose an Account Role — Viewer, Manager, Admin, or Owner.
  4. Click Add User. To give someone access to a single property instead of the whole account, use the Property users tab and Invite to property.

Roles at a glance

  • Owner — the account creator; full access to everything, cannot be removed, and the only role that can grant billing access.
  • Admin — full read and write access to every property, plus the ability to invite and manage users.
  • Manager — full access, but only on the properties assigned to them.
  • Viewer — read-only access on the properties assigned to them.
Seats are plan-driven. The Account users tab shows how many seats you have left. Every user counts toward the seat limit — to add more, buy extra-user add-ons or upgrade your plan.