Google Ads

Google Ads · Live

Ask Google Ads where the budget is leaking.

Read Google Ads campaigns, ad groups, keywords, and performance metrics so the agent can audit budgets, surface drop-offs, and reconcile spend with conversions.

Connect Google AdsHow it worksLive
Auth
OAuth
Access
Read-only by default
Plan
Every plan
Freshness
Live — every call hits the Google Ads API
Available on
Every plan

Examples

Questions teams actually ask.

The tools it pulls from are shown inline — every answer in Lumen cites the underlying records it read.

Performance

Top 20 keywords by spend last 30 days that produced zero conversions.

pullsrunQuerygetKeywordView
Pacing

Campaigns that are pacing more than 25% above or below daily budget this week.

pullslistCampaignsrunQuery
Performance Max

Asset-group performance for our PMax campaigns: which asset groups are driving conversions?

pullslistAssetGroupsrunQuery

Scope

What Lumen sees. What it can change.

Read is on by default. Every write is a separate toggle, capped per user, and logged.

Read

What Lumen reads

Lumen calls the Google Ads API using the Google OAuth token you grant at install, scoped to the customer accounts you select. Read scope only by default.

  • Customer accounts

    List of MCC and child accounts you've selected, currency, timezone

  • Campaigns & ad groups

    Definition, status, budget, bid strategy, schedule, network settings

  • Keywords & search terms

    Match type, status, quality score, search-term reports

  • Ads & assets

    Responsive search assets, image / video assets, asset performance labels

  • Reports (GAQL)

    Run any read-only Google Ads Query Language query — impressions, clicks, conversions, costs, ROAS

Write · opt-in

What Lumen can write

Lumen does not write to Google Ads by default. Pause/unpause and budget changes can be admin-enabled per customer account if you want the agent to act on its findings.

    Every call is logged with user, operation, customer ID, GAQL query (when used), and date range. Exportable as CSV.

    Install

    Connect in under a minute.

    No keys, no call, no app marketplace fine print.

    1. Authorize
      01

      Connect with Google OAuth

      In Settings → Integrations → Google Ads, click Connect. Sign in and approve the AdWords scope. The token is stored encrypted.

    2. Pick accounts
      02

      Choose which customer accounts

      If your login covers an MCC, Lumen will list every child account — pick only the ones the agent should query.

    3. Ask
      03

      Try a warm-up question

      Start with "Spend vs. conversions by campaign last 7 days" — the agent will run the right GAQL query and rank the results.

    Connect Google Ads. Audit spend honestly.

    Google OAuth. Read-only by default. Pause/budget writes opt-in.

    Connect Google AdsBack to all integrations