Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.adspirer.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Google Ads Integration

The most comprehensive ad platform integration. Create Search, Performance Max, Display, YouTube, and Demand Gen campaigns, research keywords with real CPC data, generate ad copy, and optimize performance with 90+ specialized tools.

​
Prerequisites

​
Connecting Google Ads

For a full walkthrough with screenshots and example prompts, see How to Connect ChatGPT to Google Ads or How to Connect Claude to Google Ads. Once you’ve set up Adspirer with your AI client, connect Google Ads:
  1. Open your AI assistant (ChatGPT, Claude, Claude Code, etc.)
  2. Say: “Connect my Google Ads account”
  3. Adspirer opens your browser for OAuth authorization
  4. Sign in to your Google account and select the ad account you want to manage
  5. Approve permissions (read campaign data, create ads, manage budgets)
Verify the connection: 
Check my connected ad platforms
You should see your Google Ads account listed with account name, customer ID, and active status.
Connect multiple Google logins to one Adspirer account. Agencies and consultants managing Google Ads across separate Google identities can attach multiple Google OAuth grants to a single Adspirer account. Each grant contributes its own non-overlapping customer IDs; the agent transparently routes tool calls to the right OAuth based on the customer you reference. Add a second login from Connections → Google Ads → Add another Google login. Available on Max annual today; rolling to other paid tiers behind a feature flag. See Multi-Account for details.

​
What You Can Do (90+ Tools)

​
Performance Analysis

  • get_campaign_performance — Pull metrics for campaigns (spend, conversions, CPA, ROAS)
  • analyze_wasted_spend — Find keywords with spend but zero conversions
  • analyze_search_terms — Review actual search queries triggering your ads. Supports raw_report mode to see the exact search terms users type into Google.
  • explain_performance_anomaly — Diagnose sudden CPA spikes or CTR drops
  • optimize_budget_allocation — Recommend budget shifts based on ROAS/CPA

​
Keyword Research

  • research_keywords — Find keywords with real CPC data from Google Keyword Planner (search volume, competition, estimated bids)

​
Ad Copy & Content

  • suggest_ad_content — Generate headlines and descriptions optimized for Google’s character limits
  • help_user_upload — Guide users through the asset upload process

​
Campaign Creation

  • discover_existing_assets — Check if account has images, headlines, and descriptions already
  • validate_and_prepare_assets — Verify assets meet Google’s requirements before campaign creation
  • create_search_campaign — Launch Google Search campaigns (text ads on search results, created PAUSED)
  • create_pmax_campaign — Launch Performance Max campaigns (ads across all Google channels, created PAUSED)

​
PMax Search Themes & Audience Signals

  • add_pmax_search_themes — Add search themes to guide PMax targeting (max 50 per asset group)
  • get_pmax_search_themes — View current search themes on a PMax campaign
  • remove_pmax_search_themes — Remove specific search themes
  • add_pmax_audience_signal — Add audience signal combining in-market, affinity, custom audiences, and user lists
  • get_pmax_audience_signals — View current audience signals
  • remove_pmax_audience_signal — Remove an audience signal
  • search_audiences — Search for audiences by keyword across all types

​
Campaign Management

  • update_campaign_budget — Change daily budget for existing campaigns
  • update_campaign — Update campaign settings: language targeting, locations, Search Partners, Display Expansion, audience targeting mode (OBSERVATION / TARGETING), AI Max
  • pause_campaign — Stop a campaign
  • resume_campaign — Restart a paused campaign
  • pause_ad_group — Pause an individual ad group within a campaign
  • resume_ad_group — Resume a paused ad group
  • add_negative_keywords — Block irrelevant search terms from triggering your ads
  • manage_ad_extensions — Add sitelinks, callouts, structured snippets
  • add_business_name_asset — Attach a business name asset to a Search campaign (max 25 characters)
  • add_call_asset — Attach a phone number call asset with optional call conversion tracking
  • add_search_campaign_image — Attach image assets to Search campaigns (logos, marketing images)
  • get_campaign_targeting — View targeting for existing campaigns: locations, languages, audiences, devices, ad schedules, topics, and content labels (all criterion types)

​
Conversion Tracking Analysis

  • list_conversion_actions — List all conversion actions in your account (purchases, form fills, phone calls, app installs) with tracking method and status
  • get_conversion_action_performance — Pull conversion volume, value, and CPA broken down by conversion action — see which actions actually drive results
Google Ads has the largest tool set in Adspirer. The tools listed above are the most commonly used. Additional tools cover ad group management, bidding strategies, geographic targeting, and more.

​
Campaign Types

​
Google Search Campaigns

Text ads that appear when people search specific keywords on Google. Best for capturing high-intent traffic — people actively looking for your product or service. When to use: Lead generation, e-commerce, local services, SaaS signups.

​
Performance Max (PMax) Campaigns

AI-powered campaigns that show ads across all Google channels: Search, Display, YouTube, Gmail, Maps, and Discover. Google’s algorithm automatically optimizes placement and creative combinations. When to use: E-commerce (especially with product feeds), broad awareness + conversions, when you have strong creative assets (images + video).

​
Display Campaigns New

Responsive Display Ads across 2M+ websites, apps, and YouTube display slots. Supports standard Display (full manual control over 5 targeting surfaces: audiences, topics, placements, keywords, demographics) and Smart Display (Google-managed with AI-driven targeting + bidding). 27 dedicated tools covering full CRUD — creation, ad groups, ads, targeting, creative edits, frequency caps, and schedules. When to use: Retargeting website visitors, brand awareness, local businesses beyond Search, visual storytelling with image + video creative. → Full Display Ads guide

​
YouTube Campaigns

Video ads on YouTube (In-Feed, In-Stream, Shorts). Uses Demand Gen format with YouTube-only channel controls. When to use: Video-first creative, product demos, brand storytelling. → Full YouTube Ads guide

​
Search Campaign Creation Workflow

Google Search campaigns follow a 5-step workflow. Skip steps and the campaign will fail validation. 
1. get_connections_status
   -> (verify Google Ads is connected)
2. research_keywords
   -> (input: business description, seed keywords, target location)
   -> (output: keyword suggestions with real CPC data)
3. discover_existing_assets
   -> (check if you have headlines/descriptions in Google Ads already)
4. suggest_ad_content (if new assets needed)
   -> (generate headlines and descriptions within Google's character limits)
5. validate_and_prepare_assets
   -> (verify everything meets Google's requirements)
6. create_search_campaign
   -> (campaign created PAUSED -- you review before launching)

​
PMax Campaign Creation Workflow

Performance Max requires creative assets plus optional search themes and audience signals for targeting: 
1. get_connections_status
   -> (verify Google Ads is connected)
2. discover_existing_assets
   -> (check for images, videos, logos in your account)
3. help_user_upload (if assets are missing)
   -> (guide you to upload to Google or provide URLs)
4. validate_and_prepare_assets
   -> (PMax requires: 5+ images, 1+ video, 5+ headlines, 5+ descriptions)
5. create_pmax_campaign
   -> (campaign created PAUSED)
6. add_pmax_search_themes
   -> (add up to 50 search themes to guide targeting)
7. search_audiences + add_pmax_audience_signal
   -> (find and add audience signals: in-market, affinity, custom, user lists)

​
PMax Asset Requirements

  • Images: Minimum 5 (1200x628px landscape + 1200x1200px square)
  • Video: Minimum 1 (under 30 seconds recommended)
  • Headlines: 5 (max 30 characters each)
  • Descriptions: 5 (max 90 characters each)
  • Logo: 1 (1200x1200px)

​
Example Prompts

​
Analyze Performance

Pull Google Ads metrics and highlight underperforming campaigns.

Open in Cursor

​
Research Keywords

Research keywords with real CPC data from Google Keyword Planner.

Open in Cursor

​
Find Wasted Spend

Identify keywords spending without converting.

Open in Cursor

​
Create a Search Campaign

End-to-end Google Search campaign with keyword research and ad copy.

Open in Cursor

​
Create a Performance Max Campaign

PMax campaign across all Google channels with asset validation.

Open in Cursor

​
Add Search Themes to PMax

Add search themes to an existing PMax campaign to guide targeting.

Open in Cursor

​
Add Audience Signals to PMax

Find and add audience signals to a PMax campaign for better targeting.

Open in Cursor

​
Optimize Budget

ROAS-based budget reallocation across campaigns.

Open in Cursor

​
Keyword Research: What You Need to Know

The research_keywords tool connects directly to Google Keyword Planner data. You get:
  • Search volume: Monthly search estimates for each keyword
  • CPC data: Average cost-per-click and estimated bid range
  • Competition level: Low, Medium, or High
  • Keyword suggestions: Related keywords you may not have considered
Keyword research is a Read tool (no cost impact), but always review the data before committing budget. High-volume keywords are not always the best choice — look for keywords with good volume AND manageable CPC relative to your target CPA.
If you’re calling Adspirer over HTTP, the research keywords API returns the same Keyword Planner data programmatically, and the benchmark context API supplies industry CPC and CTR baselines to compare those keywords against.

​
Ad Copy Guidelines

The suggest_ad_content tool generates headlines and descriptions within Google’s strict character limits:
  • Headlines: Up to 15 headlines, max 30 characters each
  • Descriptions: Up to 4 descriptions, max 90 characters each
  • Display URL paths: 2 paths, max 15 characters each
Google dynamically combines your headlines and descriptions. Provide diverse options so Google’s algorithm can find high-performing combinations.

​
Budget Guidelines

  • Minimum: $10/day per campaign (Google’s practical minimum for Search)
  • Recommended: $30+/day for meaningful data collection
  • Testing: Start with $40/day split across 3-5 ad groups to test different keyword themes
  • Scaling: Once you find keywords with CPA below target, increase budget 20-30% every 5-7 days
  • PMax minimum: $20+/day recommended (PMax needs budget to test across multiple channels)

​
Best Use Cases for Google Ads

  • Demand capture: Reach people actively searching for your product or service (highest intent of any platform)
  • Local services: Plumbers, dentists, lawyers, restaurants — people searching “near me”
  • E-commerce: Product searches, comparison shopping, brand searches
  • SaaS & B2B: High-intent keywords like “CRM software” or “marketing automation tool”
  • Lead generation: Contact forms, phone calls, demo requests from search traffic
Not ideal for: Brand awareness (use Meta Ads or TikTok Ads instead), visual/video-first products, targeting by job title (use LinkedIn Ads).

​
Troubleshooting

​
”Ad account not connected” error

Re-authenticate your Google Ads account: 
Connect my Google Ads account
Make sure you select the correct Google account and ad account during OAuth. If you manage multiple accounts (MCC), you may need to specify which sub-account to use.

​
”Asset validation failed” error

Common causes:
  • Headlines exceed 30 characters or descriptions exceed 90 characters
  • Fewer than 5 images for PMax campaigns
  • Image dimensions do not meet minimum requirements
  • Missing required asset types (PMax needs images, headlines, descriptions, and at least one logo)
Run validation separately to diagnose: 
Validate my Google Ads assets for a Search campaign

​
“Campaign creation failed” error

Most common reason: skipping workflow steps. Google campaigns require keyword research and asset validation before creation. If you jump straight to create_search_campaign without running research_keywords and validate_and_prepare_assets first, it will fail. If you’re using agent skills, the AI enforces the correct workflow automatically.

​
”Keyword research returned no results”

This usually means your seed keywords or business description is too narrow. Try:
  • Broader seed keywords (e.g., “plumber” instead of “emergency residential copper pipe repair”)
  • Different location targeting (e.g., expand from city to state)
  • More descriptive business description so the tool can suggest related terms

​
High CPA with no conversions

Common issue with new campaigns. Troubleshoot:
  • Review search terms with analyze_search_terms — are irrelevant queries consuming budget?
  • Add negative keywords with add_negative_keywords to block wasteful clicks
  • Check landing page quality — Google Ads can drive clicks but conversions depend on your website
  • Use analyze_wasted_spend to identify keywords spending without converting

​
FAQ

Search campaigns show text ads on Google Search results when people search specific keywords. You control which keywords trigger your ads. Best for high-intent traffic.Performance Max campaigns use Google’s AI to show ads across all Google channels (Search, Display, YouTube, Gmail, Maps, Discover). You provide creative assets and a conversion goal, and Google optimizes everything automatically. Best when you have strong creative assets and want broad reach with automated optimization.
Use Display when you want precise control — specific audiences, specific websites, specific keywords — or for retargeting website visitors. Display runs on the Display Network only (2M+ sites and apps).Use Performance Max when you want Google’s AI to optimize across every channel (Search, Display, YouTube, Gmail, Maps, Discover) with minimal manual targeting. PMax is broader but less controllable.Run Display for retargeting and specific placements; run PMax for broad automated reach.
No. Adspirer generates ad copy (headlines and descriptions) through the suggest_ad_content tool, but it does not create images or videos. For PMax campaigns, you provide image/video URLs from Google Drive, Dropbox, S3, or any public URL. The validate_and_prepare_assets tool ensures your assets meet Google’s specifications.
Yes. Adspirer supports multi-platform management. You can pull Google Ads performance, then switch to Meta Ads analysis in the same conversation. Use get_connections_status to see all connected platforms.
Google Ads: Best for demand capture (reaching people actively searching for solutions). Keyword-based targeting. Higher intent but more expensive clicks.Meta Ads: Best for demand generation (reaching people who don’t know you exist) and visual products. Interest-based targeting. Lower intent but cheaper clicks.Most advertisers run both: Google for high-intent searches, Meta for awareness and retargeting.
Search themes are short phrases (max 50 per asset group) that tell Google which search queries your Performance Max campaign should target. They supplement Google’s automated targeting.Audience signals tell Google which audience segments are most likely to convert — in-market audiences, affinity audiences, custom audiences, and user lists (remarketing). They are signals, not hard targeting — Google uses them as starting points and expands from there. Only one audience signal is allowed per asset group.Both are PMax-only features and do not apply to Search, Display, or other campaign types.
Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: 49/mofor150calls.Pro:49/mo for 150 calls. Pro: 99/mo for 600 calls. Max: $199/mo for 3,000 calls. A typical Google Search campaign creation uses 5-6 tool calls. Keyword research alone is 1 call. See full pricing.
Yes. Adspirer uses OAuth 2.1 authentication — your Google Ads credentials are never stored on Adspirer’s servers. All connections are HTTPS-encrypted with least-privilege access scopes. You can revoke access at any time from your Google account settings.
Last modified on May 27, 2026