Google Ads-logo

Reclame

Verbinden Google-advertenties naar Excel, Google Sheets, AI en REST

Campagnes, advertentiegroepen, zoekwoorden en uitgaven als doorzoekbare tabellen. Koppel ze aan uw eigen conversiegegevens die in PostgreSQL of een exportmap van een spreadsheet staan.

Eén verbinding, elk oppervlak

Waar uw Google Ads-gegevens naartoe kunnen worden gestuurd

Query Streams zet een Google Ads-account om in 12 SQL-tabellen — campagnes, advertentiegroepen, advertenties, zoekwoorden, zoektermen, geografische gegevens, apparaten, demografische gegevens, landingspagina's en wijzigingsgeschiedenis — die leesbaar zijn vanuit Microsoft Excel, Google Sheets, Power BI, AI-assistenten via MCP en een REST-eindpunt. Uitgaven worden weergegeven als een kolom die u kunt koppelen aan inkomsten, en dat is precies de bedoeling: de afstemming die normaal gesproken maandelijks in een spreadsheet plaatsvindt, wordt één overzicht.

  1. Voor uw team, leveranciers en partners
  2. Google Ads naar Excel Microsoft Excel · Excel-invoegtoepassing

    Haal live Google Ads-resultaten rechtstreeks naar een werkblad en vernieuw ze wanneer nodig — in Excel op de desktop, Excel Online en Microsoft 365.

    Hoe Excel werkt
  3. Google Ads naar Google Sheets Sheets-add-on

    Voer een opgeslagen Google Ads-query uit vanuit de zijbalk en sleep de rijen naar het spreadsheet. Gedeelde medewerkers kunnen het spreadsheet zelf vernieuwen.

    Hoe Google Sheets werkt
  4. Vraag Nova naar Google Ads Nova AI · tekst naar SQL

    Stel een vraag in begrijpelijke taal. Nova kent je Google Ads-tabellen al, schrijft en voert de SQL-query uit, legt het antwoord uit en visualiseert het in een grafiek – je hoeft geen query te schrijven en geen inloggegevens te verstrekken.

    Hoe Nova werkt
  5. Google Ads naar Data Viewer Resultaten delen · team, leveranciers, partners · telefoon, tablet, desktop

    Deel live Google Ads-resultaten met iedereen – een collega, een leverancier, een partner – als een bladwijzer die de resultaten automatisch vernieuwt wanneer deze wordt geopend, op een telefoon, tablet of desktop. Ze zien de resultaten, maar nooit de SQL-query of de inloggegevens.

    Hoe de gegevensviewer werkt
  6. Voor apps en systemen
  7. Google Ads REST API HTTP-eindpunt

    Publiceer een Google Ads-query als een geauthenticeerd JSON-eindpunt dat elke applicatie kan aanroepen, met een OpenAPI 3.1-specificatie en kant-en-klare collecties voor Postman, Insomnia en Hoppscotch. Er wordt geen databasepoort geopend.

    Hoe een REST API werkt
  8. Google Ads naar Power BI Power Query M

    Plak de gegenereerde Power Query M in de geavanceerde editor van Power BI en het rapport leest live Google Ads-resultaten via HTTPS — zonder ODBC-stuurprogramma en zonder geopende databasepoort.

    Hoe Power BI werkt
  9. Google Ads naar Airtable Automatiseringsplatform

    Synchroniseer Google Ads-rijen met een Airtable-database volgens een schema, of haal ze op in een Airtable-automatiseringsscript.

    Hoe Airtable werkt
  10. Google Ads naar Baserow Automatiseringsplatform

    Vul een Baserow-tabel met gegevens uit Google Ads via het REST-eindpunt — zowel op een zelfgehoste locatie als in de Baserow-cloud.

    Hoe Baserow werkt
  11. Google Ads naar SeaTable Automatiseringsplatform

    Houd een SeaTable-database actueel met Google Ads-gegevens zonder een bestand te exporteren of de database openbaar te maken.

    Hoe werkt SeaTable?
  12. Google Ads naar Smartsheet Automatiseringsplatform

    Importeer de resultaten van Google Ads in een Smartsheet-tabel, zodat plannen en rapporten rechtstreeks uit het bronsysteem worden gehaald en niet uit de export van vorige week.

    Hoe Smartsheet werkt
  13. Google Ads naar Anvil Anvil Works · App-platform

    Ondersteun een Anvil Python-app met Google Ads via het REST-eindpunt in plaats van databasegegevens in de app in te sluiten.

    Hoe werkt Anvil?
  14. Voor AI-tools
  15. Google Ads MCP-server Claude, Cursor en MCP-klanten

    Geef een AI-assistent alleen-leestoegang tot Google Ads met het schema dat nodig is om correcte SQL-query's te schrijven — zonder inloggegevens in de chat.

    Handleiding voor Google Ads
  16. Bezorgd aan mensen
  17. Google Ads-waarschuwingen en -rapporten Slack · Discord · E-mail · Webhook

    Plan een Google Ads-query in en laat de resultaten naar Slack, Discord, e-mail of een ondertekende webhook verzenden. Of wacht met verzenden totdat een bepaald aantal resultaten, een drempelwaarde of een percentageverandering de door u ingestelde grens overschrijdt.

    Hoe waarschuwingen en rapporten werken

Hoe het werkt

5 stappen, geen wijziging van de inkomende firewall

01

Verkrijg een ontwikkelaarstoken voor uw Google Ads-account en maak een serviceaccount aan met domeinbrede delegatie.

02

Installeer de netwerkagent en geef deze de serviceaccountsleutel, het ontwikkelaarstoken, het e-mailadres dat moet worden geïmpersoneerd en de klant-ID. Een beheerdersaccount-ID is optioneel, om toegang te krijgen tot een subaccount.

03

Kies welke van de 12 tabellen u wilt synchroniseren. Campagnes, advertentiegroepen, zoekwoorden, zoektermen, geografische gegevens, apparaten en het account zelf zijn standaard ingeschakeld.

04

Schrijf gewone SQL-query's voor gads.campaign, gads.search_term_view en de rest, of laat Nova dat voor je doen.

05

Lees de gegevens uit Excel, Sheets, Power BI, MCP of REST, gekoppeld aan elk systeem dat uw omzet beheert.

Diepgaande analyse van de functies

Wat Google Ads je biedt

Uitgaven direct naast inkomsten, in één overzicht.

Google Ads weet wat je hebt uitgegeven. Het weet echter niet wat de klant vervolgens aan jou heeft betaald, en voor een relevant rapport zijn beide gegevens nodig.

  • gads.campaign bevat gegevens over impressies, klikken, kosten, conversies en conversiewaarde per dag, waardoor het naadloos kan worden gekoppeld aan alles wat is gekoppeld aan de campagnenaam of UTM-tag.
  • gads.search_term_view is de daadwerkelijke zoekopdracht die iemand heeft ingetypt, en dat is waar het geld meestal weglekt. — en het kan worden gekoppeld aan uw eigen conversiegegevens in plaats van dat ze vastzitten in de advertentie-interface.
  • Geld wordt in microsaldo's ontvangen, precies zoals de API het rapporteert. Een dollar is 1.000.000, dus er is niets afgerond voordat je het zelf deelt.

De 12 tafels

  • Structuur — klant, campagne, advertentiegroep, advertentiegroep_advertentie.
  • Zoekopdracht — keyword_view, search_term_view, landing_page_view.
  • Storingen — geografische weergave, apparaatweergave, leeftijdsbereikweergave, geslachtsweergave.
  • Audit — change_history.
  • Elke rij bewaart ook het volledige API-antwoord in een JSON-kolom genaamd raw_data, zodat een metriek die geen benoemde kolom is, toch aanwezig is.

Waar de cijfers ophouden, eerlijk gezegd.

Twee dingen over advertentiegegevens waar elke tool rekening mee moet houden, laten we het maar meteen zeggen in plaats van het pas later te ontdekken.

  • De rapporten gaan terug tot gisteren, niet tot vandaag. — De cijfers van vandaag zijn onvolledig bij Google en zouden alleen maar misleidend zijn.
  • Bij elke incrementele run worden de gegevens van de afgelopen dagen en de nieuwe dag opnieuw gelezen, omdat conversies pas later worden geregistreerd en het getal dat je op maandag hebt opgevraagd niet hetzelfde getal is als waar Google donderdag op uitkomt.
  • De wijzigingsgeschiedenis wordt door de Google Ads API zelf beperkt tot 29 dagen. Het is een overzicht van recente wijzigingen, geen permanent auditlogboek.
  • Sommige geografische kolommen bevatten Google-criterium-ID's in plaats van plaatsnamen, en een paar advertentietekstkolommen zijn nog niet ingevuld. Wat er wel staat, is correct; wat er niet staat, is leeg en niet onjuist.

Gedeeld door elke API-connector

Hoe elke API-connector werkt

  • Je account wordt omgezet in tabellen — Eindpunten worden gekoppeld aan getypte SQL-tabellen met primaire sleutels en indexen, zodat u SELECT, JOIN en GROUP BY kunt schrijven in plaats van door JSON te bladeren.
  • Je kiest zelf wat er gesynchroniseerd wordt en hoe vaak. — elke tabel heeft zijn eigen interval, of helemaal geen. Indien de API van de leverancier dit ondersteunt, worden alleen records opgehaald die sinds de laatste keer dat de query is uitgevoerd zijn gewijzigd.
  • Het exemplaar is van jou. — het bevindt zich in een met AES-256-GCM versleuteld DuckDB-bestand naast de agent, op uw computer. Niet in onze cloud.
  • De verkoper hoort alleen van u. — De agent roept de API rechtstreeks aan vanuit uw eigen netwerk, waardoor uw token niet nodig is voor Query Streams om een query te beantwoorden.

Goed om te weten

  • Het is een gesynchroniseerde kopie, geen live proxy. — Een query leest gegevens die al zijn opgehaald, waardoor de resultaten met SQL-snelheid worden geretourneerd en de API-limiet nooit wordt overschreden. Geselecteerde tabellen kunnen bovendien een verouderde rij vernieuwen terwijl u deze leest.
  • De snelheidslimieten worden voor u gerespecteerd. — elke connector blijft ruim binnen de door de leverancier gepubliceerde limieten, zodat een rapport er niet voor kan zorgen dat uw account wordt afgeremd voor alle andere toepassingen die er gebruik van maken.
  • Niets wordt weggegooid. — Velden die niet in de tabel zijn opgenomen, worden bewaard in een JSON-kolom genaamd raw_data, die je nog steeds kunt opvragen.
  • Koppel het aan uw databases. — Een API-tabel en een SQL Server-tabel in dezelfde instructie is hier een gewone query, geen integratieproject.

Cross-source SQL

Voeg Google Ads samen met de rest van je gegevens.

De uitgaven worden geregistreerd in Google Ads, terwijl de inkomsten ergens anders worden bijgehouden. Daarom worden deze twee gegevens meestal maandelijks in een spreadsheet vergeleken. Eén overzicht kan de campagne, het account dat de campagne heeft gegenereerd en de factuur waarop deze is gefactureerd, samen weergeven. Elke bron voert alleen het deel uit dat nodig is, streamt het resultaat terug en de samenvoeging gebeurt centraal — de bronnen communiceren niet met elkaar en er wordt niets gekopieerd.

3 verbindingen · 3 agenten

Google-advertenties Reclame
PostgreSQL Relationele engine
Streep Betalingen en facturering

Eén verklaring

-- uitgaven van Google Ads, het account uit uw database, inkomsten van Stripe
SELECT   g.campaign_name, SUM(g.cost_micros) / 1000000 AS spend, SUM(i.amount_due) AS invoiced
VAN     advertenties.gads.campaign1       g
JOIN     pg_crm.publieke.klanten2 c ON c.utm_campaign = g.campaign_name
JOIN     facturering.stripe.facturen3 i ON i.customer = c.stripe_id
GROEP DOOR g.campaign_name
ORDER BY gefactureerd DESC;

De drie onderdelen zijn de verbinding, het schema en de tabel — en de verbindingsnaam is wat je er zelf aan hebt gegeven. De kolommen zijn ter illustratie; je tabellen blijven je eigen tabellen. De kosten worden in micros weergegeven, zoals de Google Ads API rapporteert, dus de verdeling is aan jou en er is niets afgerond. Alleen-lezen is van toepassing op elk onderdeel: alleen SELECT, WITH en EXPLAIN, met een maximum voor hoeveel een bron mag vrijgeven voor een enkele query. Hoe werken gefedereerde query's?

Verbindingsgegevens

Wat Google Ads nodig heeft

Authenticatie
Een Google-serviceaccountsleutel met domeinbrede delegatie, een ontwikkelaarstoken en het e-mailadres dat ermee wordt nagebootst. Dit alles wordt bewaard op de agent.
Rekening
Een klant-ID, plus een optionele beheerdersaccount-ID voor toegang tot een subaccount.
Reikte over
HTTPS van uw netwerk naar de Google Ads API. Geen inkomend verkeer.
Schema
gads — dus gads.campaign, gads.search_term_view
Tabellen
12, waarvan er zeven standaard zijn ingeschakeld: klant, campagne, advertentiegroep, zoekwoordweergave, zoektermweergave, geografische weergave, apparaatweergave
Geld
In micros, zoals de API het rapporteert — deel door een miljoen voor de valuta.
Versheid
Loopt terug naar gisteren. Elke incrementele doorloop leest de gegevens van de afgelopen drie dagen opnieuw, zodat later toegeschreven conversies correct worden verwerkt.
Geschiedenis
90 dagen bij de eerste synchronisatie. De wijzigingsgeschiedenis is door Google beperkt tot 29 dagen.
Lokale kopie
Een met AES-256-GCM versleuteld DuckDB-bestand bevindt zich naast de agent op uw computer.

Alleen-lezen is structureel. De connector voert alleen zoekopdrachten van Google uit — er is helemaal geen sprake van een mutate-aanroep — dus een zoekopdracht kan geen bod wijzigen, een campagne pauzeren of een cent uitgeven.

Bij een query over meerdere bronnen is het middelste deel van een driedelige verwijzing 'gads'. Een verbinding genaamd 'ads' die de tabel 'campaign' leest, wordt geschreven als 'ads.gads.campaign'.

Leveranciersdocumentatie: ads.google.com

Veelgestelde vragen

Vragen over Google Ads

Welke tools kunnen Google Ads-gegevens lezen via querystreams?

Alles via één verbinding: Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, geplande meldingen en rapporten. Verbind het account één keer en elk platform leest dezelfde alleen-lezen verbinding — er is geen configuratie per tool nodig en er wordt geen tweede kopie van de gegevens gemaakt.

Moet ik een firewallpoort openen voor mijn Google Ads-account?

Nee. De Query Streams Network Agent draait binnen uw netwerk en opent één versleutelde uitgaande verbinding. Er wordt niets afgeluisterd voor inkomend verkeer, een VPN is niet nodig en het account behoudt zijn bestaande firewallregels.

Kunnen querystreams gegevens in Google Ads wijzigen?

Nee. De agent zorgt ervoor dat alleen-lezen is toegestaan tijdens de uitvoering — één instructie tegelijk, alleen SELECT en soortgelijke instructies. De inloggegevens blijven op de agent en worden nooit naar Query Streams verzonden.

Wat heeft Query Streams nodig om verbinding te maken met Google Ads?

Een bereikbare host, een rol en het bijbehorende wachtwoord — de agent bevat het stuurprogramma, dus er wordt niets op het account geïnstalleerd. Authenticatie: een Google-serviceaccountsleutel met domeinbrede delegatie, een ontwikkelaarstoken en het e-mailadres dat wordt geïmpliceerd. Alles wordt door de agent bewaard. Account: een klant-ID, plus een optionele beheerdersaccount-ID voor toegang tot een subaccount. Bereikt via: HTTPS vanuit uw netwerk naar de Google Ads API. Geen inkomend verkeer. Schema: gads — dus gads.campaign, gads.search_term_view.

Kan ik Google Ads in dezelfde query koppelen aan een andere database?

Ja, dat is een gefedereerde query. Eén statement kan tegelijkertijd verwijzen naar Google Ads en uw andere verbindingen, geschreven als connection.schema.table. Elke bron voert alleen het deel uit dat het aankan en streamt het resultaat terug; de join vindt centraal plaats, waardoor de bronnen nooit met elkaar verbinding maken en er niets wordt gekopieerd of gepland. Alleen-lezen is van toepassing op elk onderdeel — alleen SELECT, WITH en EXPLAIN — en er is een limiet aan hoeveel gegevens een bron voor een enkele query mag vrijgeven. Gefedereerde queries zijn een functie van uw abonnement; op de pagina met gefedereerde queries vindt u de huidige limieten voor bronnen en groottes.

Plaats Google Ads daar waar het werk gebeurt.

Installeer de agent, koppel deze aan uw account en kies een bestemming.

Alleen-lezen Alleen uitgaand De inloggegevens blijven bij de agent.