Select Google Campaign Type

USE THIS TOOL FIRST WHEN: User wants to create a Google Ads campaign but hasn’t specified the campaign type (Search, Performance Max, or YouTube).

IMPORTANT: This tool should be called BEFORE any keyword research, asset discovery, or campaign creation when the user says things like:

“Create a Google Ads campaign”
“I want to run Google Ads”
“Set up a Google advertising campaign”
“Help me create ads on Google”
“I want to advertise on Google”
“Create a campaign”
“Run ads”

This tool guides the user to select their campaign TYPE, then provides a detailed workflow for that specific type.

Campaign Types Available:

search - Text ads in Google Search results (best for high-intent keywords, lead gen, local services)
pmax - Performance Max across all Google channels (best for ecommerce, brand awareness, multi-channel reach)
youtube - Video ads on YouTube (best for video content, brand storytelling, product demos)

Returns:

What the campaign type is best for
Step-by-step workflow with which tools to call
Requirements (character limits, assets needed, etc.)
Natural follow-up question to start the creation flow

Do NOT use this tool if:

User specifically asks for “search campaign” or “text ads” → go directly to research_keywords then create_search_campaign
User specifically asks for “PMax” or “Performance Max” → go directly to discover_existing_assets then create_pmax_campaign
User specifically asks for “YouTube campaign” or “video campaign” → go directly to validate_video then create_youtube_campaign
User is asking about performance/analytics → use get_campaign_performance
User is asking about existing campaigns → use list_campaigns

Parameters:

campaign_type: ‘search’, ‘pmax’, or ‘youtube’

Execution time: Instant (no API call)

POST

/

api

/

v1

/

tools

/

select_google_campaign_type

/

execute

Select Google Campaign Type

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/select_google_campaign_type/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_type": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for select_google_campaign_type)"
  },
  "success": true,
  "tool": "select_google_campaign_type"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for selecting Google Ads campaign type

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Suggest Ad ContentGenerate AI-suggested headlines and descriptions based on campaign keywords. Analyzes campaign keywords and generates optimized ad content following creative guidelines: - 15 headlines across 3 categories (What It Is, Benefits, Pain/Proof/CTA) - 4 descriptions with value props and CTAs - All validated for character limits **Parameters:** - campaign_id: The campaign to analyze (REQUIRED) - business_description: Optional context about the business - key_benefits: Optional list of benefits (e.g., ["fast setup", "no dashboard"]) - proof_points: Optional proof points (e.g., [`{"number": "2000+", "metric": "campaigns"}`]) - pain_points: Optional pain points (e.g., ["manual ads", "complex UI"]) - customer_id: Optional **Returns:** - suggested_headlines: 15 headlines ready to use - suggested_descriptions: 4 descriptions ready to use - headline_categories: Headlines organized by category - keyword_themes: Top themes from campaign keywords **Use this when:** - User wants fresh ad copy ideas - User asks "what should my headlines be?" - Starting a new A/B test - Refreshing stale ad content **Execution time:** 3-5 seconds **Example:** User: "Suggest some better headlines for my campaign" Agent: 1. Uses suggest_ad_content to generate ideas 2. Shows suggestions organized by category 3. User picks favorites 4. Uses update_ad_headlines to apply selected headlines

Select Google Campaign Type

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/select_google_campaign_type/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_type": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for select_google_campaign_type)"
  },
  "success": true,
  "tool": "select_google_campaign_type"
}