Google Ads MCP: bina keseluruhan struktur daripada ejen anda, secara atomik

Adakah terdapat pelayan Google Ads MCP? Ada. Hermoso ialah pelayan Google Ads MCP yang dihoskan. Tambahkan https://app.hermoso.ai/mcp ke Claude, ChatGPT atau Cursor dan sambungkan akaun Google Ads anda sekali sahaja. Pembantu anda kemudian boleh membina kempen carian, paparan dan Performance Max, mencari idea kata kunci, menetapkan bajet, bida dan sasaran, serta menjalankan laporan. Menghidupkan kempen sentiasa memerlukan pengesahan jelas daripada anda.

Google Ads ialah struktur berperingkat, dan di situlah penciptaan kempen berskrip selalunya tersasar. Anda cipta bajet, kemudian kempen, kemudian kumpulan iklan, kemudian iklan. Jika iklan ditolak pada langkah keempat, anda tinggal dengan tiga objek yatim dan bajet yang tidak anda mahukan. Membersihkannya secara manual ialah sebab utama kebanyakan orang berhenti mengautomasikan Google Ads.

Pelayan MCP Hermoso membina keseluruhan struktur dalam satu operasi atomik, menggunakan id sumber sementara supaya anak-anak boleh merujuk kepada induk yang belum wujud. Sama ada kempen, kumpulan iklan, iklan dan kata kunci semuanya wujud, atau tiada satu pun wujud. Iklan yang ditolak bermakna bajet itu juga tidak pernah dicipta.

Pasang sekali sahaja: dalam Claude.ai atau Claude Desktop, tampal https://app.hermoso.ai/mcp di bawah Settings → Connectors dan luluskannya dengan akaun Hermoso anda. Dalam ejen pengekodan ia cukup satu arahan: /plugin marketplace add hermoso-ai/hermoso kemudian /plugin install hermoso@hermoso dalam Claude Code, codex plugin marketplace add hermoso-ai/hermoso kemudian codex plugin add hermoso@hermoso dalam Codex, atau npx skills add hermoso-ai/hermoso -a cursor dalam Cursor (namakan ejen anda selepas -a), kemudian log masuk sekali dengan npx -y hermoso auth login. Persediaan penuh ada di halaman MCP & CLI.

Alat Google Ads

Bina. 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 coretan berstruktur.

Konfigurasi. 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 (rakan carian dan Paparan dihidupkan atau dimatikan), create_google_ads_conversion_action dan list_google_ads_conversion_actions.

Penyelidikan. google_ads_keyword_ideas membawa Keyword Planner ke dalam perbualan: jumlah carian bulanan sebenar, persaingan dan julat bida atas halaman, dibenihkan daripada satu set kata kunci, halaman pendaratan atau seluruh laman web.

Baca dan ubah. list_google_ads_campaigns, google_ads_report untuk GAQL arbitrari, google_ads_change_history untuk apa yang berubah dalam akaun dan bilakanya, delete_google_ads_object untuk membuang satu objek, dan set_google_ads_status, satu-satunya suis berpintu pengesahan yang memulakan perbelanjaan sebenar.

create_google_ads_campaign juga menerima mod larian kering, jadi ejen boleh mengesahkan keseluruhan struktur terhadap API langsung tanpa mencipta apa-apa. Itu lalai yang baik apabila ia mencadangkan pelan untuk anda luluskan.

Apa yang boleh dilakukan ejen anda dengan Google Ads MCP

Setiap baris ialah alat sebenar pada pelayan. Tanya dalam bahasa biasa dan ejen memilih alat mana yang hendak dijalankan.

Contoh arahan

Tampalkan mana-mana arahan ini ke Claude, ChatGPT atau Cursor sebaik Hermoso disambungkan.

• “Cari 30 kata kunci untuk aplikasi pengurusan projek kami dengan jumlah carian melebihi 1,000 sebulan di AS, dan kumpulkannya mengikut niat.”
  google_ads_keyword_ideas memulangkan jumlah Keyword Planner, persaingan dan julat bida, dan ejen mengumpulkannya.
• “Bina kempen Carian yang dijeda untuk kata kunci itu: $50 sehari, AS dan Kanada, Inggeris, maksimumkan penukaran.”
  create_google_ads_campaign membina bajet, kempen, kumpulan iklan, iklan dan kata kunci dalam satu operasi atomik, dijeda, kemudian membacanya semula.
• “Sediakan kempen Performance Max untuk katalog Shopify kami menggunakan suapan Merchant Center kami.”
  list_merchant_accounts memilih kedai, kemudian create_google_ads_performance_max_campaign membinanya dijeda dengan suapan dilampirkan.
• “Istilah carian mana yang menghabiskan wang bulan lepas tanpa penukaran? Tambah sepuluh yang paling teruk sebagai negatif.”
  google_ads_report menarik laporan istilah carian, kemudian add_google_ads_keywords menambah negatif.
• “Tambahkan empat sitelink ke kempen jenama kami: harga, demo, kajian kes dan hubungi kami.”
  add_google_ads_assets mencipta sitelink dan melampirkannya pada kempen.
• “Matikan rakan carian pada setiap kempen dan tunjukkan kepada saya sebelum dan selepasnya.”
  set_google_ads_networks membaca tetapan semasa dahulu, kemudian menukarnya kempen demi kempen.
• “Seseorang menukar bida kami pada hari Jumaat. Apa yang berubah?”
  google_ads_change_history menyenaraikan perubahan beserta masa.
• “Hubungkan harta GA4 kami supaya pendaftaran dikira sebagai penukaran dalam Google Ads.”
  link_google_ads_to_analytics menghubungkan kedua-duanya, dan create_analytics_key_event menandakan acara pendaftaran sebagai acara utama.

Performance Max, dibina dengan cara yang sama

create_google_ads_performance_max_campaign membina jenis kempen rentas permukaan Google (Carian, YouTube, Paparan, Discover, Gmail dan Maps daripada satu kempen), dan ia membinanya dalam satu operasi atomik kerana Google memerlukan itu: bajet, kempen, sasaran lokasi dan bahasa, kumpulan aset dan setiap pautan aset dinaikkan bersama, jadi aset yang ditolak tidak meninggalkan kempen separuh siap. Ia dicipta dalam keadaan dijeda, dan keseluruhan struktur dibaca semula daripada Google sebelum ejen anda memberitahu anda bahawa ia wujud.

Syarat minimum aset Google disemak di sini sebelum apa-apa dihantar, jadi imej persegi yang hilang ialah mesej yang jelas dan bukan penolakan API yang tidak difahami: 3–15 tajuk dengan 30 aksara atau kurang, 1–5 tajuk panjang sehingga 90, 2–5 perihalan sehingga 90, satu nama perniagaan sehingga 25, dan sekurang-kurangnya satu logo, satu imej pemasaran dan satu imej pemasaran persegi. Muat naik imej dengan upload_google_ads_asset dahulu dan berikan nama sumbernya. Video YouTube adalah pilihan. Google akan menjana satu daripada kumpulan aset jika anda tidak memberinya.

Performance Max tidak mempunyai kata kunci dan tiada bida manual: ia mengoptimumkan ke arah penukaran dan tiada yang lain. Maka pembinaan menolak pada akaun yang tiada tindakan penukaran yang diaktifkan dan bukannya mencipta kempen yang tidak dapat dioptimumkan, dan ia menamakan kedua-dua jalan keluar: cipta satu dengan create_google_ads_conversion_action, atau jalankan strategi yang tidak memerlukannya. Panduan jenama dihidupkan secara lalai untuk kempen PMax baharu sejak Google Ads API v21, yang mengubah tempat nama perniagaan dan logo dilampirkan; Hermoso memautkannya ke kempen untuk anda.

Performance Max runcit (suapan Shopping) berfungsi dengan cara yang sama: hantar merchantCenterId dan kempen itu mengiklankan katalog Merchant Center anda, dengan feedLabel untuk menyempitkannya kepada satu suapan. Ia dibina dan dibaca semula sama seperti kempen di atas. Bacaan semula melaporkan akaun Merchant Center dan label suapan yang sebenarnya disimpan oleh Google, jadi anda boleh melihat bahawa ia benar-benar kempen runcit dan bukan sekadar percaya kata kami. Ia mengiklankan seluruh suapan di bawah satu senarai produk akar; pembahagian suapan mengikut jenama, kategori atau label tersuai belum dibina, dan ia ditolak dengan nama, bukan diabaikan diam-diam, supaya anda tidak pernah percaya anda telah menyempitkan suapan padahal tidak.

Merchant Center, supaya ejen tahu apa yang dijualnya

“Kenapa produk ini tidak dipaparkan?” ialah soalan yang laporan Google Ads secara struktur tidak boleh jawab, kerana produk yang ditolak tidak mempunyai tayangan untuk dilaporkan. Jawapannya ada dalam Merchant Center, dan sambungan Google yang sama mencapainya, tanpa log masuk kedua.

Ejen anda boleh menyenaraikan akaun Merchant Center yang boleh dicapai oleh akaun Google anda dengan list_merchant_accounts (agensi biasanya mempunyai beberapa, jadi ia bertanya kedai yang mana dan tidak meneka), membaca produk dalam suapan dengan list_merchant_products (katalog sebenar yang dipaparkan oleh kempen Shopping atau Performance Max runcit), dan membaca isu peringkat akaun yang dibangkitkan Google terhadap akaun itu dengan list_merchant_issues. Itu cukup untuk menulis salinan iklan tentang produk yang benar-benar wujud, pada harga yang benar-benar aktif, dan untuk menerangkan kempen yang senyap.

Ia juga menulis. create_merchant_data_source mencipta suapan produk API, upsert_merchant_product meletakkan produk di dalamnya, update_merchant_product menukar medan yang berubah setiap hari (harga dan ketersediaan), dan delete_merchant_product serta delete_merchant_data_source membuangnya selepas pengesahan. list_merchant_data_sources menunjukkan suapan mana yang benar-benar boleh menerima tulisan.

Tiga perkara yang perlu diketahui dari awal. Google menyekat setiap panggilan Merchant API sehingga projek Cloud Hermoso didaftarkan terhadap akaun Merchant Center anda, jadi register_merchant_developer melakukan pautan itu sekali dan menyatakannya dengan nama. Ini bukan sambungan yang rosak, dan menyambung semula tidak akan membetulkannya. Tulisan produk hanya masuk ke sumber data API: suapan fail, autofeed dan suapan yang dicipta oleh UI Merchant Center sendiri kesemuanya disenaraikan secara normal dan kesemuanya menolak tulisan, jadi Hermoso memilih suapan yang boleh ditulis untuk anda, mencipta satu jika tiada, dan menolak dengan nama jika terdapat beberapa, supaya produk anda tidak diletakkan dalam pasaran yang mungkin tidak disasarkan oleh kempen anda. Dan upsert_merchant_product ialah tulisan keseluruhan baris manakala update_merchant_product ialah tampalan. Hantar setiap medan yang anda mahu kekalkan kepada yang pertama, dan hanya medan yang anda ubah kepada yang kedua.

Tiada satu pun daripada itu bermakna anda perlu memindahkan katalog anda. Jika suapan sudah berada dalam Shopify atau platform anda, biarkan di situ dan benarkan ejen membacanya; tulisan itu untuk kes apabila tiada apa-apa memiliki suapan lagi, atau apabila satu harga atau ketersediaan perlu dibetulkan sekarang dan bukan pada penyegerakan seterusnya.

Google Analytics 4, supaya anda boleh lihat apa yang dibuat oleh klik

Laporan Google Ads berakhir pada klik. Apa yang berlaku selepas itu (sesi, pendaftaran, pesanan) berada dalam Google Analytics, dan log masuk Google yang sama mencapainya (ia sambungan tersendiri, kerana ia memerlukan kebenaran sendiri).

Ejen anda boleh menentukan harta GA4 yang hendak dibaca dengan list_analytics_properties. Itu penting kerana setiap panggilan Analytics memerlukan id harta berangka, dan apa yang anda ada sebenarnya ialah ID Pengukuran G-XXXXXXXXX daripada cebisan penjejakan anda. Kemudian analytics_report memulangkan sesi, pengguna, penukaran dan hasil mengikut saluran, sumber/medium, kempen, halaman pendaratan, negara, peranti atau tarikh, dan analytics_realtime menunjukkan siapa yang berada di laman sekarang. Jadi “bina kempen” dan “beritahu saya apa yang diperoleh” ialah perbualan yang sama.

Ia juga menulis, dan inilah bahagian yang terus kembali ke Google Ads: create_analytics_key_event menandakan acara yang sudah dikumpulkan oleh GA4 sebagai acara utama, yang tepat diimport oleh Google Ads sebagai penukaran, dan tindakan penukaran ialah perkara yang setiap strategi bida pintar pada halaman ini tidak boleh berfungsi tanpanya. create_analytics_custom_dimension mendaftarkan parameter acara supaya laporan boleh dipecahkan mengikutnya, dan list_analytics_definitions menunjukkan apa yang sudah diukur oleh harta itu sebelum anda menambah mana-mana satu. Dua perkara yang kekal benar selamanya: ini hanya GA4, kerana API tidak mempunyai permukaan Universal Analytics langsung, dan dimensi tersuai boleh diarkibkan tetapi tidak pernah dipadam, dengan 50 slot bercakupan acara bagi setiap harta, jadi ejen memeriksa set sedia ada dahulu.

Pintu perbelanjaan langsung lebih luas daripada satu alat

Menjeda kempen bukanlah satu-satunya cara untuk mengelak perbelanjaan, dan menganggapnya begitu ialah perangkap yang sebenar: mencipta kumpulan iklan, iklan atau kata kunci yang diaktifkan di bawah induk yang sudah diaktifkan akan dipaparkan pada lelongan seterusnya. Maka pengesahan yang sama yang melindungi set_google_ads_status juga melindungi create_google_ads_ad_group, create_google_ads_ad dan add_google_ads_keywords apabila induk sedang aktif, dibaca daripada baris yang setiap satu daripada alat itu sudah ambil, tanpa perjalanan pergi balik tambahan. Kata kunci negatif hanya menghadkan perbelanjaan, jadi ia tidak pernah dipintu.

Pelaporan GAQL, dengan satu peringatan yang perlu diketahui

google_ads_report menerima GAQL arbitrari, jadi ejen anda boleh meminta sebarang kepingan yang diperlukan dan tidak terkurung dalam bentuk laporan tetap. Satu perkara yang perlu diingat jika anda menulis pertanyaan secara manual atau membiarkan model menulisnya: GAQL bukan SQL. Ia tiada subquery, dan IN menerima senarai literal. WHERE id IN (SELECT …) tidak sah dan akan gagal dan bukannya diam-diam memulangkan baris yang salah. Salurkan hasilnya terus ke hamparan dengan create_sheet dan append_to_sheet, atau ke dokumen dengan create_doc.

Baca semula, kemudian laporkan

Selepas mutate, struktur dibaca semula daripada Google, dan ringkasan yang anda terima dibina daripada bacaan semula itu, bukan daripada apa yang diminta. Ia disiplin kecil yang menangkap kegagalan khusus apabila ejen dengan yakin menceritakan kempen yang sebenarnya dipaksa atau ditolak oleh platform.

Apa yang tidak akan dibuatnya tanpa bertanya

Ejen dengan bajet hanya berguna jika risikonya terhad, jadi kuasa membelanjakan dipagari di dalam pelayan dan bukan di dalam arahan. Kempen, kumpulan iklan dan iklan Meta dicipta dengan PAUSED tanpa pertindihan daripada pemanggil. Suis status yang boleh mengarmkan perbelanjaan iklan sebenar (satu pada 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 antara yang lain) kesemuanya menolak untuk berjalan tanpa bendera pengesahan jelas, dan pintu yang sama itu meliputi penciptaan kumpulan iklan, iklan atau kata kunci Google Ads yang diaktifkan di bawah induk yang sudah diaktifkan, kerana itu dipaparkan pada lelongan seterusnya. Pemadaman juga memerlukan pengesahan. Di pihak penjanaan, hermoso_capabilities menerbitkan kos kredit tepat setiap model sebelum apa-apa berjalan, dan setiap render menempah anggaran kemudian menyelesaikan kos sebenar, jadi penghantaran yang gagal dikembalikan dan bukannya diam-diam dikenakan bayaran.

Menyambungkan akaun Google Ads anda

Anda menyambungkan Google Ads ke Hermoso melalui aliran OAuth Google sendiri dalam Setelan kemudian Penyambung; tiada kata laluan melalui model. Sambungan Google Ads dikongsi pada peringkat jenama, jadi seluruh pasukan pada satu jenama bekerja daripada satu sambungan dan tidak perlu setiap orang memberi kebenaran semula.

Bahagian kreatif

Pengurusan kempen hanya berguna jika ada sesuatu untuk dijalankan. Pelayan yang sama menyelidik apa yang sudah berjaya dalam pasaran anda merentasi perpustakaan iklan Meta, Google dan LinkedIn, merender kreatif imej dan video siap yang berasaskan produk sebenar anda merentasi 100+ model, dan memuat naik aset, supaya “apa yang patut kami jalankan” dan “bina” ialah satu perbualan dan bukan dua alat. Lihat gambaran keseluruhan marketing MCP, senarai alat penuh, atau Meta Ads MCP jika anda menjalankan kedua-duanya.

Soalan lazim

Adakah terdapat pelayan MCP untuk Google Ads?

Ada. Pelayan MCP Hermoso membina dan mengurus Google Ads daripada mana-mana klien MCP: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad dan add_google_ads_keywords untuk membina struktur carian atau paparan; create_google_ads_performance_max_campaign untuk Performance Max; set_google_ads_budget, set_google_ads_bidding dan set_google_ads_targeting untuk konfigurasi; google_ads_keyword_ideas untuk penyelidikan Keyword Planner; list_google_ads_campaigns dan google_ads_report untuk pelaporan; bacaan Merchant Center untuk suapan produk di sebalik kempen Shopping; dan set_google_ads_status yang dipintu pengesahan untuk mengaktifkan.

Bolehkah ejen AI mencipta kempen Google Ads?

Boleh, dan keseluruhan struktur dicipta dalam satu operasi atomik menggunakan id sumber sementara: kempen, kumpulan iklan, iklan carian atau paparan responsif dan kata kunci bersama-sama. Jika iklan ditolak, bajet itu juga tidak pernah dicipta, jadi anda tidak perlu membersihkan objek yatim. Mod larian kering mengesahkan struktur terhadap API langsung tanpa mencipta apa-apa.

Bolehkah ia mencipta kempen Performance Max?

Boleh. create_google_ads_performance_max_campaign membina bajet, kempen, sasaran, kumpulan aset dan setiap pautan aset dalam satu operasi atomik, kerana Google memerlukannya bersama. Kempen dicipta dalam keadaan dijeda dan dibaca semula sebelum ejen melaporkan. Syarat minimum aset Google dikuatkuasakan sebelum apa-apa dihantar: 3–15 tajuk, 1–5 tajuk panjang, 2–5 perihalan, satu nama perniagaan, dan sekurang-kurangnya satu logo, imej pemasaran dan imej pemasaran persegi. PMax hanya bida pada penukaran, jadi ia menolak untuk dibina pada akaun yang tiada tindakan penukaran yang diaktifkan dan bukannya mencipta kempen yang tidak dapat dioptimumkan. PMax runcit (Shopping) berfungsi dengan cara yang sama: hantar merchantCenterId dan kempen mengiklankan katalog Merchant Center anda, dengan feedLabel untuk menyempitkannya kepada satu suapan, dan bacaan semula melaporkan akaun Merchant Center serta label suapan yang sebenarnya disimpan oleh Google.

Adakah ia berfungsi dengan Google Merchant Center?

Ya, bacaan dan tulisan, melalui sambungan Google yang sama. Ejen boleh menyenaraikan akaun Merchant Center yang boleh dicapai oleh akaun anda, membaca produk dalam suapan (katalog yang sebenarnya dipaparkan oleh kempen Shopping atau Performance Max runcit), dan membaca isu peringkat akaun yang dibangkitkan Google, iaitu satu-satunya tempat untuk mengetahui sebab produk tidak dipaparkan, kerana produk yang ditolak tidak mempunyai tayangan untuk dilaporkan oleh pelaporan Google Ads. Google memerlukan pendaftaran sekali sahaja bagi projek Cloud Hermoso terhadap akaun Merchant Center anda sebelum API menjawab, dan terdapat satu 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, dan delete_merchant_product serta delete_merchant_data_source yang dipintu pengesahan. Google hanya menerima tulisan produk ke dalam sumber data API, jadi Hermoso memilih suapan yang boleh ditulis untuk anda dan menolak dengan nama jika akaun mempunyai beberapa.

Bolehkah ia membuat penyelidikan kata kunci?

Boleh. google_ads_keyword_ideas memanggil Keyword Planner Google dan memulangkan jumlah carian bulanan sebenar, persaingan dan julat bida atas halaman, dibenihkan daripada kata kunci, URL halaman pendaratan atau seluruh laman web. Ejen boleh membawa hasil itu terus ke add_google_ads_keywords, atau menulisnya ke Google Sheet.

Bolehkah ia mula membelanjakan bajet Google Ads saya?

Hanya dengan pengesahan jelas. set_google_ads_status ialah suis yang mengarmkan wang sebenar, dan kerana mencipta anak yang diaktifkan di bawah induk yang sudah diaktifkan dipaparkan pada lelongan seterusnya, pengesahan yang sama juga melindungi create_google_ads_ad_group, create_google_ads_ad dan add_google_ads_keywords apabila induk sedang aktif. Kata kunci negatif hanya menghadkan perbelanjaan dan tidak pernah dipintu.

Bolehkah ia menjalankan laporan?

Boleh. google_ads_report menerima GAQL arbitrari, jadi ejen boleh meminta sebarang kepingan yang diperlukan. Perhatikan bahawa GAQL bukan SQL: ia tiada subquery dan IN menerima senarai literal, jadi WHERE id IN (SELECT …) tidak sah. Hasil boleh ditulis terus ke Google Sheet atau Doc.

Apakah bida dan sasaran yang boleh ditetapkannya?

Enam strategi bida, jadual kempen, dan sasaran geografi serta bahasa, dengan find_google_ads_locations untuk menyelesaikan sasaran lokasi mengikut nama. Bajet ditetapkan melalui set_google_ads_budget, dan kata kunci menyokong negatif serta CPC setiap kata kunci.

Adakah ejen mendapat kata laluan akaun Google saya?

Tidak. Anda menyambungkan Google Ads melalui aliran OAuth Google sendiri dalam Setelan kemudian Penyambung Hermoso, dan Hermoso menyimpan token yang terhasil. Ejen hanya memanggil alat Hermoso. Sambungan Google Ads dikongsi pada peringkat jenama supaya seluruh pasukan bekerja daripada satu sambungan.

Bolehkah ia membuat kreatif iklan juga?

Boleh. Pelayan yang sama menyelidik iklan pesaing, merancang konsep, merender kreatif imej dan video siap dengan produk sebenar anda dicampurkan merentasi 100+ model, dan memuat naik aset dengan upload_google_ads_asset, jadi penyelidikan, kreatif dan pembinaan kempen berlaku dalam satu perbualan.