Ekspor data dari Apple Search Ads

Hermoso terhubung ke Apple Search Ads dan menyajikannya sebagai alat yang bisa dipanggil agen Anda: Claude, ChatGPT, Cursor, Codex, Cline, CLI, atau HTTP biasa. apple_ads_report menarik performa kampanye, grup iklan, iklan, kata kunci dan kata pencarian, dan barisnya kembali sebagai data, bukan sebagai file CSV yang harus Anda bawa ke tempat lain.

Konektor Apple Search Ads

Apple tidak menyediakan alur OAuth untuk API iklannya, jadi menghubungkannya adalah pertukaran kunci, bukan tombol: Hermoso membuat kunci penandatanganan, Anda menempelkan bagian publiknya ke Apple Ads dan menempelkan kembali tiga id. Panduan pengaturan Apple Search Ads membahasnya, termasuk kolom Public Key yang kebanyakan orang tidak temukan. Satu koneksi kemudian melayani aplikasi web, server MCP, CLI dan REST API, jadi ekspor yang sama bisa dijalankan dari Claude, ChatGPT atau Cursor: hubungkan Apple Search Ads ke Claude atau ke ChatGPT sekali, lalu tanyakan.

Pelaporan hanya sebagian dari fungsinya. Koneksi yang sama membangun dan menjalankan akun: kampanye, grup iklan, kata kunci dan negatif, order anggaran, targeting, saran kata kunci dan riwayat perubahan. Halaman kanal Apple Ads mencantumkan setiap alat.

Isi laporannya

Satu panggilan, lima tingkat. apple_ads_report melaporkan di tingkat kampanye, grup iklan, iklan, kata kunci atau kata pencarian, dan setiap baris membawa metrik yang ditampilkan dasbor Apple sendiri: impresi, tap, instal, belanja, tap-through rate, biaya per tap dan biaya per akuisisi. Minta total, atau deret dengan granularitas per jam, harian, mingguan atau bulanan. Baris kembali diurutkan menurut belanja, tertinggi lebih dulu, hingga 5.000 per halaman, dengan baris total keseluruhan jika diminta. Laporan App Store juga bisa menyertakan entitas tanpa penayangan, jadi kata kunci yang dijeda muncul sebagai nol, bukan baris yang hilang.

Dua aturan yang diberlakukan Apple, dan alat ini menjelaskannya alih-alih gagal diam-diam: laporan di bawah tingkat kampanye butuh id kampanye (hanya laporan tingkat kampanye yang bisa mencakup seluruh akun), dan laporan kata pencarian berjalan menurut zona waktu organisasi Anda sendiri, bukan UTC. Iklan di Apple Maps juga tercakup: laporan business-brands datang dari alat yang sama dengan satu parameter diubah.

Hubungkan Apple Search Ads ke Google Sheets

Ini satu-satunya tujuan yang ditulis Hermoso sendiri. Hubungkan Google Drive di samping Apple Ads (satu otorisasi Google mencakup Drive, Sheets dan Docs), lalu tanyakan: "Tampilkan performa Apple Search Ads per kata kunci untuk 30 hari terakhir dan masukkan ke sheet baru bernama Apple Ads." Agen memanggil apple_ads_report, lalu create_sheet, dan mengembalikan tautannya. Minggu depan, permintaan yang sama dengan kata "append" menambahkan baris dengan append_to_sheet alih-alih mulai dari awal.

Hermoso meminta scope drive.file dari Google, yang hanya menjangkau file yang dibuatnya dan yang Anda pilih, bukan seluruh Drive Anda. Panduan lengkapnya, termasuk mengganti tab di tempat dan memformatnya, ada di Hubungkan Apple Search Ads ke Google Sheets.

Ekspor Apple Search Ads ke Looker Studio

Hermoso tidak punya konektor Looker Studio native, dan kami lebih suka mengatakannya daripada memberi kesan ada. Ini tidak perlu: Looker Studio membaca Google Sheets dengan konektor bawaannya sendiri, jadi sheet di atas menjadi jembatannya.

1. Minta agen menulis laporan ke satu tab. Granularitas harian, satu baris per kata kunci per hari, baris header dan kolom tanggal. Minta kolom tanggal diformat sebagai tanggal (format_sheet melakukannya) agar Looker Studio membacanya sebagai tanggal.
2. Tambahkan sheet sebagai sumber data. Di Looker Studio, buat sumber data, pilih Google Sheets, pilih spreadsheet dan tab itu, dan biarkan "Use first row as headers" aktif.
3. Bangun laporannya sekali. Belanja per hari, biaya per akuisisi per kata kunci, instal per kampanye: apa pun yang biasanya Anda bangun ulang di spreadsheet setiap Senin.
4. Terus tambahkan baris. Setiap minggu agen menambahkan baris baru ke tab yang sama, dan dasbor mengambilnya pada refresh data berikutnya. Jaga nama kolom tetap sama antar-eksekusi, karena Looker Studio memetakan field berdasarkan header.

Sheet yang sama juga bisa dipakai untuk Power BI dan Tableau, yang keduanya punya konektor Google Sheets sendiri.

Ekspor Apple Search Ads ke JSON

Jika Anda ingin baris mentah, bukan spreadsheet, ada tiga cara untuk mendapatkannya, semuanya memakai koneksi yang sama.

REST API. Setiap alat Hermoso bisa dipanggil di POST /v1/tools/{name} dengan kunci API yang Anda buat di aplikasi pada tab MCP & CLI. Body permintaan adalah argumen alat, dan field data pada balasan adalah hasil terstrukturnya, dengan baris di 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 terstruktur yang sama sebagai JSON, siap dialihkan ke file atau dialirkan ke skrip lain.

Agen Anda. Di chat mana pun, minta baris sebagai JSON dan Anda mendapatkannya di balasan, sudah dibentuk sesuai permintaan Anda.

Untuk laporan panjang, limit menerima hingga 5.000 baris per halaman dan offset berpindah ke halaman berikutnya; hasMore pada hasil memberi tahu apakah ada halaman lain. Membaca laporan tidak memakai kredit. Referensi API lengkapnya ada di dokumentasi developer.

Tujuan lainnya

"Langsung" berarti Hermoso yang menulisnya. Semua yang lain hanya satu langkah yang dilakukan sendiri oleh alat yang sudah Anda pakai.

• Google Sheets, Google Docs, Google Drive, OneDrive: langsung.
• Looker Studio, Power BI, Tableau: lewat sheet, masing-masing dengan konektor Google Sheets sendiri.
• BigQuery: lewat sheet, atau lewat agen Anda sendiri. BigQuery bisa mengkueri Google Sheet sebagai tabel eksternal. Jika agen Anda berjalan di tempat yang punya klien BigQuery dan kredensial proyek Anda, ia bisa memasukkan baris yang dikembalikan Hermoso langsung ke sebuah tabel.
• Excel: lewat sheet atau file. Unduh sheet sebagai .xlsx, atau minta agen meninggalkan file di Google Drive atau OneDrive.
• PostgreSQL, Redshift, Snowflake atau gudang data apa pun: lewat agen Anda sendiri atau API. Hermoso mengembalikan JSON; apa pun yang memegang kredensial database Anda yang menuliskannya. Hermoso tidak menyimpan kredensial gudang data.

Mengotomatiskan ekspor mingguan

Promptnya adalah otomatisasinya. Sesuatu seperti "Setiap Senin, tarik performa Apple Search Ads minggu lalu per kata kunci untuk setiap kampanye, tambahkan ke sheet Apple Ads, dan beri tahu saya kata kunci mana yang bergerak paling jauh pada biaya per akuisisi" adalah pekerjaan yang lengkap. Jalankan secara berkala dengan penjadwalan yang sudah dimiliki klien Anda (tugas terjadwal di Claude atau ChatGPT, atau cron job yang memanggil CLI atau API Hermoso) dan sheet, serta setiap dasbor yang membacanya, tetap terbarui.

Karena koneksi yang sama juga mengedit akun, laporan dan perbaikannya ada di satu tempat: agen yang melihat biaya per akuisisi sebuah kata kunci melonjak dua kali lipat bisa menjedanya atau menambahkan negatif dalam percakapan yang sama.

Pertanyaan yang sering diajukan

Bagaimana cara mengekspor data dari Apple Search Ads?

Hubungkan Apple Ads ke Hermoso sekali, lalu minta agen Anda laporan yang Anda inginkan, misalnya performa kata kunci minggu lalu. Alat apple_ads_report menariknya dari API pelaporan Apple dan agen menuliskannya ke Google Sheet, memberi Anda JSON, atau keduanya.

Bisakah saya menghubungkan Apple Search Ads ke Google Sheets?

Bisa. Hubungkan Apple Ads dan Google Drive di Hermoso, lalu minta agen memasukkan laporan ke sheet. Ia membuat sheet dengan create_sheet, atau menambahkan baris ke yang sudah ada dengan append_to_sheet, dan bisa mengulanginya setiap minggu.

Bisakah saya mengekspor Apple Search Ads ke Looker Studio?

Bisa, lewat Google Sheets. Hermoso tidak punya konektor Looker Studio native. Agen menulis laporan ke sheet, Anda menambahkan sheet itu sebagai sumber data Google Sheets di Looker Studio sekali, dan setiap penambahan muncul pada refresh berikutnya di dasbor.

Bagaimana cara mengekspor data Apple Search Ads ke JSON?

Panggil POST /v1/tools/apple_ads_report di API Hermoso dengan kunci API dan baca data.rows dari balasan, atau jalankan hermoso call apple_ads_report --json '{...}' --structured dari CLI. Keduanya mengembalikan baris yang sama sebagai JSON.

Apakah ada API pelaporan Apple Search Ads?

Ada, dan Hermoso dibangun di atasnya. apple_ads_report mencakup performa kampanye, grup iklan, iklan, kata kunci dan kata pencarian, dan alat Apple Ads lainnya membangun serta mengelola akunnya.

Bisakah saya mendapatkan laporan kata pencarian Apple Search Ads?

Bisa. Minta tingkat kata pencarian dan sebutkan kampanyenya. Apple hanya menyajikan kata pencarian per kampanye, menurut zona waktu organisasi itu sendiri.

Berapa banyak baris yang bisa dikembalikan satu laporan?

Hingga 5.000 per halaman, diurutkan menurut belanja dari tertinggi ke terendah, dengan penanda yang memberi tahu agen apakah ada halaman lain. Laporan kata kunci mingguan untuk kebanyakan akun muat dalam satu halaman.

Apakah ini mencakup iklan di Apple Maps?

Ya. Laporan untuk kampanye business-brands datang dari alat yang sama dengan tipe objek promosi diatur ke Apple Maps, bukan App Store.

Apakah saya butuh developer untuk mengatur ini?

Tidak. Hubungkan Apple Ads di aplikasi sekali, lalu tanyakan agen Anda dengan bahasa biasa: tarik minggu lalu per kata kunci dan masukkan ke sheet. API dan CLI tersedia jika Anda ingin mengotomatiskannya dengan skrip.