Marketingdata ophalen met een AI-agent: GSC, GA4 en Google Ads

Elke maand staan er nieuwe cijfers in Google Search Console, Google Analytics en Google Ads — en elke maand blijft dat werk liggen omdat niemand tijd heeft om alles handmatig te exporteren en naast elkaar te leggen. Een AI-agent lost dat op: die haalt de data zelf op, via een serviceaccount met beperkte rechten. In dit artikel laat ik je zien hoe je zo'n koppeling opzet met Hermes, welke rechten je geeft (en welke niet), en hoe de output eruitziet.

Ik gebruik hiervoor onze eigen Hermes-installatie bij Voltti: dezelfde stappen, dezelfde terminal-output, zonder verzonnen cijfers. Nog geen agent geïnstalleerd? Begin met onze tutorial over Hermes installeren op desktop of terminal.

Marketingdata uit GSC, GA4 en Google Ads die samenkomen in een AI-agent
Drie databronnen, één verbinding: de agent haalt op wat jij anders handmatig exporteert.

Een serviceaccount aanmaken in Google Cloud

Een serviceaccount is een afzonderlijk account voor software. Het krijgt alleen de rechten die je toekent. Je eigen Google-account deel je dus nooit. En de configuratie hoef je niet zelf te doen: je geeft de agent één opdracht, de rest doet die zelf. Zo'n opdracht ziet er zo uit, met dezelfde flow die Hermes Desktop bij een echte klant uitvoerde:

Installeer gcloud en koppel Google Search Console voor [MIJN_WEBSITE] via een serviceaccount. Voeg het e-mailadres ervan toe in GSC via de browser, of geef mij het adres om het zelf toe te voegen. Gebruik read-only toegang, vraag mij om goedkeuring voor de rechten en test de verbinding.

De agent doorloopt de volledige flow zelfstandig. Eerst de terminal: gcloud installeren als dat nog niet op de machine staat, een Google Cloud-project aanmaken, het serviceaccount genereren met een JSON-key, de API’s activeren en de omgevingsvariabelen instellen. Daarna opent de agent de browser, gaat naar de gebruikersinstellingen van Google Search Console, Google Ads en Google Analytics, voegt daar het e-mailadres van het serviceaccount toe met read-only rechten en bewaart de wijziging. Bij die klant werkte alles naderhand meteen; de enige menselijke taak was meekijken en achteraf controleren of de rechten kloppen.

Liever zelf klikken, of draait je agent zonder browsertoegang? Dit zijn dezelfde stappen handmatig:

  • Maak in de Google Cloud Console een nieuw project aan (of hergebruik een bestaand project).

  • Creëer onder IAM & Admin een serviceaccount en genereer een JSON-key.

  • Activeer onder APIs & Services de Search Console API, Analytics Data API en Ads API.

  • Voeg het e-mailadres van het serviceaccount in Search Console (en later in Google Analytics en Ads) toe als gebruiker met read-only rechten.

  • Stel GOOGLE_APPLICATION_CREDENTIALS in op het pad naar het JSON-sleutelbestand.

Vanaf dat moment kan de agent zichzelf authenticeren bij Google. Bij Voltti draait deze combinatie in productie: een afzonderlijk serviceaccount met uitsluitend read-only toegang tot Search Console. Geen rechten op facturering, geen schrijfrechten, geen toegang tot andere diensten. Aan diezelfde minimale aanpak besteden we ook aandacht op onze pagina over veilig en verantwoord AI gebruiken.

hermes — Search Console rapport via serviceaccount

$ hermes "Trek de Search Console-statistieken van voltti.ai over juni–augustus 2026"

Google Search Console — voltti.ai (juni–augustus 2026)

Top queries

QueryKlikkenImpressiesPositieCTR
voltti682,475,0%
ai agent of chatbot03018,20,0%
ai assistent bedrijf01121,50,0%

Totaal

MetricWaarde
Impressies240
Klikken7

De site staat al op positie 2,4 op de merknaam, maar voor "ai agent of chatbot" (30 impressies, positie 18,2) is er nog geen enkele klik. Aanbeveling: een artikel of landingspagina die exact dat zoekwoord beantwoordt, plus interne links vanaf de homepage om de pagina autoriteit te geven.

Echte output van onze eigen Hermes-installatie: GSC-data van voltti.ai, opgehaald met een read-only serviceaccount.
hermes — Search Console rapport via serviceaccount

$ hermes "Trek de Search Console-statistieken van voltti.ai over juni–augustus 2026"

Google Search Console — voltti.ai (juni–augustus 2026)

Top queries

QueryKlikkenImpressiesPositieCTR
voltti682,475,0%
ai agent of chatbot03018,20,0%
ai assistent bedrijf01121,50,0%

Totaal

MetricWaarde
Impressies240
Klikken7

De site staat al op positie 2,4 op de merknaam, maar voor "ai agent of chatbot" (30 impressies, positie 18,2) is er nog geen enkele klik. Aanbeveling: een artikel of landingspagina die exact dat zoekwoord beantwoordt, plus interne links vanaf de homepage om de pagina autoriteit te geven.

Wat de agent ermee doet: van cijfers naar acties

De ruwe data is slechts het begin. In het voorbeeld hierboven zag je 240 impressies en 7 klikken over drie maanden (juni–augustus 2026), met 75% klikratio op het merkwoord maar nul klikken op bredere zoektermen als "ai agent of chatbot". De agent vertaalt die observatie zelf naar een concrete actie: een pagina schrijven die die zoekterm beantwoordt, plus interne links om die pagina autoriteit te geven. Hoe we die maandelijkse werkwijze inrichten, beschrijven we in ons artikel over SEO met een AI-agent.

Uitbreiden naar Google Analytics 4

Voor GA4 volg je dezelfde stappen als voor Search Console, met twee nuances. Eén: je activeert de Analytics Data API in plaats van (of naast) de Search Console API. Twee: je voegt het serviceaccount niet in Search Console toe, maar als Viewer op de GA4-property zelf, onder Property Access Management. Daarna kan de agent vragen stellen als "welke landingspagina's zorgen voor de meeste sessies?" en dezelfde tabelstructuur terugkrijgen als bij Search Console.

Een eerlijke nuance: bij Voltti zelf is de GA4-koppeling nog niet actief — we beginnen klein met Search Console en breiden uit als er een echte vraag is.

Voor Google Ads gebruik je eveneens een serviceaccount, maar daarnaast heb je een developer token nodig uit het API Center van een Google Ads-manageraccount. Met Test Account Access werkt dat token alleen op testaccounts. Explorer Access, Basic Access en Standard Access kunnen ook productieaccounts benaderen, elk met eigen limieten en voorwaarden. Controleer het toegekende niveau en de toegestane functies in de officiële uitleg over Google Ads-toegangsniveaus voordat je productiegegevens probeert op te halen.

Ook belangrijk: koppel Ads pas nadat GSC en GA4 werken. De meerwaarde van Ads-data zit immers in de combinatie — klikken en kosten naast organische impressies en landingspagina's. Wie alles tegelijk opzet, maakt fouten in rechten die pas later pijn doen. De voorbeeldoutputs die je in veel tutorials ziet, zijn daarbij vaak illustratief; controleer altijd welke rechten er echt achter zitten.

Die combinatie van bronnen is trouwens precies waar een agent het verschil maakt. Een bedrijf dat factureert via Moneybird wil bijvoorbeeld weten welke campagnes niet alleen bezoekers opleverden, maar ook werkelijk omzet: de agent haalt GSC- en campagnestatistieken op en legt die naast de factuurgegevens die via de API over dezelfde periode beschikbaar zijn. Om omzet aan een campagne toe te schrijven, heb je ook een betrouwbare koppeling tussen campagne, klant en factuur nodig. Dezelfde pragmatische aanpak voor je administratie beschrijven we in ons artikel over AI koppelen aan je CRM en CMS.

KenmerkEigen Google-account delenAfzonderlijk serviceaccount

Rechten

Volledige accounttoegang, moeilijk te beperken

Exact de scopes die je toekent, bv. alleen GSC read-only

Geldigheid van de toegang

Verloopt met je sessie, vraagt opnieuw inloggen

JSON-key blijft geldig tot je hem intrekt

Controle achteraf

Eigen naam in de logs, geen onderscheid mens/machine

Elke aanroep logt onder het serviceaccount, traceerbaar

Terugdraaien

Wachtwoord wijzigen voor het hele account

Key of account intrekken zonder andere toegang te breken

Read-only is een keuze, niet een beperking

Alle koppelingen in dit artikel zijn bewust read-only: de agent kan cijfers lezen en analyseren, maar niets wijzigen in je Google-accounts. Zou je ooit schrijfrechten willen (bv. biedstrategieën aanpassen), dan ken je die rechten afzonderlijk toe en controleer je ze regelmatig opnieuw. Voor maandelijkse analyse is lezen voldoende — en het houdt het logboek overzichtelijk: elke aanroep is traceerbaar onder het serviceaccount.

Ben je nieuwsgierig wat een AI-agent voor jouw marketingdata kan betekenen in België en Nederland? Bekijk hoe een pilot verloopt of bespreek je vraag direct met ons via de knop hieronder.

Portretfoto van Seppe Gadeyne

Seppe Gadeyne

  • Artikel werd geüpdate op

    Veelgestelde vragen

    01Is een serviceaccount veiliger dan mijn eigen account?

    Ja, mits je minimale rechten geeft. Een serviceaccount kan niets buiten de scopes die jij toekent. Bij Voltti heeft die van Search Console uitsluitend read-only toegang; meer niet. Bovendien kun je een key op elk moment intrekken zonder je eigen account te raken.

    02Kan Hermes ook schrijven in Google Search Console?

    Niet met de read-only-rechten die we hier beschrijven, en dat is bewust. Voor analyse is lezen voldoende. Zou je ooit schrijfrechten nodig hebben, dan ken je die rechten afzonderlijk toe en controleer je ze regelmatig opnieuw.

    03Werkt dit ook met Google Analytics 4 en Google Ads?

    Ja, met dezelfde basis: Analytics Data API activeren en het serviceaccount als Viewer op de GA4-property zetten, of voor Google Ads een developer token regelen. Ons eigen serviceaccount heeft die toegangen bewust nog niet actief — we beginnen klein en breiden uit als er een echte vraag is.

    04Wat kost een serviceaccount in Google Cloud?

    Je kunt gratis een serviceaccount aanmaken en de Search Console API gebruiken. Kosten ontstaan pas als je API’s activeert die factureerbaar gebruik kennen; voor GSC-analyse is dat niet het geval.

    05Moet de JSON-key op dezelfde machine staan als Hermes?

    De machine die de API aanroept moet de key kunnen lezen, dus in de praktijk staat de key bij de agent. Bewaar de key buiten je back-ups van gewone bestanden en geef het bestand strikte rechten. Draait je agent op eigen hardware, kijk dan eerst naar onze uitleg over lokale en hybride AI.

    Klaar om je data aan een agent te koppelen?

    Bespreek je pilot