Připojte Apple Ads a Google Drive k Hermoso a oba budou dostupné ze stejného agenta. apple_ads_report stáhne řádky s výkonem; create_sheet a append_to_sheet je zapíšou do tabulky, kterou vlastníte. Žádný exportovaný soubor, žádný sklad dat a žádný třetí nástroj, který by držel vaše přihlašovací údaje.
Jak to vypadá
„Vytáhni výdaje na Apple Search Ads za minulý týden podle klíčových slov a připiš je do mé tabulky Apple Ads.“ Agent zavolá report, upraví řádky a připíše je. Zeptejte se příští pondělí znovu a tabulka poroste o další týden.
Rozsah Google Drive, který Hermoso žádá, je drive.file. Ten dosáhne na soubory, které Hermoso vytvořilo, nebo které jste vybrali, ne na celý váš Drive.
Jak připojit Apple Search Ads k Google Sheets
- Připojte oba účty. V aplikaci otevřete Konektory, připojte Apple Ads a pak Google Drive. Sheets a Docs jdou přes stejné oprávnění Google, takže je to jedna obrazovka souhlasu, ne tři. Apple Ads není tlačítko, ale výměna klíčů; návod k nastavení Apple Search Ads to popisuje, včetně toho, jak připojit Apple Search Ads k Claude nebo ChatGPT, kde budete psát požadavek.
- Vyžádejte první stažení. „Stáhni výkon Apple Search Ads za posledních 30 dní po kampaních a dej to do nové tabulky s názvem Apple Ads.“ Agent zavolá
apple_ads_report, pakcreate_sheeta vrátí vám odkaz. - Udělejte to pravidelné. Stejná věta s „připiš“ místo „nová tabulka“, spuštěná podle plánu z klienta, který používáte (naplánovaný úkol v Claude nebo ChatGPT, nebo cron úloha volající CLI Hermoso), přidá pokaždé další blok řádků. Nic se nepřepíše, dokud o to výslovně nepožádáte.
- Nasměrujte dashboard na tabulku. Looker Studio, Power BI i Tableau čtou Google Sheets svými vlastními konektory.
Jak tabulka vypadá
Jeden řádek na entitu a období. Sloupce odpovídají úrovni, kterou jste si vyžádali (kampaň, skupina reklam, reklama, klíčové slovo nebo hledaný výraz), plus metriky, které Apple vykazuje: zobrazení, klepnutí, instalace, výdaje, míra prokliku, cena za klepnutí a cena za akvizici. Pokud si vyžádáte denní granularitu, dostane každá entita jeden řádek denně; pokud součty, dostane jeden. Agent může přidat řádek s celkovými součty a u reportů App Store může ponechat entity bez doručení, takže pozastavené klíčové slovo se ukáže jako nula a nezmizí.
Protože agent řádky před zápisem upravuje, můžete si vyžádat přesně tu tabulku, kterou chcete: jen klíčová slova nad určitou výši výdajů, název kampaně vedle jejího ID, týdenní změny spočítané ještě před zápisem. To je práce, kterou CSV export nechá na vás.
Připsat, nahradit nebo naformátovat
Nástroje pro Sheets pokrývají celou úpravu: append_to_sheet přidá řádky, update_sheet zapíše rozsah na místě, clear_sheet_range nejdřív vyprázdní rozsah, když chcete nahrazení místo hromadění, format_sheet řeší záhlaví, šířky a číselné formáty a manage_sheet_tabs dá každé kampani nebo každému měsíci vlastní list. Požadavek „obnov tabulku dashboardu“ je vymazání a pak zápis na list, který pojmenujete.
Export Apple Search Ads do Looker Studio z tabulky
Hermoso nemá vlastní konektor pro Looker Studio; mostem je tabulka. V Looker Studio vytvořte zdroj dat, zvolte Google Sheets a vyberte tabulku a list, do kterého agent připisuje. Report sestavte jednou a nechte být. Každé připsání se objeví při dalším obnovení dat dashboardu, pokud se záhlaví sloupců mezi jednotlivými běhy nezmění. Stejný postup funguje pro Power BI i Tableau.
Chcete JSON místo tabulky?
Stejný report je k dispozici jako surový JSON z API Hermoso (POST /v1/tools/apple_ads_report) nebo z CLI. Viz Export Apple Search Ads do JSON a export dat z Apple Search Ads pro všechna ostatní místa určení.
Často kladené otázky
Jak připojím Apple Search Ads k Google Sheets?
Připojte Apple Ads a Google Drive v Hermoso a pak požádejte agenta, aby report zapsal do tabulky. Řádky stáhne přes apple_ads_report, zapíše je přes create_sheet nebo append_to_sheet a vrátí vám odkaz.
Potřebuje Hermoso přístup k celému mému Google Drive?
Ne. Žádá rozsah drive.file, který pokrývá soubory vytvořené Hermoso a soubory, které výslovně vyberete.
Jaké úrovně a metriky mohou jít do tabulky?
Úroveň kampaně, skupiny reklam, reklamy, klíčového slova nebo hledaného výrazu, se zobrazeními, klepnutími, instalacemi, výdaji, mírou prokliku, cenou za klepnutí a cenou za akvizici, buď jako součty, nebo jako časovou řadu po hodinách, dnech, týdnech nebo měsících.
Přepíše naplánovaný report moji tabulku?
Ne, pokud o to nepožádáte. Připsání přidává řádky; nahrazení je vymazání a pak zápis na list, který pojmenujete, a agent to udělá jen tehdy, když to požadavek výslovně říká.
Mohou výsledek číst Looker Studio nebo Power BI?
Ano. Hermoso pro žádný z nich nemá vlastní konektor, ale oba čtou Google Sheets svými vlastními konektory, takže se dashboard postavený na tabulce obnoví, jakmile jí agent připíše nová data.
Může report běžet podle plánu?
Ano, z klienta, ve kterém váš agent běží: naplánovaný úkol v Claude nebo ChatGPT, nebo cron úloha volající CLI či API Hermoso. Každý běh stáhne nové období a připíše ho.