Help
Troubleshooting
Most missing-event problems are one of four things. Work down the list.
Events aren't arriving
1
Right key, right mode
A pk_test_… key writes to the sandbox — check the mode switcher in the dashboard matches the key you initialized with.
2
Initialization order
Construct the SDK before the first track call. A wrong key fails silently unless debug mode is on.
3
Ad blockers
Some blockers drop requests to analytics domains. Route through your own domain — see below.
4
Backfilled timestamps
Events with a past timestamp are accepted but only appear when your date range covers them — widen the range.
Debug mode
Debug mode logs every call, queue flush, and API response. Leave it off in production.
const alitycs = init({
apiKey: 'pk_live_4Kd9xTz2',
debug: true,
});
// console:
// [alitycs] track signup_completed · queued
// [alitycs] flush 3 events · 200 batch publishedAd blockers
Some blockers drop requests to third-party analytics domains. Point a CNAME at Alitycs and set it as the SDK's host — events then flow first-party.
a.yourdomain.comapi.alitycs.comCNAME, TLS provisioned automatically