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).

  1. Create an integration and copy the integrationCode from Settings / Overview.
  2. Install the browser SDK (CDN script, installer, or SDK Customizer).
  3. Open your site once in a normal browser window (not a blocked iframe).
  4. DevTools → Network → filter collect or collect-batch. Expect status 200 (or 201) to the Sublyzer API host.
  5. 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

  1. Open browser DevTools → Network and Console
  2. Verify the script is loaded (sublyzer.js from CDN, Customizer path, or /sdks/sublyzer.js)
  3. Verify your data-integration-code matches the dashboard integration
  4. Confirm Network shows collect / collect-batch — not only the script download
  5. 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)
  1. Sandbox / demo login → open an integration Overview (0:00–1:00)
  2. Point at SDK onboarding checklist + status chip (1:00–2:00)
  3. Show docs: automatic vs manual + signup / checkout / trial snippets (2:00–4:00)
  4. Live site: Network collect → refresh Overview → connected (4:00–7:00)
  5. Walk Overview Business Metrics + Security / Performance tabs (7:00–10:00)

Deeper SDK install paths: /docs/sdk

Need help? Join our Discord.