Troubleshooting
Common issues and fixes when integrating the SDK and verifying data in the dashboard.
Verify the first event (under 10 minutes)
Goal: see SDK connected on the integration Overview checklist (event in the last 15 minutes).
- Create an integration and copy the
integrationCodefrom Settings / Overview. - Install the browser SDK (CDN script, installer, or SDK Customizer).
- Open your site once in a normal browser window (not a blocked iframe).
- DevTools → Network → filter
collectorcollect-batch. Expect status 200 (or 201) to the Sublyzer API host. - Reload the dashboard Overview. Checklist should mark First event received then SDK connected.
What “connected” means
- Live — event in the last 5 minutes
- Connected — event in the last 15 minutes (onboarding green)
- Ever received — at least one historical event for this integration
API: GET /data-collection/sdk-status?integrationId=… returns connected, live, everReceivedEvent, and nextSteps[].
No data appearing
Common causes
- SDK tag not present / not loading
- Wrong integration code
- CORS or API URL misconfigured
- No traffic yet (open the page at least once)
- Ad blockers / privacy extensions blocking the collect request
Quick checks
- Open browser DevTools → Network and Console
- Verify the script is loaded (
sublyzer.jsfrom CDN, Customizer path, or/sdks/sublyzer.js) - Verify your
data-integration-codematches the dashboard integration - Confirm Network shows
collect/collect-batch— not only the script download - Verify your API is reachable (and CORS allows your frontend origin)
Request payload sanity
// Collect body should include something like:
{
"integrationCode": "YOUR_24_CHAR_CODE",
"dataType": "page_view" | "error" | "user_metric" | …,
"data": { … }
}CORS (NestJS example)
app.enableCors({
origin: ['http://localhost:3000', 'https://yourdomain.com'],
credentials: true,
});TestingAI runs failing
- Ensure the target URL is reachable from the public internet
- Check logs/stream endpoints in the dashboard
- Try a smaller run (fewer agents/pages/clicks)
See: TestingAI Guide
10-minute demo script (no improvising)
- Sandbox / demo login → open an integration Overview (0:00–1:00)
- Point at SDK onboarding checklist + status chip (1:00–2:00)
- Show docs: automatic vs manual + signup / checkout / trial snippets (2:00–4:00)
- Live site: Network
collect→ refresh Overview → connected (4:00–7:00) - Walk Overview Business Metrics + Security / Performance tabs (7:00–10:00)
Deeper SDK install paths: /docs/sdk
Need help? Join our Discord.