AdLoop

Stop switching between Google Ads, GA4, and your code editor to figure out why conversions dropped.

GitHub PyPI Privacy Policy Terms of Service

What It Does

AdLoop is an open-source MCP server that gives your AI assistant read + write access to Google Ads and GA4 — with safety guardrails that prevent accidental spend.

Analyze Performance Campaign metrics, keyword quality, search terms, audience segments, PMax breakdowns — across Ads and GA4 in one query.

Diagnose Issues Cross-reference Ads clicks against GA4 sessions. Detect GDPR consent gaps vs broken tracking. Find landing pages with traffic but no conversions.

Manage Campaigns Draft ads, create campaigns, add keywords, manage negative keyword lists, pause or enable entities — all through natural language.

Plan & Forecast Discover keyword ideas, estimate budgets, forecast clicks and cost — before committing any spend.

Verify Tracking Compare event names in your codebase against what GA4 actually receives. Find mismatches. Generate ready-to-paste gtag snippets.

Stay Safe Every mutation is previewed first. Budget caps enforced. New campaigns start paused. Broad Match + Manual CPC is blocked. Everything is logged.

How It Works

Ask your AI assistant a question in your editor. AdLoop handles the API calls, joins the data, and returns actionable results.

"My sign-up conversions dropped last week — check GA4 and Ads to find out why."

AdLoop cross-references Ads clicks, GA4 sessions, and conversion events. It checks whether the gap is from GDPR consent rejection, broken tracking, or an actual landing page problem — and tells you which one.

For write operations, every change follows a strict workflow:

Draft → Preview → Confirm

Nothing goes live without your explicit approval. The AI also runs pre-write checks — bidding strategy, conversion tracking status, quality scores — and warns you if the campaign is fundamentally broken before making changes that won't help.

Built From Real Usage

Every feature exists because of an actual problem hit while running real Google Ads campaigns.

The cross-reference tools exist because we kept manually asking the AI to "get Ads data, then get GA4 data, then compare them" — so we automated the join.
The Broad Match + Manual CPC safety rule exists because the AI once created that exact combination and wasted budget.
The GDPR consent awareness exists because the AI kept diagnosing normal EU cookie rejection as broken tracking.

Quick Start

Install and run the setup wizard:

pip install adloop && adloop init

The wizard handles OAuth, discovers your GA4 properties and Ads accounts automatically, and generates the MCP configuration for your editor. No Google Cloud project required.

Works with Cursor and Claude Code. See the full setup guide for details.