Adatok exportálása az Apple Search Ads-ből

Hermoso csatlakozik az Apple Search Ads-hez, és eszközökként teszi elérhetővé az ügynököd számára: Claude, ChatGPT, Cursor, Codex, Cline, CLI vagy sima HTTP. Az apple_ads_report lehúzza a kampány-, hirdetéscsoport-, hirdetés-, kulcsszó- és keresési kifejezés szintű teljesítményt, a sorok pedig adatként jönnek vissza, nem olyan CSV-letöltésként, amelyet aztán valahová el kell vinned.

Az Apple Search Ads csatlakozó

Apple nem tesz közzé OAuth-folyamatot a hirdetési API-jához, így a csatlakoztatás kulcscsere, nem gomb: a Hermoso generálja az aláírókulcsot, te beilleszted a nyilvános felét az Apple Ads-be, és visszaírsz három azonosítót. Az Apple Search Ads beállítási útmutató végigvezet rajta, beleértve a Public Key mezőt, amelyet a legtöbben nem találnak meg. Egyetlen kapcsolat szolgálja ki a webalkalmazást, az MCP-szervert, a CLI-t és a REST API-t, így ugyanaz az export működik Claude-ból, ChatGPT-ből vagy Cursorból: csatlakoztasd az Apple Search Ads-et Claude-hoz vagy ChatGPT-hez egyszer, aztán kérdezz.

A jelentés csak egy része. Ugyanez a kapcsolat építi és futtatja a fiókot is: kampányokat, hirdetéscsoportokat, kulcsszavakat és negatívokat, költségvetési megrendeléseket, célzást, kulcsszó-javaslatokat és változáslistát. Az Apple Ads csatorna oldala felsorolja az összes eszközt.

Mit tartalmaz a jelentés

Egy hívás, öt szint. Az apple_ads_report kampány, hirdetéscsoport, hirdetés, kulcsszó vagy keresési kifejezés szinten jelent, és minden sor azokat a mutatókat tartalmazza, amelyeket Apple saját irányítópultja mutat: megjelenések, koppintások, telepítések, költés, koppintási arány, koppintásonkénti költség és szerzésenkénti költség. Kérhetsz összesítést, vagy sorozatot óránkénti, napi, heti vagy havi bontásban. A sorok költés szerint csökkenő sorrendben jönnek, oldalanként legfeljebb 5000 sorral, kérésre egy végösszeg-sorral. Az App Store-jelentések a kézbesítés nélküli elemeket is tartalmazhatják, így egy szüneteltetett kulcsszó nullaként jelenik meg, nem hiányzó sorként.

Két szabályt Apple kikényszerít, és a tool elmagyarázza ahelyett, hogy csendben meghiúsulna: a kampány alatti szintű jelentéshez kampány-azonosító kell (csak kampányszintű jelentés fedi le az egész fiókot), a keresésikifejezés-jelentések pedig a szervezeted saját időzónájában futnak, sosem UTC-ben. Az Apple Maps-hirdetések is le vannak fedve: egy üzleti márka jelentés ugyanebből az eszközből jön, egyetlen paraméter megváltoztatásával.

Apple Search Ads csatlakoztatása Google Táblázatokhoz

Ez az egyetlen célhely, amelybe a Hermoso maga ír. Csatlakoztasd a Google Drive-ot az Apple Ads mellé (egyetlen Google-engedély fedi a Drive-ot, a Táblázatokat és a Dokumentumokat), majd kérdezd: “Húzd le az elmúlt 30 nap Apple Search Ads-teljesítményét kulcsszavanként, és tedd egy új, Apple Ads nevű táblázatba.” Az ügynök meghívja az apple_ads_report eszközt, majd a create_sheet-et, és visszaadja a linket. A következő héten ugyanez a kérés „hozzáfűzéssel” az append_to_sheet eszközzel sorokat ad a meglévőhöz, ahelyett, hogy újrakezdené.

A Hermoso a Google drive.file hatókörét kéri, amely csak azokat a fájlokat éri el, amelyeket ő hozott létre, vagy te kifejezetten kiválasztottál, nem az egész Drive-odat. A teljes útmutató, beleértve egy lap cseréjét helyben és a formázást, itt olvasható: Apple Search Ads csatlakoztatása Google Táblázatokhoz.

Apple Search Ads exportálása Looker Studióba

A Hermoso-nak nincs natív Looker Studio-csatlakozója, és inkább kimondjuk, mint hogy azt sugalljuk, hogy van. Nem is kell neki: a Looker Studio a Google Táblázatokat a saját beépített csatlakozójával olvassa, így a fenti táblázat a híd.

1. Az ügynök írja a jelentést egy lapra. Napi bontás, egy sor kulcsszavanként és naponként, fejlécsorral és dátumoszloppal. Kérd, hogy a dátumoszlop dátumformátumban legyen (ezt a format_sheet elvégzi), így a Looker Studio dátumként olvassa.
2. Add hozzá a táblázatot adatforrásként. A Looker Studio-ban hozz létre adatforrást, válaszd a Google Táblázatok típust, válaszd ki a táblázatot és azt a lapot, amelyhez az ügynök hozzáfűz, és hagyd bekapcsolva a „Use first row as headers” opciót.
3. Építsd meg a jelentést egyszer. Költés naponta, szerzésenkénti költség kulcsszavanként, telepítések kampányonként: bármi, amit egyébként minden hétfőn újra megépítenél egy táblázatban.
4. Folyamatosan hozzáfűzés. Minden héten az ügynök új sorokat fűz ugyanahhoz a laphoz, és a műszerfal a következő adatfrissítésnél felveszi őket. A futások között tartsd azonosan az oszlopnevek, mert a Looker Studio a fejléc alapján párosítja a mezőket.

Ugyanez a táblázat működik a Power BI-ben és a Tableau-ban is, mindkettőnek saját Google Táblázatok-csatlakozója van.

Apple Search Ads exportálása JSON-ba

Ha a nyers sorokat szeretnéd a táblázat helyett, háromféleképpen kaphatod meg őket, mind ugyanazon a kapcsolaton keresztül.

A REST API. Minden Hermoso-eszköz elérhető a POST /v1/tools/{name} címen egy API-kulccsal, amelyet az alkalmazásban, az MCP & CLI fülön hozol létre. A kérés törzse az eszköz argumentumai, a válasz data mezője pedig a strukturált eredmény, a sorok a data.rows mezőben vannak:

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

A CLI. Az npx -y hermoso call apple_ads_report --json '{...}' --structured ugyanazt a strukturált eredményt adja JSON-ként, így fájlba irányítható vagy másik szkriptbe csővezethető.

Az ügynököd. Bármelyik csevegésben kérd a sorokat JSON-ként, és a válaszban megkapod őket, már azon a formán, ahogy kérted.

Hosszú jelentéseknél a limit legfeljebb 5000 sort kér oldalanként, az offset pedig a következő oldalra lép; az eredmény hasMore mezője mondja meg, van-e még oldal. A jelentés olvasása nem költ kreditet. A teljes API-referencia a fejlesztői dokumentációban található.

Más célok

A „közvetlen” azt jelenti, hogy a Hermoso ír. Minden más egy lépés, amelyet egy már használt eszköz maga elvégez.

• Google Táblázatok, Google Dokumentumok, Google Drive, OneDrive: közvetlen.
• Looker Studio, Power BI, Tableau: a táblázaton keresztül, mindegyik a saját Google Táblázatok-csatlakozójával.
• BigQuery: a táblázaton keresztül, vagy a saját ügynöködön keresztül. A BigQuery külső táblaként le tud kérdezni egy Google Táblázatot. Ha az ügynököd olyan helyen fut, ahol van BigQuery-kliens és a projekt hitelesítő adatai, a Hermoso által visszaadott sorokat közvetlenül beillesztheti egy táblába.
• Excel: a táblázaton vagy fájlon keresztül. Töltsd le a táblázatot .xlsx formátumban, vagy kérd meg az ügynököt, hogy hagyjon egy fájlt a Google Drive-ban vagy a OneDrive-ban.
• PostgreSQL, Redshift, Snowflake vagy bármely adattároló: a saját ügynöködön vagy az API-n keresztül. A Hermoso JSON-t ad vissza; az, ami az adatbázis-hitelesítő adataidat tartja, írja be. A Hermoso nem tárol adattároló-hitelesítő adatokat.

A heti export automatizálása

Maga a kérés az automatizálás. Egy ilyen mondat: “Minden hétfőn húzd le az elmúlt heti Apple Search Ads-teljesítményt kulcsszavanként minden kampányra, fűzd hozzá az Apple Ads táblázathoz, és mondd meg, mely kulcsszavak mozdultak el a legjobban a szerzésenkénti költségben” egy teljes feladat. Futtasd rendszeresen a meglévő ütemezéssel (ütemezett feladatok Claude-ban vagy ChatGPT-ben, vagy egy cron-feladat, amely a Hermoso CLI-t vagy API-t hívja), és a táblázat, valamint minden műszerfal, amely abból olvas, naprakész marad.

Mivel ugyanez a kapcsolat szerkeszti is a fiókot, a jelentés és a javítás egy helyen van: az ügynök, amely észreveszi, hogy egy kulcsszó szerzésenkénti költsége megduplázódott, ugyanabban a beszélgetésben szüneteltetheti vagy negatívként hozzáadhatja.

Gyakori kérdések

Hogyan exportálom az adatokat az Apple Search Ads-ből?

Kösd be egyszer az Apple Ads-et a Hermoso-hoz, aztán kérd az ügynöködtől a kívánt jelentést, például a múlt heti kulcsszóteljesítményt. Az apple_ads_report eszköz lehúzza Apple jelentési API-jából, az ügynök pedig Google Táblázatba írja, JSON-ként adja át, vagy mindkettőt.

Csatlakoztathatom az Apple Search Ads-et Google Táblázatokhoz?

Igen. Kösd be az Apple Ads-et és a Google Drive-ot a Hermoso-ban, aztán kérd meg az ügynököt, hogy tegye a jelentést táblázatba. A create_sheet eszközzel hoz létre táblázatot, vagy az append_to_sheet eszközzel ad sorokat egy meglévőhöz, és ezt minden héten megismételheti.

Exportálhatom az Apple Search Ads-et Looker Studióba?

Igen, a Google Táblázatokon keresztül. A Hermoso-nak nincs natív Looker Studio-csatlakozója. Az ügynök a jelentést egy táblázatba írja, te egyszer hozzáadod azt a táblázatot Google Táblázatok adatforrásként a Looker Studio-ban, és minden hozzáfűzés a műszerfal következő frissítésénél megjelenik.

Hogyan exportálom az Apple Search Ads-adatokat JSON-ba?

Hívd a POST /v1/tools/apple_ads_report végpontot a Hermoso API-n API-kulccsal, és olvasd ki a data.rows mezőt a válaszból, vagy futtasd a hermoso call apple_ads_report --json '{...}' --structured parancsot a CLI-ből. Mindkettő ugyanazokat a sorokat adja vissza JSON-ként.

Van Apple Search Ads jelentési API?

Van, és a Hermoso erre épül. Az apple_ads_report lefedi a kampány-, hirdetéscsoport-, hirdetés-, kulcsszó- és keresési kifejezés szintű teljesítményt, a többi Apple Ads-eszköz pedig felépíti és kezeli a fiókot.

Kérhetek keresésikifejezés-jelentéseket az Apple Search Ads-ből?

Igen. Kérd a keresésikifejezés-szintet, és nevezd meg a kampányt. Apple csak kampányonként szolgál ki keresési kifejezéseket, a szervezet saját időzónájában.

Hány sort adhat vissza egy jelentés?

Oldalanként legfeljebb 5000-et, költés szerint csökkenő sorrendben, egy jelzővel, amely megmondja az ügynöknek, van-e még oldal. A heti kulcsszójelentés a legtöbb fiókban egy oldalba belefér.

Lefedi ez az Apple Maps-hirdetéseket?

Igen. Az üzleti márka kampányok jelentései ugyanebből az eszközből jönnek, a promoted object típust az App Store helyett Apple Maps-re állítva.

Kell fejlesztő a beállításhoz?

Nem. Kösd be az Apple Ads-et egyszer az alkalmazásban, aztán kérdezd az ügynöködet hétköznapi nyelven: húzd le az elmúlt hetet kulcsszavanként, és tedd táblázatba. Az API és a CLI ott van, ha szkriptelni szeretnéd.