Hermoso se připojuje k Apple Search Ads a zpřístupňuje je jako nástroje, které může váš agent volat: Claude, ChatGPT, Cursor, Codex, Cline, CLI nebo prostý HTTP. apple_ads_report stáhne výkon kampaní, skupin reklam, reklam, klíčových slov a hledaných výrazů a řádky se vrátí jako data, ne jako soubor CSV ke stažení, který pak musíte někam přenést.
Konektor Apple Search Ads
Apple pro své reklamní API nenabízí žádný tok OAuth, takže připojení je výměna klíčů, ne tlačítko: Hermoso vygeneruje podpisový klíč, vy vložíte jeho veřejnou polovinu do Apple Ads a zpět vložíte tři identifikátory. Návod k nastavení Apple Search Ads to provede krok za krokem, včetně pole Public Key, které většina lidí nenajde. Jedno připojení pak obslouží webovou aplikaci, server MCP, CLI i REST API, takže stejný export funguje z Claude, ChatGPT nebo Cursoru: připojte Apple Search Ads k Claude nebo k ChatGPT jednou a potom se ptejte.
Reporting je jen jedna část. Stejné připojení vytváří a řídí i účet: kampaně, skupiny reklam, klíčová slova a negativní klíčová slova, rozpočtové příkazy, cílení, návrhy klíčových slov a historii změn. Na stránce kanál Apple Ads je seznam všech nástrojů.
Co report obsahuje
Jedno volání, pět úrovní. apple_ads_report vykazuje na úrovni kampaně, skupiny reklam, reklamy, klíčového slova nebo hledaného výrazu a každý řádek nese metriky, které ukazuje i vlastní dashboard Applu: zobrazení, klepnutí, instalace, výdaje, míra prokliku, cena za klepnutí a cena za akvizici. Můžete si vyžádat součty, nebo řadu s granularitou po hodinách, dnech, týdnech nebo měsících. Řádky se vracejí seřazené podle výdajů, od nejvyšších, až 5 000 na stránku, s řádkem celkových součtů na vyžádání. Reporty App Store mohou zahrnovat i entity bez doručení, takže pozastavené klíčové slovo se ukáže jako nula místo chybějícího řádku.
Dvě pravidla, která Apple vynucuje a nástroj je vysvětluje místo tichého selhání: report pod úrovní kampaně potřebuje ID kampaně (jen report na úrovni kampaně může pokrýt celý účet) a reporty hledaných výrazů běží v časovém pásmu vaší organizace, nikdy v UTC. Reklamy v Apple Maps jsou také pokryty: report pro business brands přichází ze stejného nástroje se změněným jedním parametrem.
Připojte Apple Search Ads k Google Sheets
Je to jediné místo určení, kam Hermoso zapisuje samo. Připojte Google Drive vedle Apple Ads (jedno oprávnění Google pokrývá Drive, Sheets i Docs) a zeptejte se: „Stáhni výkon Apple Search Ads po klíčových slovech za posledních 30 dní a dej ho do nové tabulky s názvem Apple Ads.“ Agent zavolá apple_ads_report, pak create_sheet a vrátí vám odkaz. Příští týden stejný požadavek s „připiš“ přidá řádky pomocí append_to_sheet, takže se nezačíná od nuly.
Hermoso žádá od Google rozsah drive.file, který dosáhne jen na soubory, které vytvořilo, a na ty, které vyberete, nikdy na celý váš Drive. Úplný postup včetně nahrazení listu na místě a jeho formátování je na stránce Připojte Apple Search Ads k Google Sheets.
Export Apple Search Ads do Looker Studio
Hermoso nemá nativní konektor pro Looker Studio a raději to řekneme přímo, než abychom naznačovali opak. Nepotřebuje ho: Looker Studio čte Google Sheets vestavěným konektorem, takže výše zmíněná tabulka je mostem.
- Nechte agenta zapsat report do jednoho listu. Denní granularita, jeden řádek na klíčové slovo za den, řádek záhlaví a sloupec s datem. Požádejte, aby byl sloupec s datem naformátován jako datum (to zvládne
format_sheet), aby ho Looker Studio načetl jako datum. - Přidejte tabulku jako zdroj dat. V Looker Studio vytvořte zdroj dat, zvolte Google Sheets, vyberte tabulku a ten list a ponechte zapnuté „Use first row as headers“.
- Sestavte report jednou. Výdaje podle dne, cena za akvizici podle klíčového slova, instalace podle kampaně: cokoli byste jinak každé pondělí přestavovali v tabulce.
- Dál připisujte. Každý týden agent připíše nové řádky do stejného listu a dashboard je při dalším obnovení dat načte. Názvy sloupců mezi jednotlivými běhy zachovejte stejné, protože Looker Studio mapuje pole podle záhlaví.
Stejná tabulka funguje i pro Power BI a Tableau, které mají vlastní konektory pro Google Sheets.
Export Apple Search Ads do JSON
Pokud chcete surové řádky místo tabulky, existují tři způsoby, všechny přes stejné připojení.
REST API. Každý nástroj Hermoso lze volat na adrese POST /v1/tools/{name} s klíčem API, který vytvoříte v aplikaci na záložce MCP & CLI. Tělo požadavku jsou argumenty nástroje a pole data v odpovědi je strukturovaný výsledek, přičemž řádky jsou v 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. npx -y hermoso call apple_ads_report --json '{...}' --structured vypíše stejný strukturovaný výsledek jako JSON, připravený k přesměrování do souboru nebo k předání jinému skriptu.
Váš agent. V jakémkoli chatu si řádky vyžádejte jako JSON a dostanete je v odpovědi, už upravené tak, jak jste chtěli.
U dlouhých reportů bere limit až 5 000 řádků na stránku a offset přesune na další; pole hasMore ve výsledku říká, zda existuje další stránka. Čtení reportu nestojí kredity. Úplná referenční příručka API je v vývojářské dokumentaci.
Další cíle
„Přímo“ znamená, že zapisuje Hermoso. Všechno ostatní je jeden krok, který udělá nástroj, jež už používáte.
- Google Sheets, Google Docs, Google Drive, OneDrive: přímo.
- Looker Studio, Power BI, Tableau: přes tabulku, každý s vlastním konektorem pro Google Sheets.
- BigQuery: přes tabulku, nebo přes vlastního agenta. BigQuery umí dotazovat Google Sheets jako externí tabulku. Pokud váš agent běží tam, kde je klient BigQuery a vaše přihlašovací údaje k projektu, může řádky, které vrátí Hermoso, vložit rovnou do tabulky.
- Excel: přes tabulku nebo soubor. Stáhněte tabulku jako .xlsx, nebo nechte agenta uložit soubor na Google Drive nebo OneDrive.
- PostgreSQL, Redshift, Snowflake nebo jakýkoli jiný sklad dat: přes vlastního agenta nebo API. Hermoso vrací JSON; cokoli, co drží přihlašovací údaje k vaší databázi, do ní zapíše. Hermoso přihlašovací údaje ke skladu dat nedrží.
Automatizace týdenního exportu
Automatizací je samotný prompt. Něco jako „Každé pondělí stáhni výkon Apple Search Ads za minulý týden po klíčových slovech u všech kampaní, připiš ho do tabulky Apple Ads a řekni mi, které klíčové slovo se nejvíc pohnulo v ceně za akvizici“ je úplná úloha. Spouštějte ji podle plánu pomocí plánování, které už má váš klient (naplánované úkoly v Claude nebo ChatGPT, nebo cron úloha volající CLI či API Hermoso), a tabulka i všechny dashboardy, které ji čtou, zůstanou aktuální.
Protože stejné připojení také upravuje účet, reportování i oprava žijí na jednom místě: agent, který si všimne, že cena za akvizici klíčového slova se zdvojnásobila, ho může ve stejné konverzaci pozastavit nebo přidat negativní klíčové slovo.
Často kladené otázky
Jak exportuji data z Apple Search Ads?
Jednou připojte Apple Ads k Hermoso a pak se agenta zeptejte na report, který chcete, například výkon klíčových slov za minulý týden. Nástroj apple_ads_report jej stáhne z reportovacího API Applu a agent jej zapíše do Google Sheets, předá vám JSON, nebo obojí.
Mohu připojit Apple Search Ads k Google Sheets?
Ano. Připojte v Hermoso Apple Ads a Google Drive a pak požádejte agenta, aby report zapsal do tabulky. Tabulku vytvoří přes create_sheet nebo připíše řádky do existující přes append_to_sheet a může to opakovat každý týden.
Mohu exportovat Apple Search Ads do Looker Studio?
Ano, přes Google Sheets. Hermoso nemá nativní konektor pro Looker Studio. Agent zapíše report do tabulky, vy ji jednou přidáte v Looker Studio jako zdroj dat Google Sheets a každé připsání se objeví při dalším obnovení dashboardu.
Jak exportuji data z Apple Search Ads do JSON?
Zavolejte POST /v1/tools/apple_ads_report na API Hermoso s klíčem API a přečtěte data.rows z odpovědi, nebo z CLI spusťte hermoso call apple_ads_report --json '{...}' --structured. Obě cesty vrátí stejné řádky jako JSON.
Existuje reportovací API pro Apple Search Ads?
Ano, a Hermoso na něm stojí. apple_ads_report pokrývá výkon kampaní, skupin reklam, reklam, klíčových slov a hledaných výrazů a ostatní nástroje Apple Ads vytvářejí a spravují účet.
Mohu získat reporty hledaných výrazů z Apple Search Ads?
Ano. Požádejte o úroveň hledaného výrazu a uveďte kampaň. Apple hledané výrazy vydává jen po kampaních a v časovém pásmu organizace.
Kolik řádků může jeden report vrátit?
Až 5 000 na stránku, seřazených podle výdajů od nejvyšších po nejnižší, s příznakem, který agentovi říká, zda existují další stránky. Týdenní report klíčových slov se u většiny účtů vejde na jednu stránku.
Vztahuje se to i na reklamy v Apple Maps?
Ano. Reporty pro kampaně business brands přicházejí ze stejného nástroje, když se typ propagovaného objektu nastaví na Apple Maps místo App Store.
Potřebuji k nastavení vývojáře?
Ne. Připojte Apple Ads jednou v aplikaci a pak se agenta zeptejte prostým jazykem: stáhni minulý týden po klíčových slovech a dej to do tabulky. API a CLI tu jsou, pokud to chcete skriptovat.