Vie data Apple Search Adsista

Hermoso yhdistyy Apple Search Adsiin ja tarjoaa sen työkaluina, joita agenttisi voi kutsua: Claude, ChatGPT, Cursor, Codex, Cline, CLI tai tavallinen HTTP. apple_ads_report hakee kampanja-, mainosryhmä-, mainos-, avainsana- ja hakusanasuorituksen, ja rivit tulevat takaisin datana eikä CSV-latauksena, jonka sinun pitäisi sitten kuljettaa jonnekin.

Apple Search Ads -konnektori

Apple ei julkaise OAuth-virtaa mainosrajapinnalleen, joten yhdistäminen on avainvaihto eikä painike: Hermoso luo allekirjoitusavaimen, sinä liität sen julkisen puoliskon Apple Adsiin ja liität kolme tunnusta takaisin. Apple Search Adsin asennusopas käy prosessin läpi, mukaan lukien Public Key -kentän, jota useimmat eivät löydä. Yksi yhteys palvelee sitten verkkosovellusta, MCP-palvelinta, CLI:tä ja REST-rajapintaa, joten sama vienti toimii Claudesta, ChatGPT:stä tai Cursorista: yhdistä Apple Search Ads Claudeen tai ChatGPT:hen kerran ja kysy sitten.

Raportointi on vain yksi osa. Sama yhteys rakentaa ja ylläpitää myös tilin: kampanjat, mainosryhmät, avainsanat ja negatiivit, budjettitilaukset, kohdennuksen, avainsanaehdotukset ja muutoshistorian. Apple Ads -kanavasivu listaa kaikki työkalut.

Mitä raportti sisältää

Yksi kutsu, viisi tasoa. apple_ads_report raportoi kampanja-, mainosryhmä-, mainos-, avainsana- tai hakusana-tasolla, ja jokainen rivi sisältää mittarit, jotka Applen oma kojelauta näyttää: näytöt, napautukset, asennukset, menot, napautussuhde, napautuskohtainen kustannus (CPT) ja hankintakohtainen kustannus (CPA). Pyydä yhteenveto tai sarja tunti-, päivä-, viikko- tai kuukausitasolla. Rivit tulevat järjestettynä menojen mukaan, korkeimmasta alkaen, enintään 5 000 riviä sivulla, ja pyydettäessä myös kokonaissummarivi. App Store -raporteissa mukana voi olla kohteita ilman toimitusta, joten keskeytetty avainsana näkyy nollana eikä rivi katoa.

Kaksi sääntöä, jotka Apple valvoo ja joita työkalu selittää sen sijaan, että epäonnistuisi hiljaa: raportti kampanjatasoa alemmalla tasolla vaatii kampanja-id:n (vain kampanjatason raportti voi kattaa koko tilin), ja hakusanaraportit kulkevat organisaatiosi omassa aikavyöhykkeessä, ei koskaan UTC:ssä. Myös Apple Mapsin mainokset ovat mukana: liiketoimintabrändien raportti tulee samasta työkalusta, kun yhden parametrin vaihtaa.

Yhdistä Apple Search Ads Google Sheetsiin

Tämä on ainoa kohde, johon Hermoso kirjoittaa itse. Yhdistä Google Drive Apple Adsin rinnalle (yksi Google-valtuutus kattaa Driven, Sheetsin ja Docsin) ja kysy: "Hae Apple Search Ads -suoritus avainsanoittain viimeiseltä 30 päivältä ja laita se uuteen taulukkoon nimeltä Apple Ads." Agentti kutsuu apple_ads_report, sitten create_sheet ja antaa linkin. Ensi viikolla sama pyyntö sanalla "lisää" lisää rivit append_to_sheet-työkalulla sen sijaan, että aloitettaisiin alusta.

Hermoso pyytää Googlelta drive.file-oikeutta, joka tavoittaa vain tiedostot, jotka se loi, ja ne, jotka valitset, ei koskaan koko Driveasi. Täydellinen ohje, mukaan lukien välilehden korvaaminen paikoillaan ja muotoilu: Yhdistä Apple Search Ads Google Sheetsiin.

Vie Apple Search Ads Looker Studioon

Hermosolla ei ole omaa Looker Studio -konnektoria, eikä sitä haluta esittää sellaisena. Sitä ei tarvita: Looker Studio lukee Google-taulukoita omalla sisäänrakennetulla konnektorillaan, joten yllä oleva taulukko on siltana.

1. Anna agentin kirjoittaa raportti yhteen välilehteen. Päivätaso, yksi rivi avainsanaa kohden päivässä, otsikkorivi ja päivämäärä-sarake. Pyydä päivämäärä-sarake muotoiltavaksi päivämääränä (format_sheet tekee sen), jotta Looker Studio lukee sen päivämääränä.
2. Lisää taulukko datalähteenä. Looker Studiossa luo datalähde, valitse Google Sheets, valitse taulukko ja se välilehti, ja pidä "Use first row as headers" päällä.
3. Rakenna raportti kerran. Menot päivittäin, hankintakustannus (CPA) avainsanoittain, asennukset kampanjoittain: se, minkä muuten rakentaisit taulukkoon uudelleen joka maanantai.
4. Jatka lisäämistä. Joka viikko agentti lisää uudet rivit samalle välilehdelle, ja koontinäkymä näkee ne seuraavassa datan päivityksessä. Pidä sarakkeiden nimet samoina ajojen välillä, koska Looker Studio yhdistää kentät otsikon mukaan.

Sama taulukko toimii Power BI:lle ja Tableaulle, joilla on molemmilla omat Google Sheets -konnektorinsa.

Vie Apple Search Ads JSON-muodossa

Jos haluat raakarivit taulukon sijaan, niitä on kolmea tapaa, kaikki samalla yhteydellä.

REST-rajapinta. Jokainen Hermoso-työkalu on kutsuttavissa osoitteessa POST /v1/tools/{name} API-avaimella, jonka luot sovelluksessa välilehdellä MCP & CLI. Pyynnön runko on työkalun argumentit, ja vastauksen kenttä data on jäsennelty tulos, rivit kentässä 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. npx -y hermoso call apple_ads_report --json '{...}' --structured tulostaa saman jäsennellyn tuloksen JSON-muodossa, valmiina ohjattavaksi tiedostoon tai toiseen skriptiin.

Agenttisi. Missä tahansa chatissa pyydä rivit JSON-muodossa, ja saat ne vastauksessa jo muotoiltuina haluamallasi tavalla.

Pitkiä raportteja varten limit ottaa enintään 5 000 riviä sivulta ja offset siirtää seuraavalle sivulle; tuloksen hasMore kertoo, onko sivuja vielä. Raportin lukeminen ei kuluta krediittejä. Täysi API-viite on kehittäjädokumentaatiossa.

Muut kohteet

"Suoraan" tarkoittaa, että Hermoso kirjoittaa sen. Kaikki muu on yksi vaihe, jonka jo käyttämäsi työkalu tekee itse.

• Google Sheets, Google Docs, Google Drive, OneDrive: suoraan.
• Looker Studio, Power BI, Tableau: taulukon kautta, kullakin oma Google Sheets -konnektori.
• BigQuery: taulukon kautta tai oman agentin kautta. BigQuery voi kysyä Google-taulukkoa ulkoisena taulukkona. Jos agenttisi toimii paikassa, jossa on BigQuery-asiakas ja projektisi tunnukset, se voi lisätä Hermoson palauttamat rivit suoraan tauluun.
• Excel: taulukon tai tiedoston kautta. Lataa taulukko .xlsx-muodossa tai pyydä agenttia jättämään tiedosto Google Driveen tai OneDriveen.
• PostgreSQL, Redshift, Snowflake tai mikä tahansa tietovarasto: oman agentin tai API:n kautta. Hermoso palauttaa JSONin; se, jolla on tietokantasi tunnukset, kirjoittaa sen. Hermoso ei säilytä tietovaraston tunnuksia.

Viikkoviennin automatisointi

Kehote on automaatio. Jokin tällainen: "Hae joka maanantai viime viikon Apple Search Ads -suoritus avainsanoittain kaikille kampanjoille, lisää se Apple Ads -taulukkoon ja kerro, mitkä avainsanat liikkuivat eniten hankintakustannuksessa (CPA)" on valmis työ. Aja se aikataulusta asiakkaalla, jota käytät (ajastetut tehtävät Claudessa tai ChatGPT:ssä, tai cron-työ, joka kutsuu Hermoso-CLI:tä tai API:a), ja taulukko sekä kaikki sitä lukevat koontinäkymät pysyvät ajan tasalla.

Koska sama yhteys muokkaa myös tiliä, raportti ja korjaus ovat samassa paikassa: agentti, joka huomaa avainsanan hankintakustannuksen kaksinkertaistuneen, voi keskeyttää sen tai lisätä negatiivin samassa keskustelussa.

Usein kysytyt kysymykset

Miten vien Apple Search Ads -tiedot?

Yhdistä Apple Ads Hermosoon kerran, pyydä sitten agenttia hakemaan haluamasi raportti, esimerkiksi viime viikon suoritus avainsanoittain. Apple Ads -työkalu apple_ads_report hakee sen Applen raportointirajapinnasta, ja agentti kirjoittaa sen Google-taulukkoon, antaa JSONin tai molemmat.

Voinko yhdistää Apple Search Adsin Google Sheetsiin?

Kyllä. Yhdistä Apple Ads ja Google Drive Hermosossa ja pyydä agenttia laittamaan raportti taulukkoon. Se luo taulukon create_sheet-työkalulla tai lisää rivit olemassa olevaan append_to_sheet-työkalulla, ja voi toistaa tämän viikoittain.

Voinko viedä Apple Search Adsin Looker Studioon?

Kyllä, Google Sheetsin kautta. Hermosossa ei ole omaa Looker Studio -konnektoria. Agentti kirjoittaa raportin taulukkoon, lisäät sen kerran Looker Studioon Google Sheets -datalähteenä, ja jokainen lisäys näkyy koontinäkymässä seuraavassa päivityksessä.

Miten vien Apple Search Adsin tiedot JSON-muodossa?

Kutsu POST /v1/tools/apple_ads_report Hermoso-API:ssa API-avaimella ja lue data.rows vastauksesta, tai aja CLI:stä hermoso call apple_ads_report --json '{...}' --structured. Molemmat palauttavat samat rivit JSON-muodossa.

Onko Apple Search Adsilla raportointirajapinta?

On, ja Hermoso on rakennettu sen päälle. apple_ads_report kattaa kampanja-, mainosryhmä-, mainos-, avainsana- ja hakusanasuorituksen, ja muut Apple Ads -työkalut rakentavat ja hallitsevat tiliä.

Voinko hakea Apple Search Adsin hakusanaraportit?

Kyllä. Pyydä hakusanatasoa ja nimeä kampanja. Apple tarjoaa hakusanat vain kampanjoittain, organisaatiosi omassa aikavyöhykkeessä.

Kuinka monta riviä yksi raportti voi palauttaa?

Enintään 5 000 sivulta, järjestettynä menojen mukaan korkeimmasta alimpaan, ja lippu kertoo agentille, onko sivuja enemmän. Viikkoittainen avainsanaraportti useimmille tileille mahtuu yhdelle sivulle.

Kattaako tämä Apple Mapsin mainokset?

Kyllä. Liiketoimintabrändien kampanjojen raportit tulevat samasta työkalusta, kun kohteen tyypiksi asetetaan Apple Maps App Storen sijaan.

Tarvitsenko kehittäjän tämän pystyttämiseen?

Et. Yhdistä Apple Ads kerran sovelluksessa, pyydä sitten agenttia tavallisella kielellä: hae viime viikko avainsanoittain ja laita se taulukkoon. API ja CLI ovat siellä, jos haluat skriptata sen.