Eksport data daripada Apple Search Ads

Hermoso menyambung ke Apple Search Ads dan mendedahkannya sebagai alat yang boleh dipanggil oleh ejen anda: Claude, ChatGPT, Cursor, Codex, Cline, CLI atau HTTP biasa. apple_ads_report menarik prestasi kempen, kumpulan iklan, iklan, kata kunci dan istilah carian, dan baris dipulangkan sebagai data dan bukan muat turun CSV yang perlu anda bawa ke tempat lain.

Penyambung Apple Search Ads

Apple tidak menerbitkan aliran OAuth untuk API iklannya, jadi menyambung ialah pertukaran kunci dan bukan butang: Hermoso menjana kunci tandatangan, anda tampal bahagian awamnya ke Apple Ads dan tampal tiga id kembali. Panduan persediaan Apple Search Ads menerangkan langkahnya, termasuk medan Public Key yang kebanyakan orang tidak jumpa. Satu sambungan kemudian melayani aplikasi web, pelayan MCP, CLI dan API REST, jadi eksport yang sama boleh dibuat daripada Claude, ChatGPT atau Cursor: sambung Apple Search Ads ke Claude atau ke ChatGPT sekali, kemudian tanya.

Pelaporan hanyalah sebahagian daripadanya. Sambungan yang sama juga membina dan menjalankan akaun: kempen, kumpulan iklan, kata kunci dan negatif, pesanan belanjawan, penyasaran, cadangan kata kunci dan sejarah perubahan. Halaman saluran Apple Ads menyenaraikan setiap alat.

Apa yang ada dalam laporan

Satu panggilan, lima peringkat. apple_ads_report melaporkan pada peringkat kempen, kumpulan iklan, iklan, kata kunci atau istilah carian, dan setiap baris membawa metrik yang dipaparkan oleh dashboard Apple sendiri: tayangan, ketikan, pemasangan, perbelanjaan, kadar klik-lalu, kos setiap ketikan dan kos setiap pemerolehan. Minta jumlah, atau siri pada granulariti setiap jam, harian, mingguan atau bulanan. Baris dipulangkan mengikut perbelanjaan, tertinggi dahulu, sehingga 5,000 setiap halaman, dengan baris jumlah keseluruhan jika diminta. Entiti laporan App Store yang tiada penghantaran juga boleh dimasukkan, jadi kata kunci yang dijeda ditunjukkan sebagai sifar dan bukannya baris yang hilang.

Dua peraturan yang Apple kuatkuasakan, yang diterangkan oleh alat dan bukannya gagal senyap: laporan di bawah peringkat kempen memerlukan id kempen (hanya laporan peringkat kempen boleh meliputi keseluruhan akaun), dan laporan istilah carian berjalan mengikut zon masa organisasi anda sendiri, bukan UTC. Iklan di Apple Maps juga diliputi: laporan business-brands datang daripada alat yang sama dengan satu parameter ditukar.

Sambung Apple Search Ads ke Google Sheets

Ini satu-satunya destinasi yang Hermoso tulis sendiri. Sambungkan Google Drive di sebelah Apple Ads (satu kebenaran Google meliputi Drive, Sheets dan Docs), kemudian tanya: "Tarik prestasi Apple Search Ads mengikut kata kunci untuk 30 hari terakhir dan letakkannya dalam helaian baharu bernama Apple Ads." Ejen memanggil apple_ads_report, kemudian create_sheet, dan memulangkan pautannya. Minggu depan, permintaan yang sama dengan "append" menambah baris dengan append_to_sheet dan bukannya bermula semula.

Hermoso meminta skop drive.file daripada Google, yang hanya mencapai fail yang dicipta olehnya dan fail yang anda pilih, bukan seluruh Drive anda. Panduan lengkap, termasuk menggantikan tab di tempatnya dan memformatnya, ada di Sambung Apple Search Ads ke Google Sheets.

Eksport Apple Search Ads ke Looker Studio

Hermoso tidak mempunyai penyambung Looker Studio asli, dan kami lebih suka berterus terang daripada memberi gambaran sebaliknya. Ia tidak memerlukannya: Looker Studio membaca Google Sheets dengan penyambung terbina dalamnya sendiri, jadi helaian di atas ialah jambatannya.

1. Minta ejen menulis laporan ke dalam satu tab. Granulariti harian, satu baris setiap kata kunci setiap hari, satu baris pengepala dan satu lajur tarikh. Minta lajur tarikh diformatkan sebagai tarikh (format_sheet boleh melakukannya) supaya Looker Studio membacanya sebagai tarikh.
2. Tambah helaian itu sebagai sumber data. Dalam Looker Studio, cipta sumber data, pilih Google Sheets, pilih hamparan dan tab itu, dan biarkan "Use first row as headers" dihidupkan.
3. Bina laporan sekali. Perbelanjaan mengikut hari, kos setiap pemerolehan mengikut kata kunci, pemasangan mengikut kempen: apa sahaja yang anda kalau tidak bina semula dalam hamparan setiap Isnin.
4. Teruskan menambah. Setiap minggu ejen menambah baris baharu ke tab yang sama, dan dashboard mengambilnya pada refresh data seterusnya. Kekalkan nama lajur yang sama antara setiap larian, kerana Looker Studio memadankan medan mengikut pengepala.

Helaian yang sama berfungsi untuk Power BI dan Tableau, yang kedua-duanya mempunyai penyambung Google Sheets sendiri.

Eksport Apple Search Ads ke JSON

Jika anda mahukan baris mentah dan bukannya helaian, ada tiga cara untuk mendapatkannya, semuanya menggunakan sambungan yang sama.

API REST. Setiap alat Hermoso boleh dipanggil di POST /v1/tools/{name} dengan kunci API yang anda cipta dalam aplikasi pada tab MCP & CLI. Badan permintaan ialah argumen alat, dan medan data dalam jawapan ialah hasil berstruktur, dengan baris dalam 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 mencetak hasil berstruktur yang sama sebagai JSON, sedia untuk dialihkan ke fail atau dipaipkan ke skrip lain.

Ejen anda. Dalam mana-mana sembang, minta baris sebagai JSON dan anda mendapatkannya dalam jawapan, sudah dibentuk mengikut cara yang anda minta.

Untuk laporan panjang, limit mengambil sehingga 5,000 baris setiap halaman dan offset bergerak ke halaman seterusnya; hasMore dalam hasil memberitahu sama ada halaman lain wujud. Membaca laporan tidak menggunakan kredit. Rujukan API penuh ada dalam dokumentasi pembangun.

Destinasi lain

"Direct" bermaksud Hermoso yang menulisnya. Yang lain ialah satu langkah yang dilakukan sendiri oleh alat yang sudah anda guna.

• Google Sheets, Google Docs, Google Drive, OneDrive: terus.
• Looker Studio, Power BI, Tableau: melalui helaian, setiap satu dengan penyambung Google Sheets sendiri.
• BigQuery: melalui helaian, atau melalui ejen anda sendiri. BigQuery boleh membuat pertanyaan pada Google Sheet sebagai jadual luaran. Jika ejen anda berjalan di tempat yang ada klien BigQuery dan kelayakan projek anda, ia boleh memasukkan baris yang dipulangkan Hermoso terus ke dalam jadual.
• Excel: melalui helaian atau fail. Muat turun helaian sebagai .xlsx, atau minta ejen meninggalkan fail di Google Drive atau OneDrive.
• PostgreSQL, Redshift, Snowflake atau mana-mana gudang data: melalui ejen anda sendiri atau API. Hermoso memulangkan JSON; apa sahaja yang memegang kelayakan pangkalan data anda yang menulisnya. Hermoso tidak memegang kelayakan gudang data.

Mengautomasikan eksport mingguan

Prompt itu ialah automasinya. Sesuatu seperti "Setiap Isnin, tarik prestasi Apple Search Ads minggu lepas mengikut kata kunci untuk setiap kempen, tambahkannya ke helaian Apple Ads, dan beritahu saya kata kunci mana yang berubah paling banyak pada kos setiap pemerolehan" ialah satu kerja yang lengkap. Jalankannya mengikut jadual dengan penjadualan yang klien anda sedia ada (tugas berjadual dalam Claude atau ChatGPT, atau tugas cron yang memanggil CLI atau API Hermoso), dan helaian serta setiap dashboard yang membacanya kekal terkini.

Oleh kerana sambungan yang sama juga mengedit akaun, laporan dan pembetulan berada di satu tempat: ejen yang mendapati kos setiap pemerolehan sesuatu kata kunci berganda boleh menjedakannya atau menambah negatif dalam perbualan yang sama.

Soalan lazim

Bagaimana saya mengeksport data daripada Apple Search Ads?

Sambungkan Apple Ads ke Hermoso sekali, kemudian minta ejen anda laporan yang anda mahukan, contohnya prestasi kata kunci untuk minggu lepas. Alat apple_ads_report menariknya daripada API pelaporan Apple dan ejen menulisnya ke Google Sheet, memberi anda JSON, atau kedua-duanya.

Bolehkah saya menyambung Apple Search Ads ke Google Sheets?

Boleh. Sambungkan Apple Ads dan Google Drive dalam Hermoso, kemudian minta ejen memasukkan laporan ke dalam helaian. Ia mencipta helaian dengan create_sheet, atau menambah baris ke helaian sedia ada dengan append_to_sheet, dan boleh mengulanginya setiap minggu.

Bolehkah saya mengeksport Apple Search Ads ke Looker Studio?

Boleh, melalui Google Sheets. Hermoso tidak mempunyai penyambung Looker Studio asli. Ejen menulis laporan ke dalam helaian, anda menambah helaian itu sebagai sumber data Google Sheets dalam Looker Studio sekali, dan setiap penambahan muncul pada refresh seterusnya dashboard.

Bagaimana saya mengeksport data Apple Search Ads ke JSON?

Panggil POST /v1/tools/apple_ads_report pada API Hermoso dengan kunci API dan baca data.rows daripada jawapan, atau jalankan hermoso call apple_ads_report --json '{...}' --structured daripada CLI. Kedua-duanya memulangkan baris yang sama sebagai JSON.

Adakah terdapat API pelaporan Apple Search Ads?

Ada, dan Hermoso dibina di atasnya. apple_ads_report meliputi prestasi kempen, kumpulan iklan, iklan, kata kunci dan istilah carian, dan alat Apple Ads yang lain membina serta mengurus akaun.

Bolehkah saya mendapatkan laporan istilah carian Apple Search Ads?

Boleh. Minta peringkat istilah carian dan namakan kempennya. Apple hanya menyajikan istilah carian bagi setiap kempen, dalam zon masa organisasi itu sendiri.

Berapa banyak baris yang boleh dipulangkan oleh satu laporan?

Sehingga 5,000 setiap halaman, disusun mengikut perbelanjaan dari tertinggi ke terendah, dengan bendera yang memberitahu ejen sama ada halaman lain wujud. Laporan kata kunci mingguan untuk kebanyakan akaun muat dalam satu halaman.

Adakah ini meliputi Iklan di Apple Maps?

Ada. Laporan untuk kempen business-brands datang daripada alat yang sama, dengan jenis objek promosi ditetapkan kepada Apple Maps dan bukannya App Store.

Adakah saya perlukan pembangun untuk menyediakannya?

Tidak. Sambungkan Apple Ads sekali dalam aplikasi, kemudian tanya ejen anda dalam bahasa biasa: tarik minggu lepas mengikut kata kunci dan letakkannya dalam helaian. API dan CLI ada jika anda mahu menulis skripnya.