Home / Features / AI campaign planner
Feature 01 · Planner

Apple Search Ads AI Campaign Planner

The SearchAd AI campaign planner is a chat interface to your Apple Search Ads account. You describe what you want in plain English. It returns a structured draft you can read, edit, and approve. The Apple API never hears from the model until you say so.

Plan draft awaiting approval
PROMPT
Launch Pomelo Notes in the 11 premium tier countries, $20/day each, paused.
DRAFTED CAMPAIGNS
United States · Exact + Competitors$20.00/d · CPT $4.20
United Kingdom · Exact + Competitors$20.00/d · CPT £2.40
Germany · Exact + Competitors$20.00/d · CPT €2.10
Japan · Exact + Competitors$20.00/d · CPT ¥220
8 more countries
Search Match OFF · MANUAL_CPT
The problem

Setting up Apple Search Ads is mostly typing.

Walk through what it actually takes to launch a single new market inside Apple's own UI. Create a campaign group. Pick the country. Set the budget. Set the daily cap. Toggle Search Match off. Switch to MANUAL_CPT. Create two ad groups so brand and competitor data stay separate. Set the default bid for each. Paste in your keyword list. Paste in your competitor list. Set negative keywords. Repeat for the next country, where every line above has a different correct answer.

The campaign planner removes that surface area. You tell it what you want; it returns a single draft you can read in under a minute. The structure is locked to the default architecture (per-country campaigns, Exact and Competitors ad groups, EXACT match, Search Match off, MANUAL_CPT) so the plan stays predictable across every market.

How the planner thinks

Three reads, one write.

Before the model proposes a plan, it queries your Apple account through a small set of read-only tools. The reads stay inside Cloud Functions. The write goes nowhere until you approve.

READ 1
list_my_apps

Fetches the apps Apple already knows about, including their adamId. The model never asks you to look up an adamId. It already has it.

READ 2
list_eligible_countries

Returns the countries that app is approved to advertise in. If you ask to launch in 90, the planner only proposes the ones Apple will actually accept.

READ 3
list_existing_campaigns

Inspects what is already running so the planner does not propose a duplicate. If you have Germany live, it will suggest editing rather than recreating.

WRITE
propose_campaign_plan

Writes a draft into users/{uid}/plans/{planId} in your private workspace. Apple has not been touched. The system prompt requires this step before any deploy, and the deploy function refuses to run on a plan that was not first proposed and approved.

Real prompts

Sentences that actually work.

These are not curated demos. They are the kinds of one-liners customers send the planner before lunch.

Set up everything for our new fitness app, English-speaking countries only.
Expand into the B-tier countries but cap total at $400 per day.
What countries should I start with for a Turkish meditation app?
Pomelo Notes, premium tier only, $15 a day each, paused.
Draft a competitor-only campaign in the US bidding on Bear and Obsidian.
What lands in your workspace

Every draft is one document you can re-read tomorrow.

Per-country bid ceiling

Each campaign carries an opening MANUAL_CPT bid drawn from purchasing-power tiers calibrated on an 88-campaign deploy. You can override before approving.

Two ad groups, every time

Exact for your generic keywords, Competitors for rival brand names. Different default bids; different pause buttons. You never have to disentangle them later.

Localized keyword list

Keywords are drafted in the campaign's locale, not pasted in from English. Turkish gets Turkish; Brazilian Portuguese gets Brazilian Portuguese.

An audit trail you keep

Approved or declined, the draft stays in your account. Disconnecting your Apple credentials does not erase the history of what was proposed.

Planner FAQ

Questions worth answering before you sign up.

What does the AI need to draft a campaign? +

One or two sentences about your app, and which countries or tiers you care about. The planner pulls everything else (app name, adamId, eligible locales, existing campaigns) from your connected Apple Search Ads account. You never have to look up an adamId.

Does the AI deploy anything automatically? +

No. The planner writes a draft into your private workspace and stops. Nothing reaches Apple's write endpoints until you tap Approve on a specific plan, and deploys land paused unless you explicitly type "go live".

Can I edit the draft before approving? +

Yes. Ask the AI to lower a bid, drop a country, add a keyword, raise a budget, or swap the split. Each change rewrites the draft in place. What you approve is what you read.

Which model powers the planner? +

Claude Opus, called through the kie.ai API. The model runs against a curated tool surface that is read-only against Apple by default. The deploy tool is wired to your tap on the Approve button, never to the model directly.

What stops the model from picking a bad bid? +

Default bids are not invented by the model. They come from a purchasing-power table calibrated against a real 88-campaign rollout, sitting beside the planner in the codebase. The model is allowed to propose overrides; you read them before approving.

Related features

Pieces that snap onto this one.

Stop typing campaigns. Start reading them.

The free trial includes the full planner. No campaign deploys without your explicit approval.