Apple Ads tools
Apple Search Ads organizations and campaigns, delivery report (impressions, taps, installs, spend), daily budget and status changes.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools4 tools
list_apple_ads_accounts
Leitura1 creditsConnected Apple Search Ads organizations: org_id, name, currency. Read only; connected=false when none.
This tool takes no parameters.
list_apple_ads_campaigns
Leitura1 creditsApple Search Ads campaigns: id, name, status, daily budget, App Store adamId, countries. Read only.
| Parameter | Type | Description |
|---|---|---|
org_idOptional | string | Apple Search Ads organization id; required only when several orgs are connected |
apple_ads_performance_report
Leitura2 creditsApple Search Ads delivery report: impressions, taps, installs, spend per campaign. Read only; never invents numbers.
| Parameter | Type | Description |
|---|---|---|
org_idOptional | string | Apple Search Ads organization id; required only when several orgs are connected |
daysOptional | integer (1–90) | — |
start_dateOptional | string | — |
end_dateOptional | string | — |
diagnose_apple_ads_delivery
Leitura2 creditsWhy an Apple Ads (Search Ads) campaign isn't running, or is on hold, paused or rejected: call it first when the user reports such a problem. Live read of the campaign (serving status and Apple's serving state reasons, also per country, daily budget, bidding strategy, target CPA), its ad groups (reasons, default bid, CPA goal) and ads (reasons incl. approval pending / rejected), product page rejection reasons and Apple's keyword bid suggestions; returned with a findings list (scope, Apple's code, category, evidence) and cannot_read for what the API doesn't expose. Read only.
| Parameter | Type | Description |
|---|---|---|
org_idOptional | string | Apple Search Ads organization id; required only when several orgs are connected |
campaign_idRequired | string | Apple Ads campaign id (list_apple_ads_campaigns) |
Write tools2 tools
update_apple_ads_campaign_status
Escrita2 creditsPause or activate an Apple Search Ads campaign. Applied when the user asks; undoable.
| Parameter | Type | Description |
|---|---|---|
org_idOptional | string | Apple Search Ads organization id; required only when several orgs are connected |
campaign_idRequired | string | — |
statusRequired | pause | activate | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_apple_ads_campaign_budget
Escrita2 creditsSet an Apple Search Ads campaign daily budget. Increases above 50% per change are blocked.
| Parameter | Type | Description |
|---|---|---|
org_idOptional | string | Apple Search Ads organization id; required only when several orgs are connected |
campaign_idRequired | string | — |
daily_budgetRequired | number | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.