AI-verkeertracking installeren
Leg AI-verwezen bezoeken vast met het browsersnippet, Tag Manager, WordPress of Cloudflare, en verbind GA4 en Search Console.
Deze pagina behandelt alles wat AI-verkeer voedt: de capture-installaties en de optionele Google-verbindingen. Heb je crawlertracking al server-side geïnstalleerd, dan rapporteert die installatie ook AI-verwezen bezoeken en kun je direct door naar conversie-events of Google Analytics 4 verbinden.
Wat wordt gevolgd
Twee verschillende soorten bezoekers vragen om twee verschillende capture-technieken:
| Bezoeker | Draait JavaScript | Vastgelegd door |
|---|---|---|
| AI-crawlers (GPTBot, ClaudeBot, ...) | Nee | Alleen server-side installaties |
| Mensen verwezen door AI-antwoorden | Ja | Server-side installaties of het browsersnippet |
De server-side installaties (Cloudflare, WordPress, eigen server) leggen beide vast. Het browsersnippet en Tag Manager leggen alleen menselijke referrals vast, wat ze de juiste keuze maakt wanneer je geen server-side code kunt draaien, en overal elders een aanvulling, geen vervanging.
Kies een installatiepad
| Jouw situatie | Gebruik |
|---|---|
| Server-side installatie draait al | Niets toe te voegen; bezoeken worden al gerapporteerd |
| Site achter Cloudflare | Cloudflare Worker (legt beide soorten vast) |
| WordPress | WordPress-plugin (legt beide soorten vast) |
| Je beheert tags in Google Tag Manager | Tag Manager |
| Elke site waar je een scripttag kunt toevoegen | Browsersnippet |
Browsersnippet
Het browsersnippet is een klein script dat vanuit de app wordt geserveerd. Het rapporteert alleen een bezoek wanneer de sessie vanaf een herkend AI-oppervlak kwam, en het identificeert je site met een browsertoken, dat publiek is en gebonden aan het domein van je sitesleutel, en dus veilig in de paginabron.
- Ga in de app naar AI-crawlers → Tracking installeren en open het tabblad Browser / GTM.
- Browsertokens vereisen een sitesleutel met een geregistreerd domein. Zegt het tabblad dat, voeg dan eerst een domein toe aan je sitesleutel en klik daarna op Browsertoken genereren.
- Kopieer het tweeregelige snippet en plak het in de
<head>van je site (of vóór</body>), op elke pagina:
<script>window.citlyze=window.citlyze||function(){(window.citlyze.q=window.citlyze.q||[]).push(arguments)};</script>
<script async src="https://app.citlyze.com/collect.js" data-token="cbt_YOUR_BROWSER_TOKEN"></script>De eerste regel is een stub die aanroepen van vóór het laden van het script in een wachtrij zet, zodat conversieaanroepen nooit een fout gooien.
Google Tag Manager
Gebruik Tag Manager wanneer de tags van je site daar leven. Twee opties:
- Custom HTML-tag: maak een nieuwe Custom HTML-tag, plak hetzelfde tweeregelige snippet van het tabblad Browser / GTM, zet de trigger op All Pages en publiceer de container.
- Community-template: Citlyze levert een importeerbare Tag Manager-template. Ga in Tag Manager naar Templates → New → Import, laad de Citlyze-template, maak er een tag van en vul je browsertoken in.
Beide doen hetzelfde; de template vermijdt alleen rauwe HTML-permissies in containers die die beperken.
Conversie-events
Zodra een capture-installatie live is, kan je site conversies rapporteren met één aanroep, met eventnamen die je eerst toestaat:
- Voeg op AI-crawlers → AI-verkeer de eventnamen die je wilt accepteren toe onder Capture-instellingen → Conversie-events (maximaal 10 kleingeschreven namen). Events die niet op de lijst staan worden geweigerd.
- Vuur het event af vanaf je site op de plek waar de conversie plaatsvindt:
window.citlyze("event", "signup");Conversies zijn same-session: ze worden toegeschreven aan de AI-bron die de geconverteerde bezoeker verwees. Nu je toch in de capture-instellingen bent, voeg daar ook eventuele Genegeerde IP's toe (kantoorreeksen, staging) zodat intern verkeer buiten het rapport blijft.
Google Analytics 4 verbinden
De Google-verbinding vult het AI-verkeersrapport vanuit GA4's eigen sessiedata, die bezoekers dekt die je snippet niet kan zien, en ze werkt al voordat er een installatie staat.
- Zoek op AI-crawlers → AI-verkeer de kaart Google Analytics & Search Console en klik op Google-account verbinden.
- Meld je aan met een Google-account dat de GA4-property kan bekijken en keur de read-only toegang goed die op het toestemmingsscherm van Google staat.
- Kies terug in de app de GA4-property om te synchroniseren en sla op.
De verbinding is read-only: Citlyze leest dagelijkse geaggregeerde rapportdata voor de gekozen property (sessies, gebruikers en conversies uit AI-assistentbronnen, per landingspagina en datum) en schrijft niets naar je Google-account. Data synchroniseert dagelijks.
Search Console verbinden
Dezelfde Google-verbinding kan een Search Console-site synchroniseren: kies de site in de kaart na het verbinden. Search Console-synchronisatie haalt dagelijkse klikken en vertoningen op per pagina en datum, wat naast de referraldata dekt hoe je pagina's presteren in de AI-functies van Google Search.
Verbinding verbreken en intrekken
- In de app verwijdert de knop Verbinding verbreken op de kaart de opgeslagen verbinding en de gesynchroniseerde Google-data voor die provider.
- Je kunt de toegang van Citlyze ook op elk moment intrekken via de beveiligingsinstellingen van je Google-account; daarna kan er geen verdere Google-data meer worden opgehaald.
- Overschakelen naar een andere property of site vervangt de eerder gesynchroniseerde data.
Privacyopmerkingen
- Google-toegang is beperkt tot read-only rapportagescopes die op het toestemmingsscherm zijn goedgekeurd; er is geen schrijftoegang.
- Het browsertoken is bewust publiek; de ingest controleert het domein van de rapporterende pagina tegen het geregistreerde domein van de sitesleutel.
- Referral-events registreren het landingspad, de referrer en grove apparaat- en landcontext, geen bezoekersidentiteiten.
- Referralgeschiedenis wordt bewaard volgens je plan (30, 90 of 400 dagen); zie Plannen en limieten.
Controleren
De sitesleuteltabel op Tracking installeren heeft een kolom Laatste gebeurtenis die wordt bijgewerkt zodra je installatie de eerste geaccepteerde melding aflevert; AI-referral-kliks tellen mee. AI-verwezen bezoeken verschijnen op de AI-verkeerspagina zodra echte sessies binnenkomen; op sites met weinig verkeer kan dat een dag of twee duren. De Google-kaart toont het aantal gesynchroniseerde sessies zodra de eerste dagelijkse synchronisatie is afgerond.