hermoso
Logg inn Registrer deg
MCP & CLI
APIPriser
Logg inn Registrer deg

Eksporter data fra Apple Search Ads

Apple har et rapporterings-API og ingen eksportknapp som legger tallene der du jobber. Hermoso-koblingen henter rapporten for deg og legger den i et Google-regneark, et Looker Studio-dashbord eller en JSON-fil.

Hermoso kobler til Apple Search Ads og gjør det tilgjengelig som verktøy agenten din kan kalle: Claude, ChatGPT, Cursor, Codex, Cline, CLI-en eller vanlig HTTP. apple_ads_report henter kampanje-, annonsegruppe-, annonse-, søkeord- og søketermresultater, og radene kommer tilbake som data i stedet for en CSV-fil du må bære videre selv.

Koblingen til Apple Search Ads

Apple publiserer ingen OAuth-flyt for annonse-API-et sitt, så tilkoblingen er en nøkkelutveksling og ikke en knapp: Hermoso lager signeringsnøkkelen, du limer den offentlige halvdelen inn i Apple Ads og limer tilbake tre id-er. Oppsettsguiden for Apple Search Ads går gjennom det, inkludert Public Key-feltet de fleste ikke finner. Én tilkobling betjener deretter webappen, MCP-serveren, CLI-en og REST API-et, slik at den samme eksporten fungerer fra Claude, ChatGPT eller Cursor: koble Apple Search Ads til Claude eller til ChatGPT én gang, og spør deretter.

Rapportering er bare en del av det. Den samme tilkoblingen bygger og driver kontoen: kampanjer, annonsegrupper, søkeord og negative søkeord, budsjettordrer, målretting, søkeordforslag og endringshistorikk. Siden om Apple Ads-kanalen lister alle verktøyene.

Hva rapporten inneholder

Ett kall, fem nivåer. apple_ads_report rapporterer på kampanje-, annonsegruppe-, annonse-, søkeord- eller søketerm-nivå, og hver rad har målene som Apples egen dashbord viser: visninger, trykk, installasjoner, forbruk, tap-through rate, kostnad per trykk og kostnad per installasjon. Be om totaler, eller om en serie med time-, dag-, uke- eller månedsnivå. Radene kommer sortert etter forbruk, høyest først, opptil 5 000 per side, med en totalsum-rad hvis du ber om den. Rapporter fra App Store kan også inkludere enheter uten levering, slik at et pauset søkeord vises som null i stedet for å mangle som linje.

To regler Apple håndhever, som verktøyet forklarer i stedet for å feile stille: en rapport under kampanjenivå krever en kampanje-id (bare en rapport på kampanjenivå kan dekke hele kontoen), og søketermrapporter kjører i organisasjonens egen tidssone, aldri UTC. Annonser i Apple Maps er også dekket: en rapport for business-brands kommer fra samme verktøy med én parameter endret.

Koble Apple Search Ads til Google Sheets

Dette er den ene destinasjonen Hermoso skriver til selv. Koble Google Drive ved siden av Apple Ads (én Google-autorisasjon dekker Drive, Sheets og Docs), og spør deretter: "Hent Apple Search Ads-resultatene per søkeord for de siste 30 dagene og legg dem i et nytt regneark som heter Apple Ads." Agenten kaller apple_ads_report, deretter create_sheet, og gir deg lenken. Neste uke legger den samme forespørselen med "legg til" til rader med append_to_sheet i stedet for å starte på nytt.

Hermoso ber Google om drive.file-tilgangen, som bare når filene den har laget og de du velger, aldri hele Drive-en din. Den fullstendige gjennomgangen, inkludert å erstatte en fane på plass og formatere den, står på Koble Apple Search Ads til Google Sheets.

Eksporter Apple Search Ads til Looker Studio

Hermoso har ingen innebygd Looker Studio-kobling, og vi vil heller si det enn å antyde en. Den trenger ingen: Looker Studio leser Google Sheets med sin egen innebygde kobling, så regnearket over er broen.

  1. La agenten skrive rapporten til én fane. Daglig granularitet, én rad per søkeord per dag, en overskriftsrad og en datokolonne. Be om at datokolonnen formateres som dato (format_sheet gjør det), slik at Looker Studio leser den som dato.
  2. Legg til regnearket som datakilde. I Looker Studio oppretter du en datakilde, velger Google Sheets, velger regnearket og den fanen, og lar "Use first row as headers" stå på.
  3. Bygg rapporten én gang. Forbruk per dag, kostnad per installasjon per søkeord, installasjoner per kampanje: det du ellers ville bygget på nytt i et regneark hver mandag.
  4. Fortsett å legge til. Hver uke legger agenten nye rader til i samme fane, og dashbordet henter dem ved neste datooppdatering. Behold kolonnenavnene like mellom kjøringene, fordi Looker Studio kobler felt etter overskrift.

Det samme regnearket fungerer for Power BI og Tableau, som begge har egne Google Sheets-koblinger.

Eksporter Apple Search Ads til JSON

Hvis du vil ha rårader i stedet for et regneark, finnes det tre måter å hente dem på, alle med samme kobling.

REST API-et. Hvert Hermoso-verktøy kan kalles på POST /v1/tools/{name} med en API-nøkkel du lager i appen under MCP & CLI-fanen. Forespørselskroppen er verktøyets argumenter, og svarets data-felt er det strukturerte resultatet, med radene 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.json

CLI-en. npx -y hermoso call apple_ads_report --json '{...}' --structured skriver det samme strukturerte resultatet som JSON, klart til å sendes til en fil eller pipes inn i et annet skript.

Agenten din. I en hvilken som helst chat ber du om radene som JSON, og du får dem i svaret, allerede formet slik du ba om.

For lange rapporter tar limit opptil 5 000 rader per side, og offset går til neste; resultatets hasMore forteller om det finnes en side til. Å lese en rapport bruker ikke kreditter. Den fullstendige API-referansen finnes i utviklerdokumentasjonen.

Andre destinasjoner

"Direkte" betyr at Hermoso skriver det. Alt annet er ett steg som et verktøy du allerede bruker gjør selv.

  • Google Sheets, Google Docs, Google Drive, OneDrive: direkte.
  • Looker Studio, Power BI, Tableau: gjennom regnearket, hver med sin egen Google Sheets-kobling.
  • BigQuery: gjennom regnearket, eller gjennom din egen agent. BigQuery kan spørre et Google-regneark som ekstern tabell. Hvis agenten din kjører et sted med en BigQuery-klient og prosjektlegitimasjonen din, kan den sette radene Hermoso returnerer rett inn i en tabell.
  • Excel: gjennom regnearket eller en fil. Last ned regnearket som .xlsx, eller la agenten legge en fil i Google Drive eller OneDrive.
  • PostgreSQL, Redshift, Snowflake eller et annet datalager: gjennom din egen agent eller API-et. Hermoso leverer JSON; det som har databasetilgangen din skriver den. Hermoso har ikke legitimasjon til datalagre.

Automatisere den ukentlige eksporten

Forespørselen er automatiseringen. Noe i retning av "Hver mandag henter du forrige ukes Apple Search Ads-resultater per søkeord for alle kampanjer, legger dem til i Apple Ads-regnearket, og forteller meg hvilke søkeord som flyttet seg mest på kostnad per installasjon" er en komplett jobb. Kjør den med den planleggingen klienten din allerede har (planlagte oppgaver i Claude eller ChatGPT, eller en cron-jobb som kaller Hermoso-CLI-en eller API-et), så holdes regnearket, og alle dashbord som leser det, oppdatert.

Fordi den samme tilkoblingen også redigerer kontoen, ligger rapporten og rettelsen på ett sted: agenten som ser at kostnaden per installasjon for et søkeord har doblet seg, kan pause det eller legge til et negativt søkeord i samme samtale.

Ofte stilte spørsmål

Hvordan eksporterer jeg data fra Apple Search Ads?

Koble Apple Ads til Hermoso én gang, og be deretter agenten om rapporten du vil ha, for eksempel søkeordresultater for forrige uke. Verktøyet apple_ads_report henter den fra Apples rapporterings-API, og agenten skriver den til et Google-regneark, gir deg JSON, eller begge deler.

Kan jeg koble Apple Search Ads til Google Sheets?

Ja. Koble Apple Ads og Google Drive til i Hermoso, og be deretter agenten legge rapporten i et regneark. Den lager regnearket med create_sheet, eller legger rader til i et eksisterende med append_to_sheet, og kan gjøre det hver uke.

Kan jeg eksportere Apple Search Ads til Looker Studio?

Ja, gjennom Google Sheets. Hermoso har ingen innebygd Looker Studio-kobling. Agenten skriver rapporten til et regneark, du legger det regnearket til som Google Sheets-datakilde i Looker Studio én gang, og hver tillegging vises på dashbordet ved neste oppdatering.

Hvordan eksporterer jeg Apple Search Ads-data til JSON?

Kall POST /v1/tools/apple_ads_report på Hermosos API med en API-nøkkel og les data.rows fra svaret, eller kjør hermoso call apple_ads_report --json '{...}' --structured fra CLI-en. Begge gir de samme radene som JSON.

Finnes det et rapporterings-API for Apple Search Ads?

Ja, og Hermoso er bygget på det. apple_ads_report dekker kampanje-, annonsegruppe-, annonse-, søkeord- og søketermresultater, og de andre Apple Ads-verktøyene bygger og driver kontoen.

Kan jeg hente søketermrapporter fra Apple Search Ads?

Ja. Be om søketermnivået og oppgi kampanjen. Apple leverer søketermer bare per kampanje, i organisasjonens egen tidssone.

Hvor mange rader kan én rapport gi?

Opptil 5 000 per side, sortert etter forbruk fra høyest til lavest, med et flagg som forteller agenten om det finnes flere sider. En ukentlig søkeordrapport for de fleste kontoer får plass på én side.

Dekker dette annonser i Apple Maps?

Ja. Rapporter for business-brands-kampanjer kommer fra samme verktøy, med objekttypen for promotert objekt satt til Apple Maps i stedet for App Store.

Trenger jeg en utvikler for å sette dette opp?

Nei. Koble Apple Ads til én gang i appen, og spør deretter agenten med vanlige ord: hent forrige uke per søkeord og legg det i et regneark. API-et og CLI-en finnes der hvis du vil skripte det.

Start gratis, uten kort, med alle funksjoner på alle planer.

Start gratis →   Se priser