Not seeing data

A checklist for when events aren't showing up - from a missing snippet to a wrong key, localhost, or an ad-blocker.

Installed the SDK but the dashboard is empty? Almost every case is one of a handful of causes. Work through these in order - the first few take seconds.

Confirm the snippet is on the page

Open your live site, view source, and check the OakData script is present in the <head>. In the browser console, window.oak should be defined after load.

Check the key and host

The key must be your project's public key (it starts with oak_pub_) and belong to the project you're looking at. A secret key, a typo, or the wrong project's key all silently drop events.

console
js
oak.getDistinctId()   // should return an id, not undefined

Look for the ingest request

Open the Network tab, reload, and filter for oakdata. You want a POST to the ingest endpoint returning 200. If you see no request at all, an ad-blocker is the usual culprit. A 401/403 means the key is wrong.

Rule out localhost

By default the tracker still fires on localhost, but some setups disable it. If production works and local doesn't, that's expected - test on your deployed site, or enable localhost tracking in the script config.

Give it a moment, then check Live

Events are batched and flushed a beat after they fire. Load a page, then watch Live - a fresh visit appears within a second or two. The dated reports also depend on the date range being wide enough to include now.

Bots are hidden by default

If your only traffic so far is you testing from a script or a headless browser, it may be classified as a bot and hidden. Toggle Show bots to check.

Still stuck?