Problemen oplossen

Een checklist voor de meestgestelde integratievragen. Twijfel je? Open je pagina dan met ?bs=1 en houd de console in de gaten — de previewmodus logt het bepaalde segment en elke content-swap.

De assistent verschijnt niet

Staat hij live? In Testmodus rendert de assistent alleen met ?bs=1. Zet de Test/Live-schakelaar op Live en publiceer. Zie Test vs. Live.
Heb je gepubliceerd? Conceptwijzigingen bereiken bezoekers pas als je op Publiceren klikt.
Is er een plaatsing die matcht? De assistent koppelt zich aan de eerste matchende plaatsings-selector. Als geen selector op de pagina matcht, wordt er niets gerenderd. Controleer of de selector in de DOM van de pagina bestaat.
Element dat laat rendert? De widget probeert het ~10 s opnieuw, maar als je element daarna verschijnt, kies dan een selector die eerder bestaat.

Content wordt niet gewisseld

De eerste bezoeker ziet het origineel. Varianten zijn zelf-opwarmend: bezoeker #1 activeert een opwarming en ziet het origineel; bezoeker #2 krijgt de swap. Herlaad, of gebruik ?bs=1 om de cache te omzeilen.
Staat de BSR-content live? Die heeft een eigen Test/Live-schakelaar en moet zowel ingeschakeld als live zijn voor echte bezoekers.
Matcht de selector? Bevestig dat je CSS-selector daadwerkelijk het element (of de elementen) matcht dat je op die pagina bedoelt.

Het segment lijkt verkeerd

Veel bezoekers vallen terug op een fallback / unknown-segment (geen locatie, niet-NL, privacytooling). Dat is te verwachten — zie Hoe BSR werkt.
Forceer een segment om te testen met ?bsr-color=<slug> — zie URL-overrides.

Een flits of layoutsprong wanneer de class wordt toegepast

De segment-class wordt ~200 ms na het laden toegevoegd. Geef elementen een neutrale standaard en een CSS-transition, en vermijd het wijzigen van layoutafmetingen (om CLS te voorkomen).

Zoeken levert niets op (in deze docs)

Het doorzoeken van de documentatie wordt bij deploy opgebouwd. In lokale ontwikkeling kan het leeg zijn; op de gedeployde site werkt het.

Het analytics-event wordt niet geactiveerd

Het is afhankelijk van toestemming (Google Consent Mode analytics_storage of je consent-hook) en staat uit als je tenant analytics uitschakelt. Het wordt ook na het laden geactiveerd, zodra het segment is bepaald — trigger op de eventnaam, niet op page-ready. Zie Analytics & GTM.

Nog steeds vastgelopen?

Neem contact op met Bluestars met je tenant, de pagina-URL en een screenshot van de console-output bij ?bs=1 — dat is meestal genoeg om het probleem te lokaliseren.