Hermoso kopplar till Apple Search Ads och exponerar det som verktyg som din agent kan anropa: Claude, ChatGPT, Cursor, Codex, Cline, CLI:t eller vanlig HTTP. apple_ads_report hämtar prestanda för kampanj, annonsgrupp, annons, sökord och sökterm, och raderna kommer tillbaka som data i stället för en CSV-fil som du sedan måste bära vidare någonstans.
Anslutningen till Apple Search Ads
Apple publicerar inget OAuth-flöde för sitt annons-API, så anslutningen är ett nyckelbyte snarare än en knapp: Hermoso skapar signeringsnyckeln, du klistrar in dess publika halva i Apple Ads och klistrar tillbaka tre id:n. Installationsguiden för Apple Search Ads går igenom det, inklusive fältet Public Key som de flesta inte hittar. En enda anslutning betjänar sedan webbappen, MCP-servern, CLI:t och REST API:t, så samma export fungerar från Claude, ChatGPT eller Cursor: anslut Apple Search Ads till Claude eller till ChatGPT en gång, och fråga sedan.
Rapportering är bara en del. Samma anslutning bygger och driver även kontot: kampanjer, annonsgrupper, sökord och negativa sökord, budgetorder, inriktning, sökordsförslag och ändringshistorik. Sidan för Apple Ads-kanalen listar alla verktyg.
Vad rapporten innehåller
Ett anrop, fem nivåer. apple_ads_report rapporterar på kampanj-, annonsgrupps-, annons-, sökords- eller sökterm-nivå, och varje rad bär de mått som Apples egen instrumentpanel visar: visningar, tryck, installationer, utgifter, tap-through rate, kostnad per tryck och kostnad per förvärv. Begär totalsummor, eller en serie med timme, dag, vecka eller månad som upplösning. Rader kommer tillbaka sorterade efter utgifter, högst först, upp till 5 000 per sida, med en totalrad om du begär det. Rapporter för App Store kan även ta med objekt utan leverans, så ett pausat sökord visas som noll i stället för att försvinna.
Två regler som Apple tillämpar, och som verktyget förklarar i stället för att misslyckas tyst: en rapport under kampanjnivå kräver ett kampanj-id (bara en rapport på kampanjnivå kan täcka hela kontot), och sökterm-rapporter körs i din organisations egna tidszon, aldrig UTC. Annonser på Apple Maps omfattas också: en rapport för business-brands kommer från samma verktyg med en parameter ändrad.
Anslut Apple Search Ads till Google Sheets
Det här är det enda mål som Hermoso skriver till själv. Anslut Google Drive vid sidan av Apple Ads (en Google-auktorisering täcker Drive, Sheets och Docs) och be sedan: "Hämta Apple Search Ads-resultat per sökord för de senaste 30 dagarna och lägg dem i ett nytt kalkylark som heter Apple Ads." Agenten anropar apple_ads_report, sedan create_sheet, och ger tillbaka länken. Nästa vecka lägger samma begäran med "append" till rader med append_to_sheet i stället för att börja om.
Drive-omfånget som Hermoso begär är drive.file, som når filer som det skapat och de du väljer, aldrig hela din Drive. Hela genomgången, inklusive hur du ersätter en flik på plats och formaterar den, finns på Anslut Apple Search Ads till Google Sheets.
Exportera Apple Search Ads till Looker Studio
Hermoso har ingen inbyggd Looker Studio-koppling, och vi säger hellre det än antyder något annat. Den behöver ingen: Looker Studio läser Google Sheets med sin egen inbyggda koppling, så kalkylarket ovan är bron.
- Låt agenten skriva rapporten till en flik. Daglig upplösning, en rad per sökord per dag, en rubrikrad och en datumkolumn. Begär att datumkolumnen formateras som datum (
format_sheetgör det), så att Looker Studio läser den som ett datum. - Lägg till kalkylarket som datakälla. I Looker Studio skapar du en datakälla, väljer Google Sheets, väljer kalkylarket och den fliken, och låter "Use first row as headers" vara på.
- Bygg rapporten en gång. Utgifter per dag, kostnad per förvärv per sökord, installationer per kampanj: allt du annars skulle bygga om i ett kalkylark varje måndag.
- Fortsätt lägga till. Varje vecka lägger agenten till nya rader i samma flik, och instrumentpanelen plockar upp dem vid nästa datauppdatering. Behåll kolumnnamnen desamma mellan körningarna, eftersom Looker Studio kopplar fälten via rubrikerna.
Samma kalkylark fungerar för Power BI och Tableau, som båda har egna kopplingar till Google Sheets.
Exportera Apple Search Ads till JSON
Om du vill ha de råa raderna i stället för ett kalkylark finns tre sätt att få dem, alla med samma anslutning.
REST API:t. Varje Hermoso-verktyg kan anropas på POST /v1/tools/{name} med en API-nyckel som du skapar i appen under fliken MCP & CLI. Förfrågningskroppen är verktygets argument, och svarets fält data är det strukturerade resultatet, med raderna i data.rows:
curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
-H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
-d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
| jq '.data.rows' > apple-search-ads.jsonCLI:t. npx -y hermoso call apple_ads_report --json '{...}' --structured skriver ut samma strukturerade resultat som JSON, redo att skickas till en fil eller pipas till ett annat skript.
Din agent. I valfri chatt ber du om raderna som JSON, och du får dem i svaret, redan formade efter det du bad om.
För långa rapporter tar limit upp till 5 000 rader per sida och offset går vidare till nästa; resultatets hasMore talar om om fler sidor finns. Att läsa en rapport förbrukar inga credits. Hela API-referensen finns i utvecklardokumentationen.
Andra mål
"Direkt" betyder att Hermoso skriver det. Allt annat är ett steg som ett verktyg du redan använder gör själv.
- Google Sheets, Google Docs, Google Drive, OneDrive: direkt.
- Looker Studio, Power BI, Tableau: via kalkylarket, var och en med sin egen Google Sheets-koppling.
- BigQuery: via kalkylarket, eller via din egen agent. BigQuery kan fråga ett Google Sheets-kalkylark som en extern tabell. Om din agent körs någonstans med en BigQuery-klient och dina projektuppgifter kan den infoga raderna som Hermoso returnerar direkt i en tabell.
- Excel: via kalkylarket eller en fil. Ladda ner kalkylarket som .xlsx, eller låt agenten lämna en fil i Google Drive eller OneDrive.
- PostgreSQL, Redshift, Snowflake eller något annat datalager: via din egen agent eller API:t. Hermoso returnerar JSON; det som har dina databasuppgifter skriver den. Hermoso har inga datalageruppgifter.
Automatisera den veckovisa exporten
Prompten är automationen. Något i stil med "Varje måndag, hämta förra veckans Apple Search Ads-resultat per sökord för alla kampanjer, lägg till dem i Apple Ads-kalkylarket och berätta vilka sökord som rört sig mest i kostnad per förvärv" är ett komplett jobb. Kör det enligt det schema som din klient redan har (schemalagda uppgifter i Claude eller ChatGPT, eller ett cron-jobb som anropar Hermoso CLI eller API) så hålls kalkylarket, och varje instrumentpanel som läser det, aktuellt.
Eftersom samma anslutning också redigerar kontot ligger rapporten och åtgärden på ett och samma ställe: agenten som ser att ett sökords kostnad per förvärv har fördubblats kan pausa det eller lägga till ett negativt sökord i samma konversation.
Vanliga frågor
Hur exporterar jag data från Apple Search Ads?
Anslut Apple Ads till Hermoso en gång, be sedan din agent om den rapport du vill ha, till exempel sökordsresultat för förra veckan. Verktyget apple_ads_report hämtar den från Apples rapporterings-API och agenten skriver den till ett Google Sheets-kalkylark, ger dig JSON eller båda.
Kan jag ansluta Apple Search Ads till Google Sheets?
Ja. Anslut Apple Ads och Google Drive i Hermoso, be sedan agenten lägga rapporten i ett kalkylark. Den skapar kalkylarket med create_sheet, eller lägger till rader i ett befintligt med append_to_sheet, och kan upprepa det varje vecka.
Kan jag exportera Apple Search Ads till Looker Studio?
Ja, via Google Sheets. Hermoso har ingen inbyggd Looker Studio-koppling. Agenten skriver rapporten till ett kalkylark, du lägger till det kalkylarket som en Google Sheets-datakälla i Looker Studio en gång, och varje tillägg syns vid instrumentpanelens nästa uppdatering.
Hur exporterar jag Apple Search Ads-data till JSON?
Anropa POST /v1/tools/apple_ads_report på Hermoso API med en API-nyckel och läs data.rows i svaret, eller kör hermoso call apple_ads_report --json '{...}' --structured från CLI:t. Båda ger samma rader som JSON.
Finns det ett rapporterings-API för Apple Search Ads?
Ja, och Hermoso är byggt på det. apple_ads_report omfattar kampanj-, annonsgrupps-, annons-, sökords- och sökterm-prestanda, och de andra Apple Ads-verktygen bygger och hanterar kontot.
Kan jag få sökterm-rapporter från Apple Search Ads?
Ja. Begär sökterm-nivån och ange kampanjen. Apple levererar sökterm bara per kampanj, i organisationens egen tidszon.
Hur många rader kan en rapport innehålla?
Upp till 5 000 per sida, sorterade efter utgifter från högst till lägst, med en flagga som talar om för agenten om fler sidor finns. En veckovis sökordsrapport för de flesta konton ryms på en sida.
Täcker detta annonser på Apple Maps?
Ja. Rapporter för business-brands-kampanjer kommer från samma verktyg, med objekttypen för det marknadsförda objektet satt till Apple Maps i stället för App Store.
Behöver jag en utvecklare för att ställa in det här?
Nej. Anslut Apple Ads en gång i appen och be sedan din agent med vanliga ord: hämta förra veckan per sökord och lägg den i ett kalkylark. API:t och CLI:t finns där om du vill skripta det.