Documentatie
Data Studio: rapporten bouwen met AutoPSEO-data
AutoPSEO heeft geen eigen Data Studio-connector. Gebruik de Search Console-connector van Google, een CSV-upload of een Google Sheet die via de REST API actueel wordt gehouden.
AutoPSEO biedt geen connector voor Data Studio, het dashboardprogramma van Google dat eerder Looker Studio heette. Toch kun je de cijfers daar op drie manieren weergeven: met de eigen Search Console-connector van Google voor de ruwe data, met een CSV die je uit een AutoPSEO-rapport exporteert, of met een Google Sheet die een geplande taak vult via de REST API van AutoPSEO. Welke optie het beste past, hangt af van hoe actueel het dashboard moet zijn en of je de analyses van AutoPSEO nodig hebt of alleen de ruwe metrics.
Optie 1: de Search Console-connector van Google
De connector van Google leest Search Console rechtstreeks uit. Je krijgt dus de ruwe metrics, maar geen analyses van AutoPSEO. Volgens de handleiding van Google voor de connector:
- Er zijn twee tabellen: Site Impression en URL Impression. Een gegevensbron gebruikt steeds één van beide. Voeg twee gegevensbronnen aan een rapport toe om allebei te tonen.
- Je hebt minimaal leesrechten nodig voor de Search Console-property en moet in beide producten met hetzelfde Google-account zijn ingelogd.
- Site Impression omvat web-, afbeeldings-, video- en nieuwsresultaten. URL Impression voegt daar Discover en Google News aan toe.
Kies om de connector toe te voegen Create → Data Source → Search Console, selecteer de site, de tabel en het standaardzoektype en klik op Connect.
Optie 2: een CSV uploaden vanuit AutoPSEO
Voor een eenmalig of maandelijks dashboard exporteer je een tabel uit een willekeurig rapport (Gegevens exporteren) en voeg je die toe met de CSV-uploadconnector van Data Studio. De uploadvereisten van Google bepalen hoe je exporteert:
- Velden moeten door komma's worden gescheiden. Stel daarom eerst Account → CSV export format in op Standard (US / UK).
- Het bestand moet UTF-8 zijn en een koprij hebben. Exports van AutoPSEO voldoen daaraan.
- Elk bestand dat je aan een dataset toevoegt, moet exact dezelfde kolommen in dezelfde volgorde hebben. Exporteer dus telkens hetzelfde rapport met dezelfde kolommen en dezelfde vergelijkingsinstelling.
- Nieuwe bestanden worden toegevoegd en dubbele rijen worden niet verwijderd. Upload dus geen overlappende datumbereiken.
- Een bestand mag maximaal 100 MB groot zijn en elke gebruiker heeft 2 GB aan uploadopslag.
Percentages worden met een procentteken geëxporteerd (27.03%). Controleer na een upload daarom de veldtypen.
Optie 3: een Google Sheet gevuld via de REST API
Voor een dashboard dat zichzelf actueel houdt, laat je een geplande taak de cijfers van AutoPSEO naar een Google Sheet schrijven en koppel je die sheet. De Sheets-connector van Google controleert bij elke rapportquery op gewijzigde waarden en nieuwe rijen.
- Open in AutoPSEO MCP & API en maak een API-sleutel aan met het bereik Read only. De sleutel wordt maar één keer getoond, dus sla hem op in de geheimen van je taak.
- Roep vanuit de geplande taak (Google Apps Script, een cronjob of een workflowtool) de REST API aan en schrijf de rijen naar de sheet.
- Voeg in Data Studio de sheet toe met de Google Sheets-connector en vink Use first row as headers aan.
Een aanroep voor de belangrijkste zoekopdrachten van de afgelopen 28 dagen ziet er zo uit:
curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
-H "Authorization: Bearer apk_live_..."
Elk antwoord is JSON, met het resultaat onder data en details over de aanroep onder meta. De REST API biedt dezelfde 19 Search Console- en GA4-tools als de MCP-server: properties, rijen uit Search Analytics, topzoekopdrachten, -pagina's en -landen, periodevergelijking, positiewijzigingen, nieuwe en verloren posities, contentverval, kannibalisatie, CTR-benchmark, page poaching, URL-inspectie, sitemaps, annotaties en de GA4-tools voor overzicht, uitsplitsing en sleutelgebeurtenissen. Topzoekopdrachten en toppagina's leveren maximaal 1,000 rijen op, toplanden maximaal 300 en search-analytics maximaal 5,000 ruwe rijen voor één of twee dimensies. Aanroepen zijn beperkt tot 60 per minuut per sleutel en 1,000 per uur per account. Het OpenAPI 3.1-document op https://app.autopseo.com/v1/openapi.json beschrijft elke parameter.
Welke optie kies je?
| Wat je nodig hebt | Gebruik |
|---|---|
| Ruwe klikken en vertoningen, door Google actueel gehouden | De Search Console-connector van Google |
| Een maandelijkse momentopname van één AutoPSEO-rapport | CSV-upload |
| Analyses van AutoPSEO op een schema, zoals positiewijzigingen of contentverval | Een Google Sheet gevuld via de REST API |
Als het dashboard vooral bedoeld is om een klant de cijfers te laten zien, kost een gedeelde rapportlink of een gepland Slack- of Teams-rapport mogelijk minder werk. In onze FAQ over Search Console in Looker Studio gaan we dieper in op de connector van Google.