Create Campaign
create_campaignCreate ad campaigns with defined budgets, bidding objectives, targeting, and schedules. Choose impressions, clicks, or conversions bidding, and set lifetime spend limits to control costs.
Instructions
Create an ad campaign. Note: lifetime_spend_limit_micros is in currency millionths (e.g. 25000000 = $25.00 USD). Bidding type cannot be changed after creation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"status": "<status>",
"lifetime_spend_limit_micros": "<lifetime_spend_limit_micros>"
},
"name": "create_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Campaign name (3-1000 chars) | |
| status | Yes | Initial status. 'paused' is recommended while creating child resources. | |
| end_time | No | Unix timestamp in seconds for campaign end | |
| start_time | No | Unix timestamp in seconds for campaign start | |
| description | No | Campaign description | |
| bidding_type | No | Bidding objective. Defaults to 'impressions'. For oCPC, use 'conversions'. | |
| location_ids | No | List of target location IDs (regions/DMAs from search_geo_locations) | |
| idempotency_key | No | Optional unique idempotency key for safe retries | |
| lifetime_spend_limit_micros | Yes | Lifetime budget limit in micros (min 1,000,000 = $1.00 USD) | |
| conversion_event_setting_ids | No | Required for 'conversions' bidding: exactly one active standard event setting ID. |