AI agent for Apple Ads: App Store campaigns, keywords and search-term reports
Apple Ads connects with Apple's own API sign-in: a private key Agent Planners generates and keeps encrypted (or one you bring), plus the Client ID, Team ID and Key ID Apple shows you. The agent has 12 reads and 14 writes on the Apple Ads Platform API. New campaigns and ad groups are created paused; turning delivery on, budget and bid changes and deletes always wait for a person.
Connecting Apple Ads
- 1Open Integrations → the Apple Ads card → Generate a key for me. Agent Planners creates a key pair: the private key stays encrypted on our server and is never shown; copy the public key. (Already have a private key? Choose I already have a private key and paste it instead.)
- 2In Apple Ads (ads.apple.com), an account administrator opens Account Settings → User Management and invites a user with an API role — API Account Manager to make changes, API Account Read Only to only read.
- 3That API user signs in to Apple Ads, opens Account Settings → API, pastes the public key into Public Key and saves.
- 4Apple shows the Client ID, Team ID and Key ID. Paste all three on the card and press Connect — Agent Planners signs in to Apple once to check them before anything is saved.
What the agent does in Apple Ads
- Campaigns, ad groups, keywords and ads: status, budget, bid strategy, Search Match, targeting and the reasons Apple gives when something is not running.
- Reports: App Store performance by campaign, ad group, ad, keyword or search term, by day, week or month, in the ad account's own time zone. Money is in normal units (25.00), in the account's currency.
- Account health: whether the ad account can serve, and why not (no payment method, no app, ads awaiting or failing review).
- Changes: new campaigns and ad groups (always created paused), keywords and negative keywords, name and schedule edits, pausing, and other documented Apple Ads writes through one gateway.
What waits for a person
- Ordinary changes follow your approval setting — by default each waits for your approval card, and auto-approve is opt-in: a paused campaign or ad group, keywords, negative keywords, a name or schedule.
- Always a person, on every lane: turning anything on (status ENABLED lets spend start), a daily budget or bid-strategy change, an ad group's bid change, and deleting a campaign or ad group.
- Refused: money written in micros or cents, a status other than ENABLED or PAUSED, a write to another ad account, and account administration (ad accounts, budget orders, users, permissions) — those stay in Apple Ads.
What we measured with a real Apple Ads account
- Apple's current API: the agent uses the Apple Ads Platform API; Apple has announced that the older Campaign Management API v5 shuts down on 2027-01-26.
- An account needs a payment method and an app to serve. The account we connected answered INACTIVE with Apple's reason ORG_NO_PAYMENT_METHOD_ON_FILE; the agent reports that as "not serving", with Apple's own words.
- Roles come back as Apple names them — "API Campaign Manager" and "API Conversions Sender" on the account we tested — and the agent reads what each one allows.
- Write previews were checked end to end (2026-11-13): campaign, ad group, keyword and negative-keyword creates returned their exact request, and nothing was sent.
Things to ask
- "Apple Ads spend, installs and cost per install by campaign, last 30 days."
- "Which search terms spent the most without an install last week?"
- "Why is my Apple Ads account not serving?"
- "Draft a paused brand campaign for our app with exact-match keywords — show me the request first."
Frequently asked questions
- Does Agent Planners support Apple Ads?
- Yes. Apple Ads (formerly Apple Search Ads) is its own integration: connect it with a key pair, and the agent reads campaigns, keywords and App Store reports and makes paused changes for your approval.
- Where is my Apple Ads private key kept?
- On our server, encrypted. If you let Agent Planners generate it, it is never shown to anyone — you only copy the public key into Apple Ads. If you bring your own, it is stored the same way and never shown again.
- Can the agent turn a campaign on or raise a budget?
- Only with a person's approval, every time. Turning delivery on, budget and bid changes and deletes are held for a person whatever the approval setting.
- Can the agent check a change with Apple before saving it?
- No — Apple's API has no validate-only mode. The agent can show the exact request it would send, but Apple only checks a change when it is really sent.