Yhdistä Apple Search Ads Claudeen tai ChatGPT:hen viidessä minuutissa

Hermoso Apple Search Ads -yhdistin kytkee Apple Ads -tilisi Claudeen, ChatGPT:hen, Cursoriin, CLI:hin tai tavalliseen HTTP-liikenteeseen, jolloin agentti voi hoitaa App Store -hakumainoksesi puolestasi. Se rakentaa kampanjan, mainosryhmän, kohdennusavainsanat ja negatiiviset avainsanat, lukee takaisin, mitä Apple todella tallensi, ja raportoi suorituksen aina siihen hakusanaan asti, jonka joku kirjoitti ennen asennusta. Kaikki luotu luodaan pysäytettynä, ja menojen käynnistäminen on erillinen, erikseen vahvistettava vaihe. Raportit voivat päätyä Google-taulukkoon, Looker Studio -koontinäkymään tai JSON-tiedostoon, ja Apple Ads MCP -sivu listaa kaiken, mitä yhdistin osaa.

Yhdistäminen vie noin viisi minuuttia. Et aja openssl-komentoa, eikä Apple-salasanasi mene lähellekään Hermosoa.

Yhdistä Apple Search Ads Claudeen

Yhdistääksesi Apple Search Adsin Claudeen lisää Hermoso Claudeen konnektorina ja yhdistät sitten Apple Ads -tilisi Hermosossa kerran. Claudessa avaa Customize › Connectors › Add custom connector, nimeä se Hermoso, liitä https://app.hermoso.ai/mcp ja hyväksy se Hermoso-tilillälläsi. Claudeen ei tarvitse liittää mitään avainta. Yhdistä sen jälkeen Apple Ads Hermosossa kohdassa Asetukset › Yhdistimet, noudattaen tämän sivun alemmassa osassa kuvattuja vaiheita. Siitä eteenpäin Claude voi kutsua jokaista Apple Ads -työkalua, jonka Hermosolla on: pyydä raportti, avainsanamuutos tai uusi kampanja tavallisilla sanoilla. Claude Codessa tämä vaatii kaksi komentoa: /plugin marketplace add hermoso-ai/hermoso ja sitten /plugin install hermoso@hermoso. Hermoso Claudessa kertoo koko prosessin.

Yhdistä Apple Search Ads ChatGPT:hen

ChatGPT toimii samalla tavalla. Avaa ChatGPT:ssä Plugins, sitten Add › Create MCP App, nimeä se Hermoso, liitä https://app.hermoso.ai/mcp Server URL -kenttään, jätä Authentication OAuthiin ja hyväksy Hermoso-tilillälläsi. Jos Create MCP App ei näy, ota Developer mode käyttöön kerran kohdassa Settings › Plugins › Developer mode. Kun Apple Ads on yhdistetty Hermosossa, ChatGPT voi hakea avainsanaraporttisi, kirjoittaa sen Google-taulukkoon tai laatia kampanjaluonnoksen, jonka tarkistat. Hermoso ChatGPT:ssä käy läpi prosessin.

Cursor, Codex ja muu MCP-asiakas

Jokainen Model Context Protocolia puhuva asiakas tavoittaa samat työkalut samassa osoitteessa. Cursor lukee osoitteen https://app.hermoso.ai/mcp tiedostostaan mcp.json; Codex ottaa Hermoso-liitännäisen komennolla codex plugin marketplace add hermoso-ai/hermoso, ja se ajaa samat työkalut terminaalista. Millä asiakkaalla tahansa käytätkin, Apple-tunnuksesi eivät kulje koskaan chatin kautta. Agentti kutsuu Hermoson työkaluja, ja Hermoso allekirjoittaa jokaisen pyynnön Applelle avaimella, joka on sen hallussa. Apple Ads MCP -sivu listaa jokaisen työkalun.

Mitä pyytää, kun yhteys on valmis

• “Hae viime viikon Apple Search Ads -suoritus avainsanoittain ja näytä kymmenen korkeinta hankintakustannusta (CPA).”
• “Laita viimeisten 30 päivän menot, asennukset ja CPA kampanjoittain uuteen Google-taulukkoon nimeltä Apple Ads.” (Yhdistä ensin Google Drive.)
• “Mitkä hakusanat toivat asennuksia US-kampanjassani tässä kuussa, joita en vielä tarjoa tarkkoina avainsanoina?”
• “Lisää ‘budget planner’ ja ‘expense tracker’ tarkkoina avainsanoina Brand-mainosryhmään ja ‘jobs’ negatiivisena.”
• “Mitä avainsanoja Apple ehdottaa sovellukselleni, ja kuinka suuren osan näytöistä saan niistä, joita jo tarjoan?”
• “Rakenna sovellukselleni keskeytetty kampanja Britanniaan 50 dollarin päivittäisellä budjetilla ja näytä sitten, mitä Apple tallensi.”

Raportin lukeminen ei koske menoihin koskaan. Agentin rakentama kaikki luodaan pysäytettynä, ja menot käynnistävä kytkin odottaa sinun nimenomaista vahvistustasi.

Ensin se, mikä pysäyttää useimmat

Applen omat ohjeet sanovat: “Valitse Ads-käyttöliittymästä Account Settings › API. Liitä avain kenttään Public Key.”

Tuo kenttä ei ole olemassa Account Adminille. Kirjaudu adminina omalle tilillesi, avaa Account Settings › API, ja sivulla näkyy taulukko otsikolla Manage API Access (luettelo kolmannen osapuolen palveluntarjoajista, yhdellä toiminnolla Remove Access) eikä avainkenttää missään. Se näyttää täsmälleen puuttuvalta ominaisuudelta, minkä vuoksi ihmiset pysähtyvät tähän ja päättelevät, ettei API ole heidän käytettävissään.

Se on kuitenkin käytettävissä. Public Key -kenttä kuuluu käyttäjälle, jolla on API-rooli, eikä tilin ylläpitäjyys ole sellainen. Applen kutsudialogi tarjoaa kuusi roolia, joista täsmälleen kaksi on API-rooleja:

• API Account Manager: “luku- ja kirjoitusoikeus kaikkiin kampanjaryhmiin API-hallintaa varten”. Tämä on se, jonka kannattaa valita, jos haluat Hermoson rakentavan kampanjoita eikä vain raportoivan niistä.
• API Account Read Only: “pelkkä lukuoikeus kaikkiin kampanjaryhmiin API-hallintaa varten”. Riittää raportointiin, ei mihinkään muuhun.

Muut neljä (Account Admin, Account Finance, Account Read Only ja Limited Access) eivät voi luoda API-tunnuksia lainkaan. Korjaus on siis kutsu, jonka lähetät itsellesi:

1. Avaa Account Settings › User Management ja valitse Invite Users.
2. Kutsu osoite, jonka hallitset (oma tai yhteinen, kuten ads-api@yourcompany.com, jotta tunnus säilyy, vaikka yksi ihminen lähtisi), roolilla API Account Manager.
3. Hyväksy kutsu siitä postilaatikosta ja kirjaudu sitten Apple Adsiin kyseisenä käyttäjänä.

Nyt kohdassa Account Settings › API on Public Key -kenttä.

Yhteys vaihe vaiheelta

1. Aloita Hermosossa. Asetukset › Yhdistimet › Apple Ads › Connect. Hermoso luo EC P-256 -allekirjoitusavaimen (saman prime256v1-avaimen, jonka Applen kaksi openssl-komentoa olisivat tuottaneet) ja näyttää vain julkisen puoliskon. Kopioi se.
2. Anna julkinen puolisko Applelle. Kirjaudu API-roolin käyttäjänä, avaa Account Settings › API, liitä avain kenttään Public Key ja tallenna.
3. Kopioi kolme tunnusta takaisin. Apple näyttää nyt clientId, teamId ja keyId kentän yläpuolella. Kaikki kolme.
4. Viimeistele Hermosossa. Liitä kolme tunnusta ja tallenna. Hermoso vaihtaa tokenin Applen kanssa ja lukee organisaatiolistasi ennen kuin tallentaa mitään, joten väärin kirjoitettu tunnus epäonnistuu siinä, kun näet vielä, mitä liitit. Et joudu odottamaan tuntia ensimmäiseen raporttiin.
5. Valitse organisaatio, jos tunnuksesi kattavat useamman kuin yhden. Yhteys kiinnittyy valitsemaasi.

Jos jokin menee pieleen

API-sivulla ei ole Public Key -kenttää

Olet kirjautunut Account Adminina tai jollakin neljästä muusta ei-API-roolista. Kutsu itsesi API Account Managerina ja kirjaudu sisään tällä käyttäjällä (katso yllä). Tämä on yleisin yksittäinen syy siihen, miksi Apple Ads -yhteyttä ei koskaan saada tehtyä.

Apple hylkää tunnukset

Kolmen tunnuksen on kuuluttava avaimeen, jonka Apple pitää hallussaan. Kopioi clientId, teamId ja keyId uudelleen suoraan Public Key -kentän yläpuolelta, älä vanhemmasta avaimesta, jonka korvasit. Jos ne silti epäonnistuvat, aloita yhteys Hermosossa uudelleen: se luo uuden avainparin, ja liität uuden julkisen puoliskon Appleen.

Asennusistunto vanheni

Hermoso pitää luomaansa yksityistä avainta tallessa 24 tuntia, jotta ehdit liittää julkisen puoliskon Appleen. Sen jälkeen se on tarkoituksella poistettu. Aloita yhteys uudelleen ja liitä uusi julkinen avain.

Minulla on jo avain, jonka loin openssl-komennolla

Käytä sitä. Liitä olemassa oleva EC P-256 -yksityinen avain yhdistäessäsi Hermoson avaimen sijaan, ja Apple-tilillesi jo tallennettu julkinen avain toimii edelleen. Sen täytyy olla EC P-256 (prime256v1) -avain. Apple ei hyväksy muuta käyrää.

Hallinnoin useita Apple Ads -organisaatioita

Yhdistä kukin omassa Hermoso-profiilissaan. Yhteys kiinnittyy yhteen organisaatioon, ja juuri se estää agenttuurin kampanjan päätymästä väärän asiakkaan tilille.

Mitä Apple Search Ads -yhdistin osaa

Rakentaa: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object.

Lukee: list_apple_ads_campaigns (tila, palvelutila, päivä- ja kokonaisbudjetti, maat, joissa kampanja pyörii, ja Applen oma ilmoittama syy, jos kampanja ei voi pyöriä), list_apple_ads_ad_groups (oletustarjous ja se, onko Applen Search Match päällä), list_apple_ads_keywords (kohdennus ja negatiiviset, match-tyyppi ja tarjous), apple_ads_report (näytöt, napautukset, asennukset, menot, TTR, CPT ja CPA kampanja-, mainosryhmä-, mainos-, avainsana- tai hakusanatasolla) ja list_apple_ads_orgs.

Kaikki on kutsuttavissa Claudesta, Claude Codesta, Codexista, Cursorista, Clinestä, OpenClawsta, Hermesistä tai millä tahansa muulla MCP-asiakkaalla sekä verkkostudiosta. Moottori on sama kummin tahansa. Katso MCP-yleiskatsaus tai mainostyökalujen viite.

Ja lisää: se luo mainoksia ja mainosluovia (create_apple_ads_creative, create_apple_ads_ad), lataa jopa 1 000 avainsanaa yhdellä kutsulla (bulk_apple_ads_keywords) ja lukee Applen omaa dataa: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity ja apple_ads_change_history. Jokainen niistä on kutsuttavissa samasta chatista.

Vie data Apple Search Adsista

Sama yhteys raportoi myös. apple_ads_report hakee kampanja-, mainosryhmä-, mainos-, avainsana- ja hakusanasuorituksen (näytöt, napautukset, asennukset, menot, napautussuhde, napautuskohtainen kustannus CPT ja hankintakohtainen kustannus CPA), yhteenvetona tai tunti-, päivä-, viikko- tai kuukausisarjana, enintään 5 000 riviä sivulla. Raportin lukeminen ei koske menoihin. Se, minne rivit seuraavaksi päätyvät, on sinun päätettävissäsi, ja kolme yleisintä paikkaa ovat alla. Täysi opas: Vie data Apple Search Adsista.

Yhdistä Apple Search Ads Google Sheetsiin

Yhdistä Google Drive Apple Adsin rinnalle (yksi Google-valtuutus kattaa Driven, Sheetsin ja Docsin) ja pyydä agenttia laittamaan raportti taulukkoon. Se kutsuu apple_ads_report, sitten create_sheet uudelle taulukolle tai append_to_sheet lisätäkseen tämän viikon rivit olemassa olevaan. Hermoso käyttää Googlen drive.file-oikeutta, joten se tavoittaa vain tiedostot, jotka se loi tai jotka valitsit. Vaihe vaiheelta: Yhdistä Apple Search Ads Google Sheetsiin.

Vie Apple Search Ads Looker Studioon

Hermosolla ei ole omaa Looker Studio -konnektoria. Looker Studio lukee Google-taulukoita omalla sisäänrakennetulla konnektorillaan, joten taulukko on siltana. Lisää se kerran Google Sheets -datalähteenä, rakenna koontinäkymä, ja jokainen viikottainen lisäys näkyy seuraavassa päivityksessä. Power BI ja Tableau lukevat saman taulukon samalla tavalla. Looker Studio -vaiheet.

Vie Apple Search Ads JSON-muodossa

Raakarivejä varten kutsut työkalua Hermoso-API:n kautta API-avaimella: POST https://app.hermoso.ai/v1/tools/apple_ads_report raportin argumentit JSON-runkona, ja rivit luetaan vastauksen kentästä data.rows. Terminaalista npx -y hermoso call apple_ads_report --json '{...}' --structured tulostaa saman tuloksen JSON-muodossa. Täysi esimerkkipyyntö.

Usein kysytyt kysymykset

Miten yhdistän Apple Search Adsin Claudeen?

Lisää Hermoso Claudeen mukautettuna konnektorina URL-osoitteella https://app.hermoso.ai/mcp ja hyväksy se Hermoso-tilillälläsi, ja yhdistä sitten Apple Ads Hermosossa kohdassa Asetukset › Yhdistimet. Claude voi sen jälkeen raportoida, muokata ja rakentaa Apple Search Ads -kampanjoitasi Hermoson Apple Ads -työkaluilla.

Voiko ChatGPT lukea Apple Search Ads -tietojani?

Kyllä. Lisää https://app.hermoso.ai/mcp ChatGPT:hen kohdassa Plugins › Add › Create MCP App ja yhdistä Apple Ads Hermosossa. ChatGPT voi sen jälkeen hakea näytöt, napautukset, asennukset, menot, TTR:n, CPT:n ja CPA:n kampanjan, mainosryhmän, mainoksen, avainsanan tai hakusanan mukaan ja kirjoittaa rivit Google-taulukkoon.

Onko Apple Search Adsille MCP-palvelinta?

On. Hermoson hostattu MCP-palvelin osoitteessa https://app.hermoso.ai/mcp tarjoaa koko Apple Ads -työkalupaketin Claudelle, ChatGPT:lle, Cursorille, Codexille tai millä tahansa MCP-asiakkaalla: raportoinnin, kampanjat, mainosryhmät, avainsanat ja negatiivit, mainosluovat ja mainokset sekä Applen avainsanaehdotukset. Kaikki, minkä se rakentaa, luodaan pysäytettynä.

Miksi Apple Adsin API-sivulla ei ole Public Key -kenttää?

Koska olet kirjautunut Account Adminina. Apple näyttää kentän vain käyttäjälle, jolla on API-rooli. Admin näkee sen sijaan taulukon “Manage API Access” kolmannen osapuolen palveluntarjoajista, eikä avainkenttää ole missään sivulla. Kutsu itsesi API Account Managerina kohdassa Account Settings › User Management, kirjaudu sisään tällä käyttäjällä, ja kenttä on siinä.

Mitä Apple Ads -roolia tarvitsen?

API Account Manager, jos haluat Hermoson rakentavan kampanjat, mainosryhmät ja avainsanat. Apple kuvaa sitä “luku- ja kirjoitusoikeus kaikkiin kampanjaryhmiin API-hallintaa varten”. API Account Read Only riittää, jos haluat vain raportoinnin. Muut neljä roolia, jotka Apple tarjoaa (Account Admin, Account Finance, Account Read Only ja Limited Access), eivät voi luoda API-tunnuksia lainkaan.

Pitääkö minun ajaa openssl?

Ei. Applen omat ohjeet antavat sinulle kaksi openssl-komentoa; Hermoso luo EC P-256 -avainparin puolestasi ja näyttää vain julkisen puoliskon. Yksityinen puolisko allekirjoittaa pyyntösi, eikä sinun koskaan tarvitse nähdä, liittää tai tallentaa sitä. Jos sinulla on jo avain muusta työkalusta, voit tuoda sen mukanasi.

Maksaako Apple Adsin yhdistäminen mitään tai riskeeraako se menoja?

Ei. Lukeminen on ilmaista, ja jokainen Hermoson luoma kohde luodaan PAUSED-tilassa ilman ohitusta. Kohteen käynnistäminen on ainoa kytkin, joka aktivoi oikeat menot, ja se vaatii nimenomaisen vahvistuksen.

Mitä ovat clientId, teamId ja keyId?

Kolme tunnistetta, jotka Apple näyttää Public Key -kentän yläpuolella, kun olet tallentanut avaimesi. Ne tunnistavat API-käyttäjäsi Applelle; yksityinen avain todistaa, että olet se. Liitä kaikki kolme takaisin Hermosoon, niin yhteys on valmis.

Voiko yksi yhteys kattaa useita Apple Ads -organisaatioita?

Yhteys kiinnittyy yhteen organisaatioon, jonka valitset sen luodessasi. Apple käsittelee orgId:tä vähän kuin kampanjaryhmää, joten yksi kirjautuminen voi kattaa useita. Agenttuuri, jolla on asiakas per organisaatio, yhdistää jokaisen omassa Hermoso-profiilissaan.

Pitääkö avain uusia 180 päivän välein?

Ei. Apple rajoittaa asiakassalasanan 180 päivään, minkä vuoksi Applen omat ohjeet pyytävät merkitsemään kierron kalenteriin. Hermoso pitää yksityistä avainta hallussaan ja luo uuden lyhytikäisen salaisuuden jokaista tokenin vaihtoa varten, joten konfiguraatiotiedostossa ei ole mitään, mikä vanhenisi.

Voinko viedä Apple Search Adsin tiedot Google Sheetsiin tai Looker Studioon?

Kyllä. Yhdistä Google Drive Apple Adsin rinnalle, ja agenttisi kirjoittaa raportin Google-taulukkoon create_sheet- tai append_to_sheet-työkalulla. Hermosossa ei ole omaa Looker Studio -konnektoria; Looker Studio lukee taulukon omalla Google Sheets -konnektorillaan.

Saanko Apple Search Adsin tiedot JSON-muodossa?

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