Prerequisites
- A Google Analytics 4 property you have Viewer access to (or higher)
- Adspirer account on the Plus, Pro, or Max tier — GA4 is gated to paid plans
- Adspirer connected to a supported AI client
Connecting Google Analytics
- Open adspirer.ai/connections
- Scroll to the Integrations section and click Connect on the Google Analytics card
- A Pipedream Connect popup opens — sign in to Google and approve read access to your GA4 properties
- The popup closes and the card flips to Connected
google_analytics tool and reply with the actions it can run.
Adspirer uses Pipedream Connect to broker the OAuth grant. Your tokens stay in Pipedream and are scoped to your Adspirer user — Adspirer never sees the raw GA4 credentials.
What You Can Do
The GA4 integration is exposed through one router tool —google_analytics — that takes an action and a tool_name:
| action | What it does |
|---|---|
list_tools | Discover the GA4 actions available (the agent does this automatically before its first call) |
execute | Run a specific GA4 action with parameters |
- Pull report data — sessions, users, page views, conversions
- Break down by source, medium, campaign, landing page, device
- Real-time reporting (last 30 minutes)
- Custom dimension and metric reads
- Property and account discovery
Example Prompts
Tier Gating
| Plan | Google Analytics |
|---|---|
| Free | — |
| Plus | Included |
| Pro | Included |
| Max | Included |
Disconnecting
Open adspirer.ai/connections, find the Google Analytics card, and click Disconnect. The grant is revoked in Pipedream and the agent loses access immediately.Idle integrations (>90 days with no tool calls) are pruned automatically to keep your integration list tidy. You can always reconnect.
FAQ
Does this count against my Adspirer tool-call quota?
Does this count against my Adspirer tool-call quota?
Yes — each
google_analytics call counts as one tool call against your monthly (or annual pooled) quota, same as a Google Ads or Meta call.Can the agent modify my GA4 property?
Can the agent modify my GA4 property?
No. Adspirer’s GA4 integration is read-only — the agent can pull report data and discover properties, but it cannot edit GA4 configuration, audiences, or events.
Which GA4 properties does the agent see?
Which GA4 properties does the agent see?
Whichever properties you have access to under the Google account you used for the OAuth grant. If you have multiple GA4 properties, the agent will ask which one to query (or you can specify by property ID).
What's the relationship between this and Google Ads?
What's the relationship between this and Google Ads?
They’re separate connections. Connecting Google Ads gives the agent access to campaign data through the Google Ads API. Connecting Google Analytics gives it access to on-site behavior through the GA4 Data API. With both connected, the agent can stitch ad-side performance to site-side outcomes in a single answer.

