Hermoso łączy się z Apple Search Ads i udostępnia je jako narzędzia, które agent może wywołać: Claude, ChatGPT, Cursor, Codex, Cline, CLI albo zwykłe HTTP. apple_ads_report pobiera wyniki kampanii, grup reklam, reklam, słów kluczowych i fraz wyszukiwania, a wiersze wracają jako dane, a nie jako plik CSV do pobrania i ręcznego przenoszenia.
Łącznik Apple Search Ads
Apple nie publikuje przepływu OAuth dla swojego API reklamowego, więc połączenie to wymiana kluczy, a nie przycisk: Hermoso generuje klucz podpisujący, Ty wklejasz jego połowę publiczną do Apple Ads i wpisujesz z powrotem trzy identyfikatory. Przewodnik konfiguracji Apple Search Ads przeprowadza przez to krok po kroku, łącznie z polem Public Key, którego większość osób nie może znaleźć. Jedno połączenie obsługuje potem aplikację webową, serwer MCP, CLI i REST API, więc ten sam eksport działa z Claude, ChatGPT czy Cursora: połącz Apple Search Ads z Claude lub z ChatGPT raz, a potem zadawaj pytania.
Raportowanie to tylko część. To samo połączenie buduje i prowadzi konto: kampanie, grupy reklam, słowa kluczowe i wykluczenia, zlecenia budżetowe, kierowanie, sugestie słów kluczowych i historię zmian. Strona kanału Apple Ads wymienia wszystkie narzędzia.
Co zawiera raport
Jedno wywołanie, pięć poziomów. apple_ads_report raportuje na poziomie kampanii, grupy reklam, reklamy, słowa kluczowego lub frazy wyszukiwania, a każdy wiersz zawiera metryki, które pokazuje własny pulpit Apple: wyświetlenia, kliknięcia, instalacje, wydatki, współczynnik kliknięć, koszt kliknięcia i koszt pozyskania. Możesz poprosić o sumy albo o szereg w granulacji godzinowej, dziennej, tygodniowej lub miesięcznej. Wiersze wracają posortowane według wydatków, od najwyższego, do 5000 na stronę, a na żądanie z wierszem sum całkowitych. Raporty App Store mogą też uwzględniać podmioty bez dostawy, więc wstrzymane słowo kluczowe pojawia się jako zero, a nie jako brakująca linia.
Dwie zasady, które egzekwuje Apple, a które narzędzie wyjaśnia zamiast cicho zawodzić: raport poniżej poziomu kampanii wymaga identyfikatora kampanii (tylko raport na poziomie kampanii może objąć całe konto), a raporty fraz wyszukiwania działają w strefie czasowej Twojej organizacji, nigdy w UTC. Reklamy w Apple Maps są również objęte: raport dla business-brands pochodzi z tego samego narzędzia ze zmienionym jednym parametrem.
Połącz Apple Search Ads z Arkuszami Google
To jedyne miejsce docelowe, do którego Hermoso zapisuje samo. Połącz Dysk Google obok Apple Ads (jedna autoryzacja Google obejmuje Dysk, Arkusze i Dokumenty), a potem zapytaj: “Pobierz wyniki Apple Search Ads według słowa kluczowego za ostatnie 30 dni i wpisz je do nowego arkusza o nazwie Apple Ads.” Agent wywołuje apple_ads_report, potem create_sheet i zwraca link. Następnego tygodnia to samo zapytanie z “dopisz” doda wiersze poleceniem append_to_sheet, zamiast zaczynać od nowa.
Hermoso prosi Google o zakres drive.file, który sięga tylko do plików, które sam utworzył, i do tych, które wybierzesz, nigdy do całego Dysku. Pełny przewodnik, łącznie z zastępowaniem karty w miejscu i jej formatowaniem, znajduje się w Połącz Apple Search Ads z Arkuszami Google.
Eksport Apple Search Ads do Looker Studio
Hermoso nie ma natywnego łącznika Looker Studio i wolimy to powiedzieć wprost, niż sugerować, że jest. Nie jest on potrzebny: Looker Studio czyta Arkusze Google własnym, wbudowanym łącznikiem, więc arkusz powyżej jest mostem.
- Niech agent wpisze raport do jednej karty. Granulacja dzienna, jeden wiersz na słowo kluczowe na dzień, wiersz nagłówka i kolumna daty. Poproś, żeby kolumna daty była sformatowana jako data (
format_sheetto zrobi), aby Looker Studio odczytał ją jako datę. - Dodaj arkusz jako źródło danych. W Looker Studio utwórz źródło danych, wybierz Google Sheets, wskaż arkusz i tę kartę, i zostaw włączone “Use first row as headers”.
- Zbuduj raport raz. Wydatki według dnia, koszt pozyskania według słowa kluczowego, instalacje według kampanii: wszystko, co odtwarzałbyś w arkuszu co poniedziałek.
- Dopisuj dalej. Co tydzień agent dopisuje nowe wiersze do tej samej karty, a pulpit je podejmuje przy następnym odświeżeniu danych. Nazwy kolumn zachowuj takie same między uruchomieniami, bo Looker Studio mapuje pola po nagłówkach.
Ten sam arkusz działa z Power BI i Tableau, które mają własne łączniki do Arkuszy Google.
Eksport Apple Search Ads do JSON
Jeśli chcesz surowe wiersze zamiast arkusza, są trzy sposoby, wszystkie korzystające z tego samego połączenia.
REST API. Każde narzędzie Hermoso jest dostępne pod adresem POST /v1/tools/{name} z kluczem API, który tworzysz w aplikacji na karcie MCP & CLI. Treść zapytania to argumenty narzędzia, a pole data odpowiedzi to ustrukturyzowany wynik, z wierszami w 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 wypisuje ten sam ustrukturyzowany wynik jako JSON, gotowy do przekierowania do pliku albo przekazania do innego skryptu.
Twój agent. W dowolnym czacie poproś o wiersze jako JSON, a dostaniesz je w odpowiedzi, już ukształtowane tak, jak chciałeś.
Przy długich raportach limit przyjmuje do 5000 wierszy na stronę, a offset przechodzi do następnej; hasMore w wyniku mówi, czy istnieje kolejna strona. Czytanie raportu nie zużywa kredytów. Pełna dokumentacja API znajduje się w dokumentacji dla deweloperów.
Inne miejsca docelowe
“Bezpośrednio” oznacza, że zapisuje Hermoso. Wszystko inne to jeden krok, który narzędzie, którego już używasz, wykonuje samo.
- Arkusze Google, Dokumenty Google, Dysk Google, OneDrive: bezpośrednio.
- Looker Studio, Power BI, Tableau: przez arkusz, każde z własnym łącznikiem Arkuszy Google.
- BigQuery: przez arkusz albo przez własnego agenta. BigQuery może odpytywać Arkusz Google jako zewnętrzną tabelę. Jeśli Twój agent działa tam, gdzie jest klient BigQuery i dane dostępowe do Twojego projektu, może wstawić wiersze zwrócone przez Hermoso prosto do tabeli.
- Excel: przez arkusz albo plik. Pobierz arkusz jako .xlsx albo poproś agenta, żeby zostawił plik na Dysku Google lub OneDrive.
- PostgreSQL, Redshift, Snowflake lub dowolna hurtownia: przez własnego agenta albo API. Hermoso zwraca JSON; to, co trzyma dane dostępowe do Twojej bazy, zapisuje go. Hermoso nie przechowuje danych dostępowych do hurtowni.
Automatyzacja cotygodniowego eksportu
Automatyzacją jest sam prompt. Coś w rodzaju “Co poniedziałek pobierz wyniki Apple Search Ads za ostatni tydzień według słowa kluczowego dla każdej kampanii, dopisz je do arkusza Apple Ads i powiedz mi, które słowa kluczowe najbardziej zmieniły koszt pozyskania” to kompletne zadanie. Uruchom je według harmonogramu, który masz już u swojego klienta (zaplanowane zadania w Claude lub ChatGPT albo zadanie cron wywołujące CLI lub API Hermoso), a arkusz i każdy pulpit, który go czyta, pozostaną aktualne.
Ponieważ to samo połączenie edytuje też konto, raport i poprawka są w jednym miejscu: agent, który zauważy, że koszt pozyskania słowa kluczowego się podwoił, może je wstrzymać albo dodać wykluczenie w tej samej rozmowie.
Najczęściej zadawane pytania
Jak wyeksportować dane z Apple Search Ads?
Połącz Apple Ads z Hermoso raz, a potem poproś agenta o raport, który chcesz, na przykład wyniki słów kluczowych za ubiegły tydzień. Narzędzie apple_ads_report pobiera go z API raportowego Apple, a agent zapisuje go do Arkusza Google, przekazuje Ci JSON albo jedno i drugie.
Czy mogę połączyć Apple Search Ads z Arkuszami Google?
Tak. Połącz Apple Ads i Dysk Google w Hermoso, a potem poproś agenta, żeby wpisał raport do arkusza. Pobiera wiersze narzędziem apple_ads_report i zapisuje je poleceniem create_sheet albo append_to_sheet, a potem zwraca link. Może to powtarzać co tydzień.
Czy mogę wyeksportować Apple Search Ads do Looker Studio?
Tak, przez Arkusze Google. Hermoso nie ma natywnego łącznika Looker Studio. Agent wpisuje raport do arkusza, Ty dodajesz ten arkusz raz jako źródło danych Arkuszy Google w Looker Studio, a każde dopisanie pojawia się na pulpicie przy kolejnym odświeżeniu.
Jak wyeksportować dane Apple Search Ads do JSON?
Wywołaj POST /v1/tools/apple_ads_report w API Hermoso kluczem API i odczytaj data.rows z odpowiedzi albo uruchom hermoso call apple_ads_report --json '{...}' --structured z CLI. Oba sposoby zwracają te same wiersze jako JSON.
Czy istnieje API raportowe Apple Search Ads?
Tak, i Hermoso na nim działa. apple_ads_report obejmuje wyniki kampanii, grup reklam, reklam, słów kluczowych i fraz wyszukiwania, a pozostałe narzędzia Apple Ads budują i prowadzą konto.
Czy mogę pobrać raporty fraz wyszukiwania Apple Search Ads?
Tak. Poproś o poziom frazy wyszukiwania i wskaż kampanię. Apple udostępnia frazy wyszukiwania tylko w ramach kampanii, w strefie czasowej organizacji.
Ile wierszy może zwrócić jeden raport?
Do 5000 na stronę, posortowane według wydatków od najwyższego do najniższego, z flagą mówiącą agentowi, czy istnieją kolejne strony. Cotygodniowy raport słów kluczowych dla większości kont mieści się na jednej stronie.
Czy to obejmuje reklamy w Apple Maps?
Tak. Raporty dla kampanii business-brands pochodzą z tego samego narzędzia, z typem promowanego obiektu ustawionym na Apple Maps zamiast App Store.
Czy potrzebuję dewelopera do konfiguracji?
Nie. Połącz Apple Ads raz w aplikacji, a potem zapytaj agenta zwykłym językiem: pobierz wyniki za ostatni tydzień według słowa kluczowego i wpisz je do arkusza. API i CLI są do dyspozycji, jeśli chcesz to skryptować.