I-export ang datos mula sa Apple Search Ads

Kumokonekta ang Hermoso sa Apple Search Ads at inilalantad ito bilang mga tool na matatawag ng agent mo: Claude, ChatGPT, Cursor, Codex, Cline, ang CLI o plain HTTP. Kumukuha ang apple_ads_report ng performance ng kampanya, ad group, ad, keyword at search term, at dumarating ang mga row bilang datos sa halip na CSV download na kailangan mo pang dalhin kung saan-saan.

Ang Apple Search Ads connector

Walang OAuth flow na inilalathala ang Apple para sa ads API nito, kaya hindi isang button ang pagkonekta kundi palitan ng key: gumagawa ang Hermoso ng signing key, ipapaste mo ang public half nito sa Apple Ads, at ibabalik mo ang tatlong id. Tinatalakay ng gabay sa setup ng Apple Search Ads ang buong proseso, kasama ang Public Key field na hindi madalas makita ng karamihan. Iisang koneksyon ang nagsisilbi sa web app, sa MCP server, sa CLI at sa REST API, kaya pareho ang export mula sa Claude, ChatGPT o Cursor: ikonekta ang Apple Search Ads sa Claude o sa ChatGPT nang isang beses, tapos magtanong.

Isa lang ang pag-uulat sa kaya nito. Ang parehong koneksyon ang bumubuo at nagpapatakbo ng account: kampanya, ad group, keyword at negatives, budget order, targeting, keyword suggestion at change history. Nakalista lahat ng tool sa pahina ng Apple Ads channel.

Ano ang laman ng ulat

Isang tawag, limang antas. Nag-uulat ang apple_ads_report sa antas ng kampanya, ad group, ad, keyword o search term, at bawat row ay may mga metric na ipinapakita rin ng sariling dashboard ng Apple: impressions, taps, installs, spend, tap-through rate, cost per tap at cost per acquisition. Maaari kang humingi ng kabuuan, o ng serye sa granularity na kada oras, araw, linggo o buwan. Nakaayos ayon sa spend ang mga row, mula pinakamataas, hanggang 5,000 kada pahina, at may row ng grand totals kapag hiniling. Maaaring isama ng ulat ng App Store ang mga entity na walang delivery, kaya ang nakapausang keyword ay lumalabas bilang zero sa halip na mawala sa listahan.

Dalawang patakarang ipinapatupad ng Apple, na ipinapaliwanag ng tool sa halip na tahimik na bumagsak: kailangan ng ulat sa ibaba ng antas ng kampanya ang campaign id (tanging ulat sa antas ng kampanya ang makakasaklaw sa buong account), at tumatakbo ang search-term report sa time zone ng sarili mong organisasyon, hindi sa UTC. Sakop din ang mga Ad sa Apple Maps: may business-brands report na galing sa parehong tool, pagkapalit lang ng isang parameter.

Ikonekta ang Apple Search Ads sa Google Sheets

Ito lang ang destinasyong direktang isinusulatan ng Hermoso. Ikonekta ang Google Drive kasama ng Apple Ads (iisang Google authorisation ang sumasaklaw sa Drive, Sheets at Docs), tapos magtanong: "Kunin ang performance ng Apple Search Ads kada keyword sa nakaraang 30 araw at ilagay sa bagong sheet na pinangalanang Apple Ads." Tinatawag ng agent ang apple_ads_report, tapos ang create_sheet, at ibinabalik ang link. Sa susunod na linggo, ang parehong request na may "append" ay magdadagdag ng mga row gamit ang append_to_sheet sa halip na magsimula ulit.

Ang scope ng Drive na hinihingi ng Hermoso ay drive.file, na umaabot lamang sa mga file na ginawa nito o pinili mo, hindi sa buong Drive mo. Kumpletong gabay, kasama ang pagpapalit ng tab nang direkta at pag-format nito, ay nasa Ikonekta ang Apple Search Ads sa Google Sheets.

I-export ang Apple Search Ads sa Looker Studio

Walang sariling Looker Studio connector ang Hermoso, at mas gusto naming sabihin ito kaysa magpahiwatig ng meron. Hindi ito kailangan: binabasa ng Looker Studio ang Google Sheets gamit ang sarili nitong built-in connector, kaya ang sheet sa itaas ang tulay.

1. Ipasulat sa agent ang ulat sa isang tab. Araw-araw na granularity, isang row kada keyword kada araw, may header row at date column. Hilingin na i-format bilang date ang date column (ginagawa ito ng format_sheet) para mabasa ito ng Looker Studio bilang petsa.
2. Idagdag ang sheet bilang data source. Sa Looker Studio, gumawa ng data source, piliin ang Google Sheets, piliin ang spreadsheet at ang tab na iyon, at panatilihing naka-on ang "Use first row as headers".
3. Buuin ang ulat nang isang beses. Spend kada araw, cost per acquisition kada keyword, installs kada kampanya: ang mga bagay na kung hindi ay muli mong bubuuin sa spreadsheet tuwing Lunes.
4. Patuloy na mag-append. Bawat linggo, idinadagdag ng agent ang mga bagong row sa parehong tab, at kukunin ito ng dashboard sa susunod nitong data refresh. Panatilihing pareho ang mga pangalan ng column sa bawat takbo, dahil minamapa ng Looker Studio ang mga field ayon sa header.

Gumagana rin ang parehong sheet para sa Power BI at Tableau, na pareho ay may sariling Google Sheets connector.

I-export ang Apple Search Ads sa JSON

Kung raw na row ang gusto mo sa halip na spreadsheet, tatlong paraan ang mayroon, lahat gamit ang parehong koneksyon.

Ang REST API. Matatawag ang bawat tool ng Hermoso sa POST /v1/tools/{name} gamit ang API key na ginawa mo sa app sa tab na MCP & CLI. Ang request body ay ang mga argumento ng tool, at ang field na data ng sagot ang structured na resulta, na may mga row sa 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

Ang CLI. Ang npx -y hermoso call apple_ads_report --json '{...}' --structured ay naglalabas ng parehong structured na resulta bilang JSON, handa nang i-redirect sa file o ipasa sa ibang script.

Ang agent mo. Sa anumang chat, humingi ng mga row bilang JSON at ibibigay ang mga ito sa sagot, nakaayos na ayon sa hiniling mo.

Para sa mahahabang ulat, umaabot ang limit sa 5,000 row kada pahina at ang offset ang lumilipat sa susunod; sinasabi ng hasMore ng resulta kung may kasunod pang pahina. Hindi gumagastos ng credit ang pagbasa ng ulat. Nasa developer docs ang buong API reference.

Iba pang destinasyon

Ang "direct" ay ibig sabihin, ang Hermoso mismo ang sumusulat. Ang iba ay isang hakbang na ginagawa na ng tool na gamit mo.

• Google Sheets, Google Docs, Google Drive, OneDrive: direct.
• Looker Studio, Power BI, Tableau: sa pamamagitan ng sheet, bawat isa gamit ang sarili nitong Google Sheets connector.
• BigQuery: sa pamamagitan ng sheet, o sa pamamagitan ng sarili mong agent. Kayang i-query ng BigQuery ang Google Sheet bilang external table. Kung tumatakbo ang agent mo sa lugar na may BigQuery client at sarili mong project credentials, maaari nitong ipasok nang diretso sa table ang mga row na ibinabalik ng Hermoso.
• Excel: sa pamamagitan ng sheet o file. I-download ang sheet bilang .xlsx, o ipaiwan ng agent ang file sa Google Drive o OneDrive.
• PostgreSQL, Redshift, Snowflake o anumang warehouse: sa pamamagitan ng sarili mong agent o ng API. JSON ang ibinabalik ng Hermoso; ang may hawak ng database credentials mo ang sumusulat nito. Walang hawak na warehouse credentials ang Hermoso.

Pag-automate ng lingguhang export

Ang prompt mismo ang automation. Ganito ang isang halimbawa: "Tuwing Lunes, kunin ang performance ng Apple Search Ads noong nakaraang linggo kada keyword para sa bawat kampanya, idagdag sa Apple Ads sheet, at sabihin sa akin kung aling mga keyword ang pinakagumalaw sa cost per acquisition", at kumpleto na itong trabaho. Patakbuhin ito sa iskedyul gamit ang scheduling na mayroon na ang iyong client (scheduled tasks sa Claude o ChatGPT, o cron job na tumatawag sa Hermoso CLI o API), at mananatiling updated ang sheet at bawat dashboard na bumabasa rito.

Dahil ang parehong koneksyon ang nag-e-edit din ng account, nasa iisang lugar ang ulat at ang ayos: ang agent na makakitang dumoble ang cost per acquisition ng isang keyword ay maaaring i-pause ito o magdagdag ng negative sa mismong usapang iyon.

Mga madalas itanong

Paano ako mag-e-export ng datos mula sa Apple Search Ads?

Ikonekta ang Apple Ads sa Hermoso nang isang beses, tapos hingin sa agent mo ang ulat na gusto mo, halimbawa performance ng keyword noong nakaraang linggo. Kinukuha ito ng apple_ads_report tool mula sa reporting API ng Apple, at isinusulat ito ng agent sa Google Sheet, ibinibigay sa iyo bilang JSON, o pareho.

Maaari ko bang ikonekta ang Apple Search Ads sa Google Sheets?

Oo. Ikonekta ang Apple Ads at Google Drive sa Hermoso, tapos hilingin sa agent na ilagay ang ulat sa sheet. Gagawin nito ang sheet gamit ang create_sheet, o magdadagdag ng mga row sa umiiral na gamit ang append_to_sheet, at puwede itong ulitin tuwing linggo.

Maaari ko bang i-export ang Apple Search Ads sa Looker Studio?

Oo, sa pamamagitan ng Google Sheets. Walang sariling Looker Studio connector ang Hermoso. Isinusulat ng agent ang ulat sa sheet, idinadagdag mo ang sheet na iyon bilang Google Sheets data source sa Looker Studio nang isang beses, at lalabas sa susunod na refresh ng dashboard ang bawat append.

Paano ko ie-export ang datos ng Apple Search Ads bilang JSON?

Tawagin ang POST /v1/tools/apple_ads_report sa Hermoso API gamit ang API key at basahin ang data.rows mula sa sagot, o patakbuhin ang hermoso call apple_ads_report --json '{...}' --structured mula sa CLI. Pareho ang mga row na ibinabalik ng dalawa bilang JSON.

May reporting API ba ang Apple Search Ads?

Mayroon, at ito ang pinagbatayan ng Hermoso. Sakop ng apple_ads_report ang performance ng kampanya, ad group, ad, keyword at search term, at ginagawa at pinamamahalaan ng iba pang Apple Ads tool ang account.

Makakakuha ba ako ng search-term report ng Apple Search Ads?

Oo. Hilingin ang antas ng search term at pangalanan ang kampanya. Naghahain lang ang Apple ng search term kada kampanya, sa time zone ng organisasyon.

Ilang row ang maibabalik ng isang ulat?

Hanggang 5,000 kada pahina, nakaayos ayon sa spend mula pinakamataas hanggang pinakamababa, na may flag na nagsasabi sa agent kung may kasunod pang pahina. Kasya na sa isang pahina ang lingguhang ulat ng keyword para sa karamihan ng account.

Sakop ba nito ang Ads sa Apple Maps?

Oo. Ang ulat para sa business-brands campaigns ay galing sa parehong tool, na may promoted object type na nakatakda sa Apple Maps sa halip na App Store.

Kailangan ko ba ng developer para i-set up ito?

Hindi. Ikonekta ang Apple Ads sa app nang isang beses, tapos magtanong sa agent mo sa simpleng salita: kunin ang nakaraang linggo kada keyword at ilagay sa sheet. Nandiyan ang API at CLI kung gusto mong mag-script.