hermoso
Log ind Kom i gang
MCP & CLI
APIPriser
Log ind Kom i gang

Eksportér data fra Apple Search Ads

Apple har et rapporterings-API og ingen eksportknap, der lægger tallene ddér, hvor du arbejder. Hermoso-connectoren henter rapporten for dig og lægger den i et Google Sheet, et Looker Studio-dashboard eller en JSON-fil.

Hermoso forbinder til Apple Search Ads og eksponerer det som værktøjer, din agent kan kalde: Claude, ChatGPT, Cursor, Codex, Cline, CLI'en eller almindelig HTTP. apple_ads_report henter resultater for kampagner, annoncegrupper, annoncer, søgeord og søgetermer, og rækkerne kommer tilbage som data i stedet for en CSV-fil, du selv skal flytte et sted hen.

Apple Search Ads-connectoren

Apple udgiver ingen OAuth-flow til deres annonce-API, så forbindelsen er en nøgleudveksling og ikke en knap: Hermoso genererer signeringsnøglen, du indsætter den offentlige halvdel i Apple Ads, og indsætter tre id'er tilbage. Opsætningsguiden til Apple Search Ads gennemgår det, inklusive feltet Public Key, som de fleste ikke kan finde. Én forbindelse betjener derefter webappen, MCP-serveren, CLI'en og REST API'et, så den samme eksport virker fra Claude, ChatGPT eller Cursor: forbind Apple Search Ads til Claude eller til ChatGPT én gang, og spørg derefter.

Rapportering er kun en del af det. Den samme forbindelse bygger og driver også kontoen: kampagner, annoncegrupper, søgeord og negative søgeord, budgetordrer, målretning, søgeordsforslag og ændringshistorik. Siden om Apple Ads-kanalen viser alle værktøjer.

Hvad rapporten indeholder

Ét kald, fem niveauer. apple_ads_report rapporterer på kampagne-, annoncegruppe-, annonce-, søgeords- eller søgeterm-niveau, og hver række har de tal, som Apples egen dashboard viser: visninger, tryk, installationer, forbrug, tap-through rate, omkostning pr. tryk og omkostning pr. erhvervelse. Bed om totaler, eller om en serie på timebasis, dagligt, ugentligt eller månedligt. Rækker kommer tilbage sorteret efter forbrug, højeste først, op til 5.000 pr. side, med en totalrække, hvis du beder om den. App Store-rapporter kan også indeholde enheder uden levering, så et pauseret søgeord vises som nul i stedet for en manglende linje.

To regler, Apple håndhæver, og som værktøjet forklarer i stedet for at fejle stille: en rapport under kampagneniveau kræver et kampagne-id (kun en rapport på kampagneniveau kan dække hele kontoen), og søgetermrapporter køres i din organisations egen tidszone, aldrig UTC. Annoncer på Apple Maps er også dækket: en rapport for business-brands kommer fra det samme værktøj, med én parameter ændret.

Forbind Apple Search Ads til Google Sheets

Dette er den ene destination, Hermoso selv skriver til. Forbind Google Drive ved siden af Apple Ads (én Google-godkendelse dækker Drive, Sheets og Docs), og bed derefter: "Hent Apple Search Ads-resultater pr. søgeord for de sidste 30 dage, og læg dem i et nyt ark kaldet Apple Ads." Agenten kalder apple_ads_report og derefter create_sheet og giver dig linket tilbage. Næste uge gør du det samme med "tilføj", så tilføjer den rækker med append_to_sheet i stedet for at starte forfra.

Hermoso beder Google om drive.file-scopet, som kun når filer, det selv har oprettet, og dem du vælger, aldrig hele dit Drive. Den fulde gennemgang, inklusive udskiftning af et faneblad på stedet og formatering, står på Forbind Apple Search Ads til Google Sheets.

Eksportér Apple Search Ads til Looker Studio

Hermoso har ingen indbygget Looker Studio-connector, og vi vil hellere sige det, end antyde en. Det har heller ikke brug for en: Looker Studio læser Google Sheets med sin egen indbyggede connector, så arket ovenfor er broen.

  1. Lad agenten skrive rapporten ind i ét faneblad. Dagligt niveau, én række pr. søgeord pr. dag, en overskriftsrække og en datokolonne. Bed om at datokolonnen formateres som dato (format_sheet gør det), så Looker Studio læser den som en dato.
  2. Tilføj arket som datakilde. I Looker Studio opretter du en datakilde, vælger Google Sheets, vælger regnearket og fanebladet, og lader "Use first row as headers" være slået til.
  3. Byg rapporten én gang. Forbrug pr. dag, omkostning pr. erhvervelse pr. søgeord, installationer pr. kampagne: alt det, du ellers ville genopbygge i et regneark hver mandag.
  4. Bliv ved med at tilføje. Hver uge tilføjer agenten nye rækker til det samme faneblad, og dashboardet henter dem ved sin næste dataopdatering. Hold kolonnenavnene de samme mellem kørsler, for Looker Studio matcher felter ud fra overskrifterne.

Det samme ark virker til Power BI og Tableau, som begge har egne Google Sheets-connectorer.

Eksportér Apple Search Ads til JSON

Hvis du vil have de rå rækker i stedet for et regneark, er der tre måder at få dem på, alle med den samme forbindelse.

REST API'et. Hvert Hermoso-værktøj kan kaldes på POST /v1/tools/{name} med en API-nøgle, du opretter i appen under fanen MCP & CLI. Request-kroppen er værktøjets argumenter, og svarets felt data er det strukturerede resultat, med rækkerne 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 udskriver det samme strukturerede resultat som JSON, klar til at omdirigere til en fil eller sende videre til et andet script.

Din agent. I enhver chat kan du bede om rækkerne som JSON, og du får dem i svaret, allerede formet, som du bad om.

Til lange rapporter tager limit op til 5.000 rækker pr. side, og offset går til den næste; resultatets hasMore fortæller, om der findes en side mere. Læsning af en rapport bruger ikke credits. Den fulde API-reference findes i udviklerdokumentationen.

Andre destinationer

"Direkte" betyder, at Hermoso skriver det. Alt andet er ét trin, som et værktøj, du allerede bruger, selv udfører.

  • Google Sheets, Google Docs, Google Drive, OneDrive: direkte.
  • Looker Studio, Power BI, Tableau: via arket, hver med sin egen Google Sheets-connector.
  • BigQuery: via arket, eller via din egen agent. BigQuery kan forespørge et Google Sheet som en ekstern tabel. Hvis din agent kører et sted med en BigQuery-klient og dine projektlegitimationsoplysninger, kan den indsætte de rækker, Hermoso returnerer, direkte i en tabel.
  • Excel: via arket eller en fil. Download arket som .xlsx, eller lad agenten efterlade en fil i Google Drive eller OneDrive.
  • PostgreSQL, Redshift, Snowflake eller ethvert datalager: via din egen agent eller API'et. Hermoso returnerer JSON; det, der har dine databaselegitimationsoplysninger, skriver den. Hermoso gemmer ikke legitimationsoplysninger til datalagre.

Automatisering af den ugentlige eksport

Prompten er automatiseringen. Noget som "Hver mandag henter du sidste uges Apple Search Ads-resultater pr. søgeord for alle kampagner, tilføjer dem til Apple Ads-arket, og fortæller mig, hvilke søgeord der flyttede sig mest på omkostning pr. erhvervelse" er et komplet job. Kør det med den planlægning, din klient allerede har (planlagte opgaver i Claude eller ChatGPT, eller et cron-job, der kalder Hermoso CLI'en eller API'et), og arket og alle dashboards, der læser det, holder sig opdaterede.

Fordi den samme forbindelse også redigerer kontoen, lever rapporten og rettelsen de samme steder: agenten, der ser at et søgeords omkostning pr. erhvervelse er fordoblet, kan sætte det på pause eller tilføje et negativt søgeord i samme samtale.

Ofte stillede spørgsmål

Hvordan eksporterer jeg data fra Apple Search Ads?

Forbind Apple Ads til Hermoso én gang, og bed så din agent om den rapport, du vil have, for eksempel søgeordsresultater for sidste uge. Værktøjet apple_ads_report henter den fra Apples rapporterings-API, og agenten skriver den til et Google Sheet, giver dig JSON eller begge dele.

Kan jeg forbinde Apple Search Ads til Google Sheets?

Ja. Forbind Apple Ads og Google Drive i Hermoso, og bed derefter agenten om at lægge rapporten i et ark. Den opretter arket med create_sheet, eller tilføjer rækker til et eksisterende ark med append_to_sheet, og kan gentage det hver uge.

Kan jeg eksportere Apple Search Ads til Looker Studio?

Ja, via Google Sheets. Hermoso har ingen indbygget Looker Studio-connector. Agenten skriver rapporten ind i et ark, du tilføjer arket som Google Sheets-datakilde i Looker Studio én gang, og hver tilføjelse dukker op på dashboardet ved næste opdatering.

Hvordan eksporterer jeg Apple Search Ads-data til JSON?

Kald POST /v1/tools/apple_ads_report på Hermoso API med en API-nøgle og læs data.rows i svaret, eller kør hermoso call apple_ads_report --json '{...}' --structured fra CLI'en. Begge giver de samme rækker som JSON.

Findes der et rapporterings-API for Apple Search Ads?

Ja, og Hermoso er bygget på det. apple_ads_report dækker kampagne-, annoncegruppe-, annonce-, søgeords- og søgetermresultater, og de andre Apple Ads-værktøjer bygger og driver kontoen.

Kan jeg få søgetermrapporter fra Apple Search Ads?

Ja. Bed om søgetermniveauet, og angiv kampagnen. Apple leverer kun søgetermer pr. kampagne, i organisationens egen tidszone.

Hvor mange rækker kan én rapport returnere?

Op til 5.000 pr. side, sorteret efter forbrug fra højest til lavest, med et flag, der fortæller agenten, om flere sider findes. En ugentlig søgeordsrapport for de fleste konti får plads på én side.

Dækker det annoncer på Apple Maps?

Ja. Rapporter for business-brands-kampagner kommer fra det samme værktøj, med objekttypen for promoveret objekt sat til Apple Maps i stedet for App Store.

Har jeg brug for en udvikler for at sætte det op?

Nej. Forbind Apple Ads én gang i appen, og spørg derefter din agent med almindelige ord: hent sidste uge pr. søgeord og læg det i et ark. API'et og CLI'en er der, hvis du vil scripte det.

Start gratis, uden kort, med alle funktioner på alle planer.

Start gratis →   Se priser