Hubungkan Apple Search Ads ke Claude atau ChatGPT dalam lima menit

Konektor Apple Search Ads Hermoso menghubungkan akun Apple Ads Anda ke Claude, ChatGPT, Cursor, CLI atau HTTP biasa, sehingga agen dapat menjalankan iklan pencarian App Store untuk Anda. Agen membuat kampanye, grup iklan, kata kunci targeting dan kata kunci negatif, membaca kembali apa yang benar-benar disimpan Apple, dan melaporkan performa sampai ke kata pencarian yang diketik seseorang sebelum memasang aplikasi. Semua yang dibuat dibuat dalam status paused, dan mengaktifkan belanja iklan adalah langkah terpisah yang harus dikonfirmasi secara eksplisit. Laporan bisa masuk ke Google Sheet, dashboard Looker Studio, atau file JSON, dan halaman MCP Apple Ads mencantumkan semua yang bisa dilakukan konektor ini.

Menghubungkan butuh sekitar lima menit. Anda tidak perlu menjalankan openssl, dan kata sandi Apple tidak pernah dikirim ke Hermoso.

Hubungkan Apple Search Ads ke Claude

Untuk menghubungkan Apple Search Ads ke Claude, tambahkan Hermoso ke Claude sebagai konektor, lalu hubungkan akun Apple Ads Anda di dalam Hermoso sekali saja. Di Claude, buka Customize › Connectors › Add custom connector, beri nama Hermoso, tempel https://app.hermoso.ai/mcp dan setujui dengan akun Hermoso Anda. Tidak ada kunci yang perlu ditempel ke Claude. Lalu hubungkan Apple Ads di Hermoso melalui Pengaturan › Konektor, mengikuti langkah di bawah halaman ini. Sejak saat itu Claude bisa memanggil setiap alat Apple Ads yang dimiliki Hermoso: minta laporan, perubahan kata kunci, atau kampanye baru dengan kata-kata biasa. Di Claude Code caranya dua perintah: /plugin marketplace add hermoso-ai/hermoso, lalu /plugin install hermoso@hermoso. Hermoso di Claude memuat langkah lengkapnya.

Hubungkan Apple Search Ads ke ChatGPT

ChatGPT caranya sama. Di ChatGPT buka Plugins, lalu Add › Create MCP App, beri nama Hermoso, tempel https://app.hermoso.ai/mcp sebagai Server URL, biarkan Authentication di OAuth dan setujui dengan akun Hermoso Anda. Jika Create MCP App tidak ada, nyalakan Developer mode sekali lewat Settings › Plugins › Developer mode. Dengan Apple Ads terhubung di Hermoso, ChatGPT bisa mengambil laporan kata kunci Anda, menuliskannya ke Google Sheet, atau menyusun kampanye untuk Anda periksa. Hermoso di ChatGPT membahas langkahnya.

Cursor, Codex dan klien MCP lainnya

Klien apa pun yang mendukung Model Context Protocol mencapai alat yang sama di alamat yang sama. Cursor membaca https://app.hermoso.ai/mcp dari mcp.json-nya; Codex memakai plugin Hermoso dengan codex plugin marketplace add hermoso-ai/hermoso, yang menjalankan alat yang sama dari terminal. Apa pun klien yang Anda pakai, kredensial Apple Anda tidak pernah lewat di dalam chat. Agen memanggil alat Hermoso, dan Hermoso menandatangani setiap permintaan ke Apple dengan kunci yang ia simpan. Halaman MCP Apple Ads mencantumkan setiap alat.

Apa yang ditanyakan setelah terhubung

• “Tampilkan performa Apple Search Ads minggu lalu per kata kunci dan perlihatkan sepuluh dengan biaya per akuisisi tertinggi.”
• “Masukkan belanja, instal, dan CPA 30 hari terakhir per kampanye ke Google Sheet baru bernama Apple Ads.” (Hubungkan Google Drive dulu.)
• “Kata pencarian mana yang mendatangkan instal di kampanye US saya bulan ini yang belum saya tawar sebagai kata kunci exact?”
• “Tambahkan ‘budget planner’ dan ‘expense tracker’ sebagai kata kunci exact match di grup iklan Brand, dan ‘jobs’ sebagai negatif.”
• “Kata kunci apa yang disarankan Apple untuk aplikasi saya, dan berapa persen impresi yang saya dapat dari kata kunci yang sudah saya tawar?”
• “Buat kampanye paused untuk aplikasi saya di Inggris dengan anggaran harian 50 dolar, lalu perlihatkan apa yang disimpan Apple.”

Membaca laporan tidak pernah menyentuh belanja. Apa pun yang dibuat agen akan dibuat dalam status paused, dan sakelar yang menyalakan belanja menunggu konfirmasi eksplisit dari Anda.

Pertama, hal yang membuat kebanyakan orang berhenti

Instruksi Apple sendiri berbunyi: “Dari Ads UI, pilih Account Settings › API. Tempel kunci ke kolom Public Key.”

Kolom itu tidak ada untuk Account Admin. Masuk sebagai admin di akun Anda sendiri, buka Account Settings › API, dan yang muncul adalah tabel berjudul Manage API Access (daftar penyedia layanan pihak ketiga dengan satu aksi Remove Access) dan tidak ada kolom kunci di mana pun di halaman itu. Ini terlihat seperti fitur yang tidak tersedia, sehingga banyak orang berhenti di sini dan menyimpulkan API tidak tersedia untuk mereka.

Itu tersedia. Kolom Public Key hanya ada untuk pengguna yang memegang peran API, dan menjadi admin akun bukan salah satunya. Dialog undangan Apple menawarkan enam peran, dan hanya dua di antaranya peran API:

• API Account Manager: “akses baca dan tulis ke semua grup kampanye untuk pengelolaan API”. Ini yang dipilih jika Anda ingin Hermoso membangun kampanye, bukan sekadar membuat laporan.
• API Account Read Only: “akses hanya baca ke semua grup kampanye untuk pengelolaan API”. Cukup untuk pelaporan, dan tidak untuk yang lain.

Empat peran lainnya (Account Admin, Account Finance, Account Read Only dan Limited Access) sama sekali tidak bisa membuat kredensial API. Jadi solusinya adalah undangan yang Anda kirim ke diri sendiri:

1. Buka Account Settings › User Management dan pilih Invite Users.
2. Undang alamat yang Anda kendalikan (alamat pribadi Anda, atau alamat bersama seperti ads-api@yourcompany.com agar kredensialnya bertahan meski satu orang pergi) dengan peran API Account Manager.
3. Terima undangan dari kotak masuk itu, lalu masuk ke Apple Ads sebagai pengguna tersebut.

Sekarang Account Settings › API memiliki kolom Public Key.

Hubungkan langkah demi langkah

1. Mulai di Hermoso. Pengaturan › Konektor › Apple Ads › Connect. Hermoso membuat kunci penandatanganan EC P-256 (kunci prime256v1 yang sama dengan yang dihasilkan dua perintah openssl Apple) dan hanya menampilkan bagian publik. Salin.
2. Berikan bagian publik ke Apple. Sebagai pengguna dengan peran API, buka Account Settings › API, tempel ke Public Key, lalu Save.
3. Salin kembali ketiga id. Apple sekarang mencetak clientId, teamId dan keyId di atas kolom itu. Ketiganya.
4. Selesaikan di Hermoso. Tempel ketiga id lalu simpan. Hermoso menukar token dengan Apple dan membaca daftar organisasi Anda sebelum menyimpan apa pun, jadi id yang salah ketik gagal di situ, selagi Anda masih bisa melihat apa yang Anda tempel, bukan pada laporan pertama satu jam kemudian.
5. Pilih organisasi, jika kredensial Anda mencakup lebih dari satu. Koneksi dipatok ke yang Anda pilih.

Jika ada yang salah

Tidak ada kolom Public Key di halaman API

Anda masuk sebagai Account Admin, atau sebagai salah satu dari empat peran non-API. Undang diri Anda sendiri sebagai API Account Manager dan masuk sebagai pengguna itu (lihat di atas). Ini alasan paling umum mengapa koneksi Apple Ads tidak pernah terbuat.

Apple menolak kredensial

Ketiga id harus milik kunci yang dipegang Apple. Salin ulang clientId, teamId dan keyId dari tepat di atas kolom Public Key, bukan dari kunci lama yang sudah Anda ganti. Jika masih gagal, mulai ulang koneksi di Hermoso: itu membuat pasangan kunci baru, dan Anda menempelkan bagian publik yang baru ke Apple.

Sesi pengaturan sudah kedaluwarsa

Hermoso menyimpan kunci privat yang dibuat selama 24 jam saat Anda pergi menempelkan bagian publiknya ke Apple. Lewat dari itu kunci tersebut hilang, dan memang disengaja. Mulai ulang koneksi dan tempel kunci publik yang baru.

Saya sudah membuat kunci dengan openssl

Kalau begitu pakai saja. Tempel kunci privat EC P-256 yang sudah ada saat menghubungkan, alih-alih milik Hermoso, dan kunci publik yang sudah ada di akun Apple Anda tetap berfungsi. Harus berupa kunci EC P-256 (prime256v1). Apple tidak menerima kurva lain.

Saya mengelola beberapa organisasi Apple Ads

Hubungkan masing-masing di profil Hermoso sendiri. Satu koneksi dipatok ke satu organisasi, dan itulah yang mencegah kampanye agensi mendarat di akun klien yang salah.

Apa yang bisa dilakukan konektor Apple Search Ads

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

Baca: list_apple_ads_campaigns (status, status penayangan, anggaran harian dan total, negara tempat kampanye berjalan, dan alasan dari Apple sendiri ketika sebuah kampanye tidak bisa berjalan), list_apple_ads_ad_groups (bid default, dan apakah Search Match Apple aktif), list_apple_ads_keywords (targeting dan negatif, dengan tipe pencocokan dan bid), apple_ads_report (impresi, tap, instal, belanja, TTR, CPT dan CPA di tingkat kampanye, grup iklan, kata kunci, kata pencarian atau iklan) dan list_apple_ads_orgs.

Semua ini bisa dipanggil dari Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes atau klien MCP lainnya, serta dari studio web. Mesinnya sama di semua tempat. Lihat ikhtisar MCP atau referensi alat iklan.

Dan lebih banyak: ia membuat kreatif dan iklan (create_apple_ads_creative, create_apple_ads_ad), memuat hingga 1.000 kata kunci dalam satu panggilan (bulk_apple_ads_keywords), dan membaca data Apple sendiri: apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity dan apple_ads_change_history. Semuanya bisa dipanggil dari chat yang sama.

Ekspor data dari Apple Search Ads

Koneksi yang sama juga melaporkan data. apple_ads_report menarik performa kampanye, grup iklan, iklan, kata kunci dan kata pencarian (impresi, tap, instal, belanja, tap-through rate, biaya per tap dan biaya per akuisisi), sebagai total atau sebagai deret per jam, harian, mingguan atau bulanan, hingga 5.000 baris per halaman. Membaca laporan tidak pernah menyentuh belanja. Ke mana baris itu dikirim selanjutnya terserah Anda, dan tiga tempat yang paling umum ada di bawah. Panduan lengkapnya ada di Ekspor data dari Apple Search Ads.

Hubungkan Apple Search Ads ke Google Sheets

Hubungkan Google Drive di samping Apple Ads (satu otorisasi Google mencakup Drive, Sheets dan Docs), lalu minta agen Anda memasukkan laporan ke sheet. Agen memanggil apple_ads_report, lalu create_sheet untuk spreadsheet baru atau append_to_sheet untuk menambahkan baris minggu ini ke yang sudah ada. Hermoso memakai scope drive.file dari Google, jadi ia hanya menjangkau file yang dibuatnya atau yang Anda pilih. Langkah demi langkah: Hubungkan Apple Search Ads ke Google Sheets.

Ekspor Apple Search Ads ke Looker Studio

Hermoso tidak punya konektor Looker Studio native. Looker Studio membaca Google Sheets dengan konektornya sendiri, jadi sheet di atas menjadi jembatannya: tambahkan sekali sebagai sumber data Google Sheets, bangun dashboard, dan setiap penambahan mingguan akan muncul saat refresh berikutnya. Power BI dan Tableau membaca sheet yang sama dengan cara serupa. Langkah Looker Studio.

Ekspor Apple Search Ads ke JSON

Untuk baris mentah, panggil alat itu lewat REST API Hermoso dengan kunci API: POST https://app.hermoso.ai/v1/tools/apple_ads_report dengan argumen laporan sebagai body JSON, lalu baca baris dari data.rows di balasan. Dari terminal, npx -y hermoso call apple_ads_report --json '{...}' --structured mencetak hasil yang sama sebagai JSON. Contoh permintaan lengkap.

Pertanyaan yang sering diajukan

Bagaimana cara menghubungkan Apple Search Ads ke Claude?

Tambahkan Hermoso ke Claude sebagai konektor kustom dengan URL https://app.hermoso.ai/mcp dan setujui dengan akun Hermoso Anda, lalu hubungkan Apple Ads di Hermoso melalui Pengaturan › Konektor. Claude kemudian bisa membuat laporan, mengedit, dan membangun kampanye Apple Search Ads Anda lewat alat Apple Ads Hermoso.

Bisakah ChatGPT membaca data Apple Search Ads saya?

Bisa. Tambahkan https://app.hermoso.ai/mcp di ChatGPT lewat Plugins › Add › Create MCP App, lalu hubungkan Apple Ads di Hermoso. ChatGPT kemudian bisa mengambil impresi, tap, instal, belanja, TTR, CPT dan CPA per kampanye, grup iklan, iklan, kata kunci atau kata pencarian, dan menulis barisnya ke Google Sheet.

Apakah ada server MCP Apple Search Ads?

Ada. Server MCP Hermoso yang di-host di https://app.hermoso.ai/mcp menyediakan seluruh toolset Apple Ads untuk Claude, ChatGPT, Cursor, Codex atau klien MCP apa pun: pelaporan, kampanye, grup iklan, kata kunci dan negatif, kreatif dan iklan, serta saran kata kunci Apple. Semua yang dibuatnya dibuat dalam status paused.

Mengapa tidak ada kolom Public Key di halaman API Apple Ads?

Karena Anda masuk sebagai Account Admin. Apple hanya menampilkan kolom itu untuk pengguna yang memegang peran API. Admin melihat tabel “Manage API Access” berisi penyedia layanan pihak ketiga, tanpa kolom kunci di mana pun di halaman. Undang diri Anda sebagai API Account Manager di Account Settings › User Management, masuk sebagai pengguna itu, dan kolomnya akan muncul.

Peran Apple Ads apa yang saya butuhkan?

API Account Manager jika Anda ingin Hermoso membangun kampanye, grup iklan, dan kata kunci. Apple menggambarkannya sebagai “akses baca dan tulis ke semua grup kampanye untuk pengelolaan API”. API Account Read Only cukup jika Anda hanya ingin pelaporan. Empat peran lain yang ditawarkan Apple (Account Admin, Account Finance, Account Read Only dan Limited Access) sama sekali tidak bisa membuat kredensial API.

Apakah saya harus menjalankan openssl?

Tidak. Instruksi Apple memberi dua perintah openssl; Hermoso membuat pasangan kunci EC P-256 untuk Anda dan hanya menampilkan bagian publiknya. Bagian privat itulah yang menandatangani permintaan Anda, dan Anda tidak pernah melihat, menempel, atau menyimpannya. Jika Anda sudah punya kunci dari alat lain, Anda bisa membawanya.

Apakah menghubungkan Apple Ads berbiaya atau berisiko menghabiskan belanja?

Tidak. Pembacaan bebas dipanggil, dan setiap objek yang dibuat Hermoso dibuat dalam status PAUSED tanpa pengecualian. Mengaktifkan objek adalah satu-satunya sakelar yang menyalakan belanja sungguhan, dan itu butuh konfirmasi eksplisit.

Apa itu clientId, teamId dan keyId?

Tiga pengenal yang dicetak Apple di atas kolom Public Key setelah Anda menyimpan kunci. Pengenal itu mengidentifikasi pengguna API Anda ke Apple; kunci privat membuktikan bahwa itu Anda. Tempel ketiganya kembali ke Hermoso dan koneksinya selesai.

Bisakah satu koneksi mencakup beberapa organisasi Apple Ads?

Satu koneksi dipatok ke satu organisasi yang Anda pilih saat membuatnya. Apple memperlakukan orgId kurang lebih seperti campaign group, jadi satu login bisa mencakup beberapa organisasi. Agensi dengan satu klien per org menghubungkan masing-masing di profil Hermoso sendiri.

Apakah saya harus merotasi kunci setiap 180 hari?

Tidak. Apple membatasi client secret hingga 180 hari, itulah sebabnya instruksi Apple meminta Anda mencatat jadwal rotasi. Hermoso menyimpan kunci privat dan membuat secret baru yang berumur pendek untuk setiap pertukaran token, jadi tidak ada yang tersimpan di file konfigurasi untuk kedaluwarsa.

Bisakah saya mengekspor data Apple Search Ads ke Google Sheets atau Looker Studio?

Bisa. Hubungkan Google Drive di samping Apple Ads, dan agen Anda menulis laporan ke Google Sheet dengan create_sheet atau append_to_sheet. Hermoso tidak punya konektor Looker Studio native; Looker Studio membaca sheet itu dengan konektor Google Sheets-nya sendiri.

Bisakah saya mendapatkan data Apple Search Ads sebagai JSON?

Bisa. Panggil POST /v1/tools/apple_ads_report di API Hermoso dengan kunci API dan baca data.rows, atau jalankan hermoso call apple_ads_report dengan --structured dari CLI.