Apple Search Ads Agent
The Apple Search Ads Agent provides intelligent monitoring, reporting, and optimization for your Apple Search Ads campaigns. It starts with read-only analytics and progressively enables write operations as the feature matures.
Feature flag: apple-search-ads
Current capabilities (Phase 1: Read-only intelligence)
Dashboard & reporting
- Campaign health monitoring — aggregated view of spend, installs, CPI, TTR, and conversion rates across all campaigns
- Search term mining — discover what search terms are triggering your ads and identify new keyword opportunities
- Keyword performance — track which keywords drive installs vs. which burn budget
- Negative keyword detection — identify wasted spend on irrelevant search terms
- Time-range analysis — compare performance across custom date ranges (default: 30 days)
Metrics tracked
| Metric | Description |
|---|---|
| Total spend | Campaign spend in your account currency (USD, EUR, etc.) |
| Impressions | How many times your ads were shown |
| Taps | How many users clicked your ad |
| Installs | Conversions (app downloads) attributed to ads |
| CPI | Cost per install (spend ÷ installs) |
| TTR | Tap-through rate (taps ÷ impressions × 100) |
| Conversion rate | Install rate after tap (installs ÷ taps × 100) |
Campaign-level breakdown
Every campaign shows:
- Campaign name and status (ENABLED, PAUSED)
- Individual spend, impressions, taps, installs
- Per-campaign CPI and TTR
- Sorted by spend (highest first)
Upcoming capabilities
Phase 2: Write operations (in development)
- Pause/enable campaigns — stop underperforming campaigns or restart winners
- Bid adjustments — update keyword bids based on performance data
- Budget modifications — reallocate daily budgets across campaigns
- Keyword management — add new keywords, adjust match types (EXACT/BROAD)
- Negative keyword automation — automatically add negative keywords to prevent wasted spend
Phase 3: Smart automation (planned)
- Auto-bidding — AI-driven bid optimization based on target CPI or ROAS
- Wasted spend detection — proactive alerts when campaigns deviate from normal performance
- Budget reallocation — automatically shift budget from underperforming to high-ROI campaigns
- Search term discovery — mine search term reports and suggest new keywords
- Anomaly alerts — notifications when CPI spikes, installs drop, or spend anomalies occur
How to set it up
- Navigate to Settings → Integrations → Apple Search Ads in Fload
- Connect your Apple Search Ads account via OAuth
- Grant the required permissions (reporting access for Phase 1, campaign management for Phase 2)
- Once connected, the agent syncs your campaigns and begins tracking metrics
- Access reports at Apple Search Ads → Dashboard
API endpoints (Phase 1)
| Endpoint | Method | What it does |
|---|---|---|
/dashboard | GET | Aggregated metrics across all campaigns |
/campaigns | GET | List all campaigns with metadata |
/campaigns/:id/report | GET | Detailed performance data for one campaign |
/keywords | GET | Keyword-level performance across campaigns |
/search-terms | GET | Search term report (what users searched) |
Query params: startDate and endDate (ISO format: YYYY-MM-DD). Defaults to last 30 days.
Phase 2 endpoints (coming soon)
| Endpoint | Method | What it does |
|---|---|---|
/campaigns/:id/pause | POST | Pause a campaign |
/campaigns/:id/enable | POST | Enable a paused campaign |
/campaigns/:id/budget | PUT | Update daily budget |
/keywords/:campaignId/:adGroupId | POST | Create a new keyword |
/keywords/:campaignId/:adGroupId/:keywordId/bid | PUT | Update keyword bid |
/negative-keywords/:campaignId | POST | Add a negative keyword |
/negative-keywords/:campaignId/:keywordId | DELETE | Remove a negative keyword |
Limitations
- Apple Search Ads only — this agent does not support Google Ads, Meta, or TikTok (yet)
- Read-only in Phase 1 — no write operations until Phase 2 ships
- Organization-level access — all users in your Fload org can view ASA data (role-based restrictions coming)
- Data freshness — reports reflect data as of the last API sync (typically hourly)
Use cases
For marketers
- Spot underperforming campaigns draining budget
- Identify new keyword opportunities from search terms
- Track CPI trends over time to optimize bidding strategy
For founders
- Get a unified view of ad spend vs. installs without logging into Apple Search Ads
- Monitor campaign health alongside other growth metrics in Fload
For agencies
- Manage multiple clients' ASA campaigns from one dashboard
- Generate performance reports without manual exports
Want early access to Phase 2?
Phase 2 (write operations) is currently in development. Book a demo to get early access when it launches.