citlyze docs
Citlyze gebruiken

AI-verkeertracking installeren

Registreer bezoeken via AI-antwoorden met het browsersnippet, Tag Manager, WordPress of Cloudflare, en koppel GA4 en Search Console.

Deze pagina behandelt alles wat AI-verkeer vult: de installaties die bezoeken registreren en de optionele koppelingen met Google. Heb je crawlertracking al server-side geïnstalleerd, dan rapporteert die installatie ook bezoeken via AI-antwoorden en kun je direct door naar conversie-events of Google Analytics 4 verbinden.

Wat wordt gevolgd

Twee soorten bezoekers vragen om twee verschillende manieren van registreren:

BezoekerVoert JavaScript uitVastgelegd door
AI-crawlers (GPTBot, ClaudeBot, ...)NeeAlleen server-side installaties
Mensen die via AI-antwoorden komenJaServer-side installaties of het browsersnippet

De server-side installaties (Cloudflare, WordPress, eigen server) leggen beide vast. Het browsersnippet en Tag Manager registreren alleen mensen die via AI-antwoorden komen. Daarmee zijn ze de juiste keuze als je geen server-side code kunt draaien, en overal elders een aanvulling, geen vervanging.

Kies een installatiepad

Jouw situatieGebruik
Server-side installatie draait alNiets toe te voegen; bezoeken worden al gerapporteerd
Site achter CloudflareCloudflare Worker (legt beide soorten vast)
WordPressWordPress-plugin (legt beide soorten vast)
Je beheert tags in Google Tag ManagerTag Manager
Elke site waar je een scripttag kunt toevoegenBrowsersnippet

Browsersnippet

Het browsersnippet is een klein script dat vanuit de app wordt geserveerd. Het rapporteert alleen een bezoek als de sessie vanaf een herkend AI-platform kwam, en het herkent je site aan een browsertoken. Dat token is openbaar en gekoppeld aan het domein van je sitesleutel, dus het kan veilig in de paginabron staan.

  1. Ga in de app naar Instellingen → Koppelingen → Websitetracking → Snippet installeren en open het tabblad Browser / GTM.
  2. 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.
  3. 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 geven.

Google Tag Manager

Gebruik Tag Manager als de tags van je site daar staan. Er zijn 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; met de template heb je alleen geen rechten voor eigen HTML nodig in containers die die rechten beperken.

Conversie-events

Zodra een van deze installaties live is, kan je site conversies rapporteren met één aanroep, met eventnamen die je eerst toestaat:

  1. Voeg op Meten → Bezoeken vanuit AI-antwoorden 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.
  2. Verstuur het event vanaf je site op de plek waar de conversie plaatsvindt:
window.citlyze("event", "signup");

Conversies tellen binnen dezelfde sessie: ze worden toegeschreven aan de AI-bron die de bezoeker stuurde die converteerde. Nu je toch in de capture-instellingen bent, voeg daar ook eventuele Genegeerde IP's toe (kantoornetwerken, staging) zodat intern verkeer buiten het rapport blijft.

Google Analytics 4 verbinden

De koppeling met Google vult het rapport AI-verkeer met de sessiedata van GA4 zelf. Daarmee zie je ook bezoekers die je snippet niet ziet, en de koppeling werkt al voordat je iets hebt geïnstalleerd.

  1. Zoek op Meten → Bezoeken vanuit AI-antwoorden de kaart Google Analytics & Search Console en klik op Google-account verbinden.
  2. 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.
  3. 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.

Om de belangrijke gebeurtenissen uit Google Analytics binnen te halen, open je Instellingen → Koppelingen → Verbinding beheren, vink je de gebeurtenissen aan die je wilt importeren en sla je op. Daarnaast leest Citlyze je sessies per kanaal (met betrokkenheid, belangrijke gebeurtenissen en omzet) en het land en apparaat van AI-verwezen bezoeken.

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, vertoningen en gemiddelde positie op per pagina en datum, totalen voor de hele site en je belangrijkste zoekopdrachten. Zo heb je naast de gegevens over verwijzingen ook je klassieke basiscijfers uit Google Zoeken. Vertoningen uit AI Overviews en AI Mode van Google verschijnen alleen in het eigen Generative AI-rapport van Search Console; Google biedt geen API voor die gegevens, dus geen enkele tool kan ze importeren.

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.

Privacy

  • Google-toegang is beperkt tot read-only rapportagescopes die op het toestemmingsscherm zijn goedgekeurd; er is geen schrijftoegang.
  • Het browsertoken is bewust openbaar; bij het binnenkomen van de gegevens controleert Citlyze of het domein van de rapporterende pagina overeenkomt met het geregistreerde domein van de sitesleutel.
  • Events voor verwijzingen registreren het landingspad, de verwijzende site en globale gegevens over apparaat en land, niet wie de bezoeker is.
  • De historie van verwijzingen wordt bewaard volgens je abonnement (30, 90 of 400 dagen); zie Abonnementen en limieten.

Controleren

De sitesleuteltabel op Websitetracking heeft een kolom Laatste gebeurtenis die wordt bijgewerkt zodra je installatie de eerste geaccepteerde melding aflevert; klikken vanuit AI-antwoorden tellen mee. Bezoeken via AI-antwoorden verschijnen op de pagina AI-verkeer zodra er 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.

Op deze pagina