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:
The Pipedream GA4 catalog includes (non-exhaustive):
- 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
Free users see the integration card in the Connections panel with an Upgrade prompt that links directly to the Adspirer plan picker.
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.