Google Ads MCP: bangun seluruh struktur dari agen Anda, secara atomik

Apakah ada server MCP Google Ads? Ada. Hermoso adalah server MCP Google Ads yang di-hosting. Tambahkan https://app.hermoso.ai/mcp ke Claude, ChatGPT, atau Cursor, lalu hubungkan akun Google Ads Anda sekali saja. Asisten Anda kemudian bisa membuat kampanye search, display, dan Performance Max, mencari ide kata kunci, mengatur anggaran, tawaran, dan targeting, serta menjalankan laporan. Menyalakan kampanye selalu memerlukan konfirmasi eksplisit dari Anda.

Google Ads itu berbentuk pohon, dan di pohon inilah pembuatan kampanye lewat skrip biasanya salah. Anda membuat anggaran, lalu kampanye, lalu grup iklan, lalu iklan. Jika iklan ditolak di langkah keempat, Anda tertinggal dengan tiga objek yatim dan anggaran yang tidak Anda inginkan. Membersihkannya secara manual adalah alasan utama orang menyerah mengotomatisasi Google Ads.

Server MCP Hermoso membangun seluruh pohon dalam satu operasi atomik, dengan memakai id resource sementara agar anak-anak bisa merujuk ke induk yang belum ada. Entah kampanye, grup iklan, iklan, dan kata kuncinya semuanya tercipta, atau tidak satu pun tercipta. Jika sebuah iklan ditolak, anggarannya pun tidak pernah dibuat.

Pasang sekali saja: di Claude.ai atau Claude Desktop, tempelkan https://app.hermoso.ai/mcp di Settings → Connectors dan setujui dengan akun Hermoso Anda. Di agen pengodean, cukup satu perintah: /plugin marketplace add hermoso-ai/hermoso lalu /plugin install hermoso@hermoso di Claude Code, codex plugin marketplace add hermoso-ai/hermoso lalu codex plugin add hermoso@hermoso di Codex, atau npx skills add hermoso-ai/hermoso -a cursor di Cursor (sebutkan nama agen Anda setelah -a), lalu masuk sekali dengan npx -y hermoso auth login. Panduan lengkap ada di halaman MCP & CLI.

Alat Google Ads

Bangun. create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, create_google_ads_performance_max_campaign, upload_google_ads_asset, add_google_ads_assets untuk sitelink, callout, dan cuplikan terstruktur.

Atur. set_google_ads_budget, set_google_ads_bidding (enam strategi), set_google_ads_targeting (geo dan bahasa), find_google_ads_locations, set_google_ads_networks (jaringan mitra Search dan Display aktif atau nonaktif), create_google_ads_conversion_action, dan list_google_ads_conversion_actions.

Riset. google_ads_keyword_ideas menghadirkan Keyword Planner ke dalam percakapan: volume pencarian bulanan yang nyata, tingkat persaingan, dan kisaran tawaran teratas, dimulai dari sekumpulan kata kunci, halaman arahan, atau seluruh situs.

Baca dan ubah. list_google_ads_campaigns, google_ads_report untuk GAQL apa pun, google_ads_change_history untuk melihat apa yang berubah di akun dan kapan, delete_google_ads_object untuk menghapus satu objek, dan set_google_ads_status, satu-satunya sakelar yang diberi gerbang konfirmasi dan yang memulai pengeluaran sungguhan.

create_google_ads_campaign juga menerima mode dry-run, sehingga agen bisa memvalidasi seluruh pohon terhadap API langsung tanpa membuat apa pun. Itu pilihan baik secara default saat agen mengusulkan rencana untuk Anda setujui.

Apa yang bisa dilakukan agen Anda dengan MCP Google Ads

Setiap baris adalah alat sungguhan di server. Tanyakan dengan bahasa biasa, dan agen memilih alat mana yang dijalankan.

Contoh perintah

Tempelkan salah satu dari ini ke Claude, ChatGPT, atau Cursor setelah Hermoso terhubung.

• “Cari 30 kata kunci untuk aplikasi manajemen proyek kami dengan volume pencarian di atas 1.000 per bulan di AS, lalu kelompokkan menurut maksud.”
  google_ads_keyword_ideas mengembalikan volume, persaingan, dan kisaran tawaran dari Keyword Planner, lalu agen mengelompokkannya.
• “Buat kampanye Search dalam keadaan jeda untuk kata kunci tersebut: $50 per hari, AS dan Kanada, bahasa Inggris, maksimalkan konversi.”
  create_google_ads_campaign membangun anggaran, kampanye, grup iklan, iklan, dan kata kunci dalam satu operasi atomik, dijeda, lalu membacanya kembali.
• “Siapkan kampanye Performance Max untuk katalog Shopify kami memakai feed Merchant Center kami.”
  list_merchant_accounts memilih toko, lalu create_google_ads_performance_max_campaign membangunnya dalam keadaan jeda dengan feed terlampir.
• “Istilah pencarian mana yang menghabiskan uang bulan lalu tanpa konversi? Tambahkan sepuluh yang terburuk sebagai negatif.”
  google_ads_report mengambil laporan istilah pencarian, lalu add_google_ads_keywords menambahkan kata kunci negatif.
• “Tambahkan empat sitelink ke kampanye merek kami: harga, demo, studi kasus, dan kontak.”
  add_google_ads_assets membuat sitelink dan melampirkannya ke kampanye.
• “Matikan jaringan mitra Search di setiap kampanye dan tunjukkan perbandingan sebelum dan sesudahnya.”
  set_google_ads_networks membaca pengaturan saat ini terlebih dahulu, lalu mengubahnya kampanye demi kampanye.
• “Seseorang mengubah tawaran kami hari Jumat. Apa yang berubah?”
  google_ads_change_history mencantumkan perubahan beserta waktunya.
• “Hubungkan properti GA4 kami supaya pendaftaran dihitung sebagai konversi di Google Ads.”
  link_google_ads_to_analytics menghubungkan keduanya, dan create_analytics_key_event menandai peristiwa pendaftaran sebagai key event.

Performance Max, dibangun dengan cara yang sama

create_google_ads_performance_max_campaign membangun jenis kampanye lintas-permukaan Google (Search, YouTube, Display, Discover, Gmail, dan Maps dari satu kampanye), dan membangunnya dalam satu operasi atomik karena Google memang mewajibkannya: anggaran, kampanye, targeting lokasi dan bahasa, grup aset, serta setiap tautan aset dikirim bersamaan, sehingga aset yang ditolak tidak meninggalkan kampanye setengah jadi. Kampanye dibuat dalam keadaan dijeda, dan seluruh pohonnya dibaca kembali dari Google sebelum agen Anda memberi tahu bahwa kampanye itu ada.

Batas minimum aset Google diperiksa di sini sebelum ada yang dikirim, sehingga gambar persegi yang kurang akan menghasilkan pesan yang jelas, bukan penolakan API yang tidak terbaca: 3–15 judul dengan 30 karakter atau kurang, 1–5 judul panjang hingga 90 karakter, 2–5 deskripsi hingga 90 karakter, satu nama bisnis hingga 25 karakter, dan setidaknya satu logo, satu gambar pemasaran, serta satu gambar pemasaran persegi. Unggah gambar dengan upload_google_ads_asset terlebih dahulu, lalu berikan nama resource-nya. Video YouTube bersifat opsional. Google akan membuatnya dari grup aset jika Anda tidak menyertakannya.

Performance Max tidak memiliki kata kunci dan tidak memakai tawaran manual: ia hanya mengoptimalkan menuju konversi. Karena itu, pembangunan ditolak pada akun yang tidak memiliki tindakan konversi aktif, bukan membuat kampanye yang tidak bisa dioptimalkan, dan pesannya menyebut dua jalan keluar: buat satu dengan create_google_ads_conversion_action, atau jalankan strategi yang tidak memerlukannya. Panduan merek aktif secara default untuk kampanye PMax baru sejak Google Ads API v21, yang mengubah tempat nama bisnis dan logo dilampirkan; Hermoso menautkannya ke kampanye untuk Anda.

Performance Max berbasis feed Shopping (ritel) bekerja dengan cara yang sama: berikan merchantCenterId dan kampanye akan mengiklankan katalog Merchant Center Anda, dengan feedLabel untuk mempersempitnya ke satu feed. Kampanye ini dibangun dan dibaca kembali persis seperti kampanye di atas. Pembacaan ulang melaporkan akun Merchant Center dan label feed yang benar-benar disimpan Google, sehingga Anda bisa melihat bahwa ini memang kampanye ritel, bukan sekadar percaya pada kami. Kampanye ini mengiklankan seluruh feed di bawah satu listing group akar; pemisahan feed menurut merek, kategori, atau label kustom belum dibangun, dan ditolak dengan menyebut namanya, bukan diabaikan diam-diam, sehingga Anda tidak akan pernah mengira sudah mempersempit feed padahal belum.

Merchant Center, agar agen tahu apa yang dijual

“Kenapa produk ini tidak muncul?” adalah pertanyaan yang secara struktural tidak bisa dijawab laporan Google Ads, karena produk yang tidak disetujui tidak memiliki impresi untuk dilaporkan. Jawabannya ada di Merchant Center, dan koneksi Google yang sama menjangkaunya, tanpa login kedua.

Agen Anda bisa mencantumkan akun Merchant Center yang bisa dijangkau akun Google yang terhubung dengan list_merchant_accounts (agensi biasanya punya beberapa, sehingga agen bertanya toko mana, bukan menebak), membaca produk dalam feed dengan list_merchant_products (katalog sebenarnya yang disajikan kampanye Shopping atau Performance Max ritel), dan membaca isu tingkat akun yang diajukan Google terhadap akun dengan list_merchant_issues. Itu cukup untuk menulis salinan iklan tentang produk yang benar-benar ada, dengan harga yang benar-benar berlaku, dan untuk menjelaskan kampanye yang diam.

Alat ini juga bisa menulis. create_merchant_data_source membuat feed produk API, upsert_merchant_product memasukkan produk ke dalamnya, update_merchant_product mengubah field yang berubah setiap hari (harga dan ketersediaan), dan delete_merchant_product serta delete_merchant_data_source menghapusnya setelah konfirmasi. list_merchant_data_sources menunjukkan feed mana yang benar-benar bisa menerima penulisan.

Ada tiga hal yang perlu diketahui di awal. Google memblokir setiap panggilan Merchant API sampai proyek Cloud Hermoso terdaftar pada akun Merchant Center Anda, sehingga register_merchant_developer melakukan tautan itu sekali dan menyebutkannya dengan jelas. Ini bukan koneksi yang rusak, dan menyambung ulang tidak akan memperbaikinya. Penulisan produk hanya masuk ke sumber data API: feed file, autofeed, dan feed yang dibuat sendiri oleh antarmuka Merchant Center semuanya tercantum secara normal dan semuanya menolak penulisan, sehingga Hermoso menentukan feed yang bisa ditulis untuk Anda, membuatnya jika belum ada, dan menolak dengan menyebut namanya jika ada beberapa, daripada menaruh produk Anda di pasar yang mungkin tidak dijangkau kampanye Anda. Dan upsert_merchant_product adalah penulisan seluruh baris, sedangkan update_merchant_product adalah patch. Kirim setiap field yang ingin Anda pertahankan ke yang pertama, dan hanya field yang Anda ubah ke yang kedua.

Tidak satu pun dari itu berarti Anda harus memindahkan katalog Anda. Jika feed sudah ada di Shopify atau platform Anda, biarkan di sana dan biarkan agen membacanya; penulisan itu untuk kasus ketika belum ada yang memiliki feed, atau ketika satu harga atau ketersediaan perlu dikoreksi sekarang, bukan pada sinkronisasi berikutnya.

Google Analytics 4, agar Anda bisa melihat apa yang dilakukan klik

Laporan Google Ads berakhir di klik. Apa yang terjadi setelahnya (sesi, pendaftaran, pesanan) ada di Google Analytics, dan login Google yang sama menjangkaunya (ini koneksi tersendiri, karena memerlukan izin sendiri).

Agen Anda bisa menentukan properti GA4 mana yang akan dibaca dengan list_analytics_properties. Ini penting karena setiap panggilan Analytics memerlukan id properti numerik, sedangkan yang biasanya Anda punya adalah ID Pengukuran G-XXXXXXXXX dari cuplikan pelacakan Anda. Lalu analytics_report mengembalikan sesi, pengguna, konversi, dan pendapatan yang dirinci menurut saluran, source/medium, kampanye, halaman arahan, negara, perangkat, atau tanggal, dan analytics_realtime menampilkan siapa yang sedang berada di situs sekarang. Jadi “bangun kampanyenya” dan “beri tahu saya apa yang dihasilkannya” adalah percakapan yang sama.

Alat ini juga bisa menulis, dan inilah bagian yang langsung kembali ke Google Ads: create_analytics_key_event menandai peristiwa yang sudah dikumpulkan GA4 sebagai key event, yaitu yang diimpor Google Ads sebagai konversi, dan tindakan konversi adalah syarat setiap strategi smart bidding di halaman ini. create_analytics_custom_dimension mendaftarkan parameter peristiwa agar laporan bisa dirinci menurut parameter itu, dan list_analytics_definitions menunjukkan apa yang sudah diukur properti tersebut sebelum Anda menambahkan salah satunya. Dua hal ini berlaku selamanya: ini hanya GA4, karena API tidak memiliki permukaan Universal Analytics sama sekali, dan dimensi kustom bisa diarsipkan tetapi tidak pernah dihapus, dengan 50 slot berlingkup peristiwa per properti, jadi agen memeriksa kumpulan yang ada terlebih dahulu.

Gerbang pengeluaran langsung lebih luas dari satu alat

Menjeda kampanye bukan satu-satunya cara menghindari pengeluaran, dan memperlakukannya seperti itu adalah jebakan yang nyata: membuat grup iklan, iklan, atau kata kunci yang sudah aktif di bawah induk yang sudah aktif akan tayang pada lelang berikutnya. Karena itu, konfirmasi yang melindungi set_google_ads_status juga melindungi create_google_ads_ad_group, create_google_ads_ad, dan add_google_ads_keywords setiap kali induknya aktif, dibaca dari baris yang sudah diambil masing-masing alat tersebut, tanpa putaran tambahan. Kata kunci negatif hanya membatasi pengeluaran, sehingga tidak pernah diberi gerbang.

Pelaporan GAQL, dengan satu catatan yang perlu diketahui

google_ads_report menerima GAQL apa pun, sehingga agen Anda bisa meminta irisan data yang diperlukan, bukan dipaksa ke bentuk laporan tetap. Satu hal yang perlu diingat jika Anda menulis kueri secara manual atau membiarkan model menulisnya: GAQL bukan SQL. Ia tidak memiliki subkueri, dan IN menerima daftar literal. WHERE id IN (SELECT …) tidak valid dan akan gagal, bukan diam-diam mengembalikan baris yang salah. Kirim hasilnya langsung ke spreadsheet dengan create_sheet dan append_to_sheet, atau ke dokumen dengan create_doc.

Baca ulang, lalu laporkan

Setelah mutate, pohonnya dibaca kembali dari Google, dan ringkasan yang Anda terima dibuat dari pembacaan ulang itu, bukan dari apa yang diminta. Ini disiplin kecil yang menangkap kegagalan spesifik ketika agen dengan yakin menceritakan kampanye yang sebenarnya dipaksa atau ditolak oleh platform.

Yang tidak akan dilakukannya tanpa bertanya

Agen dengan anggaran hanya berguna jika risikonya dibatasi, sehingga wewenang pengeluaran dipagari di server, bukan di prompt. Kampanye, grup iklan, dan iklan Meta selalu dibuat dalam keadaan PAUSED tanpa penggantian dari pemanggil. Sakelar status yang bisa menyalakan belanja iklan sungguhan (satu di setiap platform iklan: set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status, dan set_openai_ads_status, di antaranya) semuanya menolak berjalan tanpa flag konfirmasi eksplisit, dan gerbang yang sama mencakup pembuatan grup iklan, iklan, atau kata kunci Google Ads yang sudah aktif di bawah induk yang sudah aktif, karena itu tayang pada lelang berikutnya. Penghapusan juga diberi gerbang konfirmasi. Di sisi generasi, hermoso_capabilities mempublikasikan biaya kredit pasti tiap model sebelum apa pun berjalan, dan setiap render memesan estimasi lalu menyelesaikan biaya sebenarnya, sehingga dispatch yang gagal dikembalikan, bukan ditagih diam-diam.

Menghubungkan akun Google Ads Anda

Anda menghubungkan Google Ads ke Hermoso melalui alur OAuth milik Google sendiri di pengaturan Connectors; tidak ada kata sandi yang melewati model. Koneksi Google Ads dibagikan di tingkat merek, sehingga seluruh tim yang bekerja pada sebuah merek memakai satu koneksi, dan tidak ada yang perlu mengotorisasi ulang.

Bagian kreatif

Pengelolaan kampanye hanya berguna jika ada yang bisa dijalankan. Server yang sama meneliti apa yang sudah menang di pasar Anda di pustaka iklan Meta, Google, dan LinkedIn, merender kreatif gambar dan video jadi yang berakar pada produk nyata Anda di lebih dari 100 model, dan mengunggah aset, sehingga “apa yang sebaiknya kami jalankan” dan “bangunlah” menjadi satu percakapan, bukan dua alat. Lihat ikhtisar marketing MCP, daftar alat lengkap, atau Meta Ads MCP jika Anda menjalankan keduanya.

Pertanyaan yang sering diajukan

Apakah ada server MCP untuk Google Ads?

Ada. Server MCP Hermoso membangun dan mengelola Google Ads dari klien MCP mana pun: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, dan add_google_ads_keywords untuk membangun pohon search atau display; create_google_ads_performance_max_campaign untuk Performance Max; set_google_ads_budget, set_google_ads_bidding, dan set_google_ads_targeting untuk mengatur; google_ads_keyword_ideas untuk riset Keyword Planner; list_google_ads_campaigns dan google_ads_report untuk pelaporan; pembacaan Merchant Center untuk feed produk di balik kampanye Shopping; dan set_google_ads_status yang diberi gerbang konfirmasi untuk mengaktifkan.

Bisakah agen AI membuat kampanye Google Ads?

Bisa, dan seluruh pohonnya dibuat dalam satu operasi atomik dengan id resource sementara: kampanye, grup iklan, iklan responsif search atau display, dan kata kunci sekaligus. Jika iklan ditolak, anggarannya pun tidak pernah dibuat, sehingga Anda tidak tertinggal dengan objek yatim yang harus dibersihkan. Mode dry-run memvalidasi pohon terhadap API langsung tanpa membuat apa pun.

Bisakah membuat kampanye Performance Max?

Bisa. create_google_ads_performance_max_campaign membangun anggaran, kampanye, targeting, grup aset, dan setiap tautan aset dalam satu operasi atomik, karena Google memerlukannya sekaligus. Kampanye dibuat dalam keadaan dijeda dan dibaca kembali sebelum agen melaporkannya. Batas minimum aset Google ditegakkan sebelum ada yang dikirim: 3–15 judul, 1–5 judul panjang, 2–5 deskripsi, nama bisnis, dan setidaknya satu logo, gambar pemasaran, dan gambar pemasaran persegi. PMax hanya menawar pada konversi, sehingga ia menolak dibangun pada akun tanpa tindakan konversi aktif, bukan membuat kampanye yang tidak bisa dioptimalkan. PMax berbasis feed Shopping (ritel) bekerja dengan cara yang sama: berikan merchantCenterId dan kampanye akan mengiklankan katalog Merchant Center Anda, dengan feedLabel untuk mempersempitnya ke satu feed, dan pembacaan ulang melaporkan akun Merchant Center serta label feed yang benar-benar disimpan Google.

Apakah bekerja dengan Google Merchant Center?

Ya, pembacaan dan penulisan, lewat koneksi Google yang sama. Agen bisa mencantumkan akun Merchant Center yang bisa dijangkau akun Anda, membaca produk dalam feed (katalog yang benar-benar disajikan kampanye Shopping atau Performance Max ritel), dan membaca isu tingkat akun yang diajukan Google, yang merupakan satu-satunya tempat untuk mengetahui mengapa sebuah produk tidak muncul, karena produk yang tidak disetujui tidak memiliki impresi untuk ditampilkan laporan Google Ads. Google mewajibkan pendaftaran sekali oleh proyek Cloud Hermoso terhadap akun Merchant Center Anda sebelum API merespons, dan ada alat yang melakukannya. Ia juga menulis: create_merchant_data_source, upsert_merchant_product, update_merchant_product untuk perubahan harga dan ketersediaan yang berubah setiap hari, serta delete_merchant_product dan delete_merchant_data_source yang diberi gerbang konfirmasi. Google hanya menerima penulisan produk ke sumber data API, sehingga Hermoso menentukan feed yang bisa ditulis untuk Anda dan menolak dengan menyebut namanya jika akun memiliki beberapa.

Bisakah melakukan riset kata kunci?

Bisa. google_ads_keyword_ideas memanggil Keyword Planner Google dan mengembalikan volume pencarian bulanan yang nyata, persaingan, dan kisaran tawaran teratas, dimulai dari kata kunci, URL halaman arahan, atau seluruh situs. Agen bisa langsung memakainya di add_google_ads_keywords, atau menuliskannya ke Google Sheet.

Bisakah mulai membelanjakan anggaran Google Ads saya?

Hanya dengan konfirmasi eksplisit. set_google_ads_status adalah sakelar yang menyalakan uang sungguhan, dan karena membuat anak yang aktif di bawah induk yang sudah aktif akan tayang pada lelang berikutnya, konfirmasi yang sama juga melindungi create_google_ads_ad_group, create_google_ads_ad, dan add_google_ads_keywords saat induknya aktif. Kata kunci negatif hanya membatasi pengeluaran dan tidak pernah diberi gerbang.

Bisakah menjalankan laporan?

Bisa. google_ads_report menerima GAQL apa pun, sehingga agen bisa meminta irisan data yang diperlukan. Perlu diketahui bahwa GAQL bukan SQL: ia tidak memiliki subkueri, dan IN menerima daftar literal, sehingga WHERE id IN (SELECT …) tidak valid. Hasilnya bisa langsung ditulis ke Google Sheet atau Doc.

Tawaran dan targeting apa yang bisa diatur?

Enam strategi tawaran, jadwal kampanye, serta targeting geografis dan bahasa, dengan find_google_ads_locations untuk mencari target lokasi berdasarkan nama. Anggaran diatur lewat set_google_ads_budget, dan kata kunci mendukung negatif serta CPC per kata kunci.

Apakah agen mendapatkan kata sandi Google saya?

Tidak. Anda menghubungkan Google Ads lewat alur OAuth milik Google di pengaturan Connectors Hermoso, dan Hermoso menyimpan token yang dihasilkan. Agen hanya memanggil alat Hermoso. Koneksi Google Ads dibagikan di tingkat merek sehingga seluruh tim bekerja dari satu koneksi.

Bisakah juga membuat kreatif iklannya?

Bisa. Server yang sama meneliti iklan pesaing, merencanakan konsepnya, merender kreatif gambar dan video jadi di lebih dari 100 model dengan produk nyata Anda tergabung di dalamnya, dan mengunggah aset dengan upload_google_ads_asset, sehingga riset, kreatif, dan pembangunan kampanye terjadi dalam satu percakapan.