Ikonekta ang Apple Search Ads sa Claude o ChatGPT sa loob ng limang minuto

Ikinokonekta ng Hermoso Apple Search Ads connector ang iyong Apple Ads account sa Claude, ChatGPT, Cursor, CLI o plain HTTP, para mapatakbo ng isang agent ang iyong App Store search ads para sa iyo. Binubuo nito ang kampanya, ang ad group, ang targeting keywords at ang negatives, binabasa muli ang aktuwal na naitala ng Apple, at nagbibigay ng ulat ng performance hanggang sa search term na tinype ng isang tao bago pa mag-install. Lahat ng nilikha nito ay paused, at ang pag-on ng spend ay hiwalay na hakbang na kailangang kumpirmahin nang tahasan. Puwedeng mapunta ang mga ulat sa isang Google Sheet, sa Looker Studio dashboard o sa JSON file, at nakalista sa pahina ng Apple Ads MCP ang lahat ng kayang gawin ng connector.

Mga limang minuto ang pagkonekta. Hindi mo kakailanganing patakbuhin ang openssl, at walang Apple password na dadaan sa Hermoso.

Ikonekta ang Apple Search Ads sa Claude

Para ikonekta ang Apple Search Ads sa Claude, idagdag ang Hermoso sa Claude bilang connector, tapos ikonekta ang iyong Apple Ads account sa loob ng Hermoso nang isang beses. Sa Claude, buksan ang Customize › Connectors › Add custom connector, pangalanan itong Hermoso, i-paste ang https://app.hermoso.ai/mcp at aprubahan ito gamit ang iyong Hermoso account. Walang key na kailangang i-paste sa Claude. Pagkatapos, ikonekta ang Apple Ads sa Hermoso sa ilalim ng Mga Setting › Mga Connector, gamit ang mga hakbang na nasa ibaba ng pahinang ito. Mula roon, matatawag ng Claude ang bawat Apple Ads tool ng Hermoso: humingi ng ulat, pagbabago ng keyword o bagong kampanya gamit ang simpleng salita. Sa Claude Code, dalawang command lang ito: /plugin marketplace add hermoso-ai/hermoso, at pagkatapos /plugin install hermoso@hermoso. Nasa Hermoso sa Claude ang buong hakbang.

Ikonekta ang Apple Search Ads sa ChatGPT

Pareho ang paraan sa ChatGPT. Sa ChatGPT, buksan ang Plugins, tapos Add › Create MCP App, pangalanan itong Hermoso, i-paste ang https://app.hermoso.ai/mcp bilang Server URL, panatilihing OAuth ang Authentication at aprubahan gamit ang iyong Hermoso account. Kung wala ang Create MCP App, i-on muna ang Developer mode sa ilalim ng Settings › Plugins › Developer mode. Kapag nakakonekta na ang Apple Ads sa Hermoso, kaya ng ChatGPT na kunin ang iyong keyword report, isulat ito sa Google Sheet, o gumawa ng draft ng kampanya para mo suriin. Gabay ang Hermoso sa ChatGPT.

Cursor, Codex at anumang iba pang MCP client

Anumang client na nagsasalita ng Model Context Protocol ay maaabot ang parehong mga tool sa parehong address. Binabasa ng Cursor ang https://app.hermoso.ai/mcp mula sa mcp.json nito. Ang Codex naman ay gumagamit ng Hermoso plugin sa pamamagitan ng codex plugin marketplace add hermoso-ai/hermoso, na nagpapatakbo ng parehong mga tool mula sa terminal. Anuman ang client mo, hindi dumadaan ang iyong Apple credentials sa chat. Tumatawag ang agent sa mga tool ng Hermoso, at pinipirmahan ng Hermoso ang bawat request sa Apple gamit ang key na hawak nito. Nakalista sa pahina ng Apple Ads MCP ang bawat tool.

Ano ang itatanong kapag nakakonekta na

• “Kunin ang performance ng Apple Search Ads noong nakaraang linggo kada keyword, at ipakita ang sampung may pinakamataas na cost per acquisition.”
• “Ilagay ang spend, installs at CPA ng nakaraang 30 araw kada kampanya sa bagong Google Sheet na pinangalanang Apple Ads.” (Ikonekta muna ang Google Drive.)
• “Aling mga search term ang nagdala ng installs sa aking US campaign ngayong buwan na hindi ko pa binibid bilang exact keywords?”
• “Idagdag ang ‘budget planner’ at ‘expense tracker’ bilang exact match keywords sa Brand ad group, at ang ‘jobs’ bilang negative.”
• “Anong keywords ang iminumungkahi ng Apple para sa app ko, at gaano kalaki ang impression share ko sa mga binibid ko na?”
• “Gumawa ng paused na kampanya para sa app ko sa UK na may 50 dollar na daily budget, tapos ipakita kung ano ang naitala ng Apple.”

Hindi kailanman ginagalaw ng pagbasa ng ulat ang spend. Ang anumang gawin ng agent ay naka-paused, at ang switch na nagpapagana ng spend ay naghihintay ng tahasan mong kumpirmasyon.

Muna, ang bagay na nakakapigil sa karamihan ng tao

Ganito ang sabi ng sariling tagubilin ng Apple: “Mula sa Ads UI, piliin ang Account Settings › API. I-paste ang key sa Public Key field.”

Hindi umiiral ang field na iyon para sa Account Admin. Mag-sign in bilang admin sa sarili mong account, buksan ang Account Settings › API, at ang lalabas ay isang table na may heading na Manage API Access (listahan ng mga third-party service provider na may iisang aksyong Remove Access) at walang key field kahit saan sa pahina. Eksaktong mukhang kulang na feature ito, kaya humihinto ang mga tao dito at iniisip na hindi available sa kanila ang API.

Available ito. Ang Public Key field ay para sa user na may API role, at hindi sapat ang pagiging admin ng account. Anim na role ang iniaalok ng invite dialog ng Apple, at dalawa lang sa mga ito ang API role:

• API Account Manager: “may read at write na access sa lahat ng campaign group para sa API management”. Ito ang piliin kung gusto mong bumuo ng kampanya ang Hermoso, hindi lang mag-ulat.
• API Account Read Only: “read only na access sa lahat ng campaign group para sa API management”. Sapat para sa pag-uulat, at wala nang iba.

Hindi makakagawa ng API credential ang apat na iba pa (Account Admin, Account Finance, Account Read Only at Limited Access). Kaya ang ayos ay isang imbitasyon na ipapadala mo sa sarili mo:

1. Buksan ang Account Settings › User Management at piliin ang Invite Users.
2. Mag-imbita ng address na kontrolado mo (sarili mo, o isang shared gaya ng ads-api@yourcompany.com para mabuhay ang credential kahit lumipas ang sinumang tao), gamit ang role na API Account Manager.
3. Tanggapin ang imbitasyon mula sa inbox na iyon, tapos mag-sign in sa Apple Ads bilang user na iyon.

Ngayon, may Public Key field na ang Account Settings › API.

Ang koneksyon, hakbang-hakbang

1. Simulan sa Hermoso. Mga Setting › Mga Connector › Apple Ads › Connect. Gumagawa ang Hermoso ng EC P-256 signing key (ang parehong prime256v1 key na mabubuo sana ng dalawang openssl command ng Apple) at ipinapakita sa iyo ang public half lang. Kopyahin ito.
2. Ibigay ang public half sa Apple. Bilang user na may API role, buksan ang Account Settings › API, i-paste ito sa Public Key, at i-Save.
3. Kopyahin pabalik ang tatlong id. Ngayon, ipinapakita ng Apple ang clientId, teamId at keyId sa itaas ng field na iyon. Kopyahin ang lahat ng tatlo.
4. Tapusin sa Hermoso. I-paste ang tatlong id at i-save. Nagpapalitan ng token ang Hermoso sa Apple at binabasa ang listahan ng iyong organisasyon bago mag-imbak ng anuman, kaya kung may mamaling id, babagsak ito roon mismo, habang nakikita mo pa kung ano ang na-paste mo, at hindi sa iyong unang ulat makalipas ang isang oras.
5. Piliin ang organisasyon, kung higit sa isa ang saklaw ng iyong credentials. Nakakabit ang koneksyon sa piniling isa.

Kung may mali

Walang Public Key field sa API page

Naka-sign in ka bilang Account Admin, o sa alinman sa apat na hindi-API role. Imbitahan ang sarili mo bilang API Account Manager at mag-sign in bilang user na iyon (tingnan sa itaas). Ito ang pinakakaraniwang dahilan kung bakit hindi nagagawa ang koneksyon sa Apple Ads.

Tinatanggihan ng Apple ang credentials

Dapat kabilang sa key na hawak ng Apple ang tatlong id. Kopyahin muli ang clientId, teamId at keyId mula mismo sa itaas ng Public Key field, hindi mula sa lumang key na pinalitan mo. Kung bumagsak pa rin, simulan muli ang koneksyon sa Hermoso: gagawa ito ng bagong key pair, at ipapaste mo ang bagong public half sa Apple.

Nag-expire na ang setup session

Hawak ng Hermoso ang nabuong private key nang 24 na oras habang pumupunta ka at ipinapaste ang public half nito sa Apple. Pagkalipas noon, nawawala na ito, sinadya iyon. Simulan muli ang koneksyon at i-paste ang bagong public key.

Nakagawa na ako ng key gamit ang openssl

Gamitin mo na lang iyon. I-paste ang umiiral mong EC P-256 private key kapag nagko-connect ka, sa halip na kunin ang sa Hermoso, at patuloy na gagana ang public key na nasa Apple account mo. Dapat itong EC P-256 (prime256v1) key. Walang ibang curve na tinatanggap ng Apple.

Namamahala ako ng ilang organisasyon sa Apple Ads

Ikonekta ang bawat isa sa sarili nitong Hermoso profile. Nakakabit ang koneksyon sa iisang organisasyon, at iyon ang pumipigil na mapunta sa maling account ng kliyente ang kampanya ng isang agency.

Ang kaya ng Apple Search Ads connector

Gumawa: 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.

Magbasa: list_apple_ads_campaigns (status, serving status, daily at total budget, mga bansang pinapatakbuhan ng kampanya, at ang sarili nang dahilan ng Apple kapag hindi ito maipatakbo), list_apple_ads_ad_groups (default bid, at kung naka-on ang Search Match ng Apple), list_apple_ads_keywords (targeting at negative, kasama ang match type at bid), apple_ads_report (impressions, taps, installs, spend, TTR, CPT at CPA sa antas ng kampanya, ad group, keyword, search term o ad) at list_apple_ads_orgs.

Lahat ng ito ay matatawag mula sa Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes o anumang iba pang MCP client, at mula sa web studio. Iisang engine ito sa lahat ng paraan. Tingnan ang pangkalahatang-ideya ng MCP o ang reference ng ads tool.

At marami pa: gumagawa ito ng mga creative at ad (create_apple_ads_creative, create_apple_ads_ad), naglo-load ng hanggang 1,000 keyword sa isang tawag (bulk_apple_ads_keywords), at binabasa ang sariling datos ng Apple: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity at apple_ads_change_history. Lahat ng ito ay matatawag mula sa parehong chat.

I-export ang datos mula sa Apple Search Ads

Iisang koneksyon ang gamit din sa pag-uulat. Kumukuha ang apple_ads_report ng performance ng kampanya, ad group, ad, keyword at search term (impressions, taps, installs, spend, tap-through rate, cost per tap at cost per acquisition), bilang kabuuan o bilang serye kada oras, araw, linggo o buwan, hanggang 5,000 row kada pahina. Hindi ginagalaw ng pagbasa ng ulat ang spend. Ikaw ang bahala kung saan mapupunta ang mga row pagkatapos, at tatlong pinakakaraniwang lugar ang nasa ibaba. Ang buong gabay ay nasa I-export ang datos mula sa Apple Search Ads.

Ikonekta ang Apple Search Ads sa Google Sheets

Ikonekta ang Google Drive kasama ng Apple Ads (iisang Google authorisation ang sumasaklaw sa Drive, Sheets at Docs), tapos hilingin sa agent mo na ilagay ang ulat sa sheet. Tinatawag nito ang apple_ads_report, tapos ang create_sheet para sa bagong spreadsheet o ang append_to_sheet para idagdag ang mga row ngayong linggo sa umiiral na. Gumagamit ang Hermoso ng scope ng Google na drive.file, kaya ang mga file lang na ginawa nito o ang mga pinili mo ang maaabot nito. Hakbang-hakbang: Ikonekta ang Apple Search Ads sa Google Sheets.

I-export ang Apple Search Ads sa Looker Studio

Walang sariling Looker Studio connector ang Hermoso. Binabasa ng Looker Studio ang Google Sheets gamit ang sarili nitong connector, kaya ang sheet sa itaas ang tulay. Idagdag ito nang isang beses bilang Google Sheets data source, buuin ang dashboard, at lalabas sa susunod na refresh ang bawat lingguhang append. Ganoon din ang Power BI at Tableau sa parehong sheet. Ang mga hakbang sa Looker Studio.

I-export ang Apple Search Ads sa JSON

Kung raw na row ang kailangan mo, tawagin ang tool sa pamamagitan ng Hermoso REST API gamit ang API key: POST https://app.hermoso.ai/v1/tools/apple_ads_report na may mga argumento ng ulat bilang JSON body, at basahin ang mga row mula sa data.rows ng sagot. Mula sa terminal, ang npx -y hermoso call apple_ads_report --json '{...}' --structured ay naglalabas ng parehong resulta bilang JSON. Isang buong halimbawang request.

Mga madalas itanong

Paano ko ikokonekta ang Apple Search Ads sa Claude?

Idagdag ang Hermoso sa Claude bilang custom connector gamit ang URL na https://app.hermoso.ai/mcp at aprubahan gamit ang iyong Hermoso account, tapos ikonekta ang Apple Ads sa Hermoso sa ilalim ng Mga Setting › Mga Connector. Maaari nang mag-ulat, mag-edit at bumuo ng iyong Apple Search Ads campaign ang Claude gamit ang mga Apple Ads tool ng Hermoso.

Mababasa ba ng ChatGPT ang datos ko sa Apple Search Ads?

Oo. Idagdag ang https://app.hermoso.ai/mcp sa ChatGPT sa ilalim ng Plugins › Add › Create MCP App, at ikonekta ang Apple Ads sa Hermoso. Makukuha na ng ChatGPT ang impressions, taps, installs, spend, TTR, CPT at CPA kada kampanya, ad group, ad, keyword o search term, at maisusulat ang mga row sa isang Google Sheet.

May Apple Search Ads MCP server ba?

Mayroon. Inilalantad ng hosted MCP server ng Hermoso sa https://app.hermoso.ai/mcp ang buong Apple Ads toolset sa Claude, ChatGPT, Cursor, Codex o anumang MCP client: pag-uulat, kampanya, ad group, keyword at negatives, creative at ad, at ang mga keyword suggestion ng Apple. Naka-paused ang lahat ng ginagawa nito.

Bakit walang Public Key field sa Apple Ads API page?

Dahil naka-sign in ka bilang Account Admin. Ipinapakita lang ng Apple ang field na iyon sa user na may API role. Ang admin ay nakakakita ng table na “Manage API Access” ng mga third-party service provider sa halip, at walang key field kahit saan sa pahina. Imbitahan ang sarili mo bilang API Account Manager sa ilalim ng Account Settings › User Management, mag-sign in bilang user na iyon, at naroon na ang field.

Aling Apple Ads role ang kailangan ko?

API Account Manager kung gusto mong bumuo ng campaign, ad group at keyword ang Hermoso. Ayon sa Apple, “may read at write na access sa lahat ng campaign group para sa API management”. API Account Read Only ang sapat kung pag-uulat lang ang kailangan mo. Ang apat na iba pang role na iniaalok ng Apple (Account Admin, Account Finance, Account Read Only at Limited Access) ay hindi makakagawa ng API credential.

Kailangan ko bang patakbuhin ang openssl?

Hindi. Dalawang openssl command ang ibinibigay ng sariling tagubilin ng Apple; ang Hermoso na ang gumagawa ng EC P-256 key pair para sa iyo, at ipinapakita lang nito sa iyo ang public half. Ang private half ang pumipirma ng mga request mo, at hindi mo ito makikita, mai-paste o maiimbak. Kung may key ka na galing sa ibang tool, maaari mo iyong dalhin sa halip.

May gastos ba ang pagkonekta ng Apple Ads, o may panganib sa spend?

Wala. Libre ang mga pagbasa, at lahat ng object na ginagawa ng Hermoso ay naka-PAUSED nang walang override. Ang pag-enable ng object ang tanging switch na nagpapagana ng totoong spend, at kumpirmasyon ang kailangan dito.

Ano ang clientId, teamId at keyId?

Ang tatlong identifier na ipinapakita ng Apple sa itaas ng Public Key field kapag na-save mo na ang key. Kinikilala nila ang iyong API user sa Apple; ang private key ang nagpapatunay na ikaw ito. I-paste ang tatlo pabalik sa Hermoso at tapos na ang koneksyon.

Puwede bang isang koneksyon lang ang sumaklaw sa ilang organisasyon ng Apple Ads?

Nakakabit ang isang koneksyon sa iisang organisasyon na pipiliin mo sa paggawa nito. Itinuturing ng Apple ang orgId na parang campaign group, kaya kayang saklawin ng iisang login ang ilan. Ang agency na may isang kliyente kada org ay ikinokonekta ang bawat isa sa sarili nitong Hermoso profile.

Kailangan ko bang i-rotate ang key kada 180 araw?

Hindi. Isandaan at walumpung araw lang ang itinatagal ng client secret sa Apple, kaya nagtatakda ang sarili nilang tagubilin ng paalala sa rotation. Hawak ng Hermoso ang private key at gumagawa ng bagong short-lived na secret sa bawat palitan ng token, kaya walang nakatagong bagay sa config file na mag-e-expire.

Maaari ko bang i-export ang datos ng Apple Search Ads sa Google Sheets o Looker Studio?

Oo. Ikonekta ang Google Drive kasama ng Apple Ads, at isusulat ng agent mo ang ulat sa Google Sheet gamit ang create_sheet o append_to_sheet. Walang sariling Looker Studio connector ang Hermoso; binabasa ng Looker Studio ang sheet na iyon gamit ang sarili nitong Google Sheets connector.

Makukuha ko ba ang datos ng Apple Search Ads bilang JSON?

Oo. Tawagin ang POST /v1/tools/apple_ads_report sa Hermoso API gamit ang API key at basahin ang data.rows, o patakbuhin ang hermoso call apple_ads_report na may --structured mula sa CLI.