apple-search-ads-skill
von trebuhs
Apple Apps & ServicesKurzbeschreibung
Manage Apple Search Ads campaigns, ad groups, keywords, and reports via the asa-cli tool.
Beschreibung
Was dieser Skill macht
Manage Apple Search Ads campaigns, ad groups, keywords, and reports through the asa-cli command-line tool. Covers the full Campaign Management API v5, including keyword bidding, negative keywords, and performance reports broken down by date, country, and device.
Handles Apple Search Ads API v5 authentication and pagination automatically, so you can manage campaigns without writing custom HTTP code.
Wann du ihn einsetzt
- Pull last month's install and CPI report by country for a live campaign
- Add negative keywords to an ad group to block irrelevant search terms
- Adjust keyword bids across multiple ad groups before a seasonal push
- Create a new campaign targeting specific countries for an app launch
- Compare search term performance to find high-converting queries
Beispiel-Workflow
User asks: Get keyword performance for campaign 123456 for the past 30 days
- 1
Run asa-cli whoami -o json to confirm the org ID
- 2
Run asa-cli reports keywords --campaign-id 123456 --start-date 2026-02-17 --end-date 2026-03-19 -o json
- 3
Pipe the output through jq to extract keyword text, totalInstalls, tapInstallCPI, and totalInstallRate
- 4
Sort results by tapInstallCPI to surface the most and least efficient keywords
A ranked list of keywords with install counts, tap-through install rate, and cost per install for the 30-day window
Voraussetzungen
- Apple Search Ads account
- Apple Search Ads API credentials: client ID, team ID, key ID, and private key file (generated in the ASA console)
- asa-cli installed
Installation
clawhub install trebuhs/apple-search-ads-skillFühre den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.