Google Ads MCP: tüm kampanya ağacını asistanınızdan tek atomik işlemle kurun

Google Ads için bir MCP sunucusu var mı? Evet. Hermoso barındırılan bir Google Ads MCP sunucusudur. https://app.hermoso.ai/mcp adresini Claude, ChatGPT ya da Cursor’a ekleyin ve Google Ads hesabınızı bir kez bağlayın. Asistanınız bundan sonra arama, görüntülü ve Performance Max kampanyaları kurabilir, anahtar kelime fikirleri bulabilir, bütçe, teklif ve hedefleme ayarlayabilir ve raporlar çalıştırabilir. Bir kampanyayı yayına almak için her zaman sizin açık onayınız gerekir.

Google Ads bir ağaçtır ve komut dosyasıyla kampanya kurmak genellikle tam da burada ters gider. Önce bir bütçe, sonra kampanya, sonra reklam grubu, en son reklam oluşturursunuz. Reklam dördüncü adımda reddedilirse üç yetim nesne ve istemediğiniz bir bütçeyle kalırsınız. Bunları elle temizlemek, çoğu insanın Google Ads’i otomatikleştirmekten vazgeçmesinin nedenidir.

Hermoso’nun MCP sunucusu tüm ağacı tek bir atomik işlemde kurar. Henüz var olmayan üst öğelere başvurabilmek için geçici kaynak kimlikleri kullanır. Ya kampanya, reklam grubu, reklam ve anahtar kelimelerin hepsi oluşur ya da hiçbiri oluşmaz. Reklam reddedilirse bütçe de hiç oluşturulmamış olur.

Bir kez kurun: Claude.ai ya da Claude Desktop’ta https://app.hermoso.ai/mcp adresini Ayarlar → Connectors bölümüne yapıştırın ve Hermoso hesabınızla onaylayın. Bir kodlama agent’ında tek komut yeterlidir: Claude Code’da /plugin marketplace add hermoso-ai/hermoso ardından /plugin install hermoso@hermoso, Codex’te codex plugin marketplace add hermoso-ai/hermoso ardından codex plugin add hermoso@hermoso, Cursor’da npx skills add hermoso-ai/hermoso -a cursor (-a sonrasına kendi agent’ınızın adını yazın). Ardından bir kez npx -y hermoso auth login ile oturum açın. Tüm kurulum için MCP ve CLI sayfasına bakın.

Google Ads araçları

Kurma. 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; site bağlantıları, açıklama notları ve yapılandırılmış snippet’lar için add_google_ads_assets.

Yapılandırma. set_google_ads_budget, set_google_ads_bidding (altı strateji), set_google_ads_targeting (coğrafya ve dil), find_google_ads_locations, set_google_ads_networks (Search ortakları ve Display açık ya da kapalı), create_google_ads_conversion_action ve list_google_ads_conversion_actions.

Araştırma. google_ads_keyword_ideas, Keyword Planner’ı konuşmanın içine taşır: bir anahtar kelime setinden, bir açılış sayfasından ya da bütün bir siteden yola çıkarak gerçek aylık arama hacimlerini, rekabeti ve sayfanın en üstü için teklif aralıklarını verir.

Okuma ve değiştirme. list_google_ads_campaigns, serbest GAQL için google_ads_report, hesapta neyin ne zaman değiştiğini gösteren google_ads_change_history, bir nesneyi silmek için delete_google_ads_object ve gerçek harcamayı başlatan, onay kapılı tek düğme olan set_google_ads_status.

create_google_ads_campaign bir deneme modunu da kabul eder; böylece agent, hiçbir şey oluşturmadan tüm ağacı canlı API’ye karşı doğrulayabilir. Sizin onaylamanız için bir plan önerirken bu iyi bir varsayılandır.

Google Ads MCP ile agent’ınız neler yapabilir

Aşağıdaki her satır sunucuda gerçek bir araçtır. Doğal dille sorun, agent hangilerini çalıştıracağına kendisi karar verir.

Örnek istemler

Hermoso bağlandıktan sonra bunlardan herhangi birini Claude, ChatGPT ya da Cursor’a yapıştırın.

• “ABD’de aylık 1.000’den fazla arama hacmine sahip, proje yönetimi uygulamamız için 30 anahtar kelime bul ve niyetlerine göre grupla.”
  google_ads_keyword_ideas Keyword Planner hacimlerini, rekabeti ve teklif aralıklarını döndürür; agent bunları gruplar.
• “Bu anahtar kelimeler için duraklatılmış bir Search kampanyası kur: günlük $50, ABD ve Kanada, İngilizce, dönüşümleri maksimize et.”
  create_google_ads_campaign bütçeyi, kampanyayı, reklam grubunu, reklamı ve anahtar kelimeleri tek atomik işlemde, duraklatılmış olarak kurar ve sonra geri okur.
• “Shopify kataloğumuz için Merchant Center akışımızı kullanarak bir Performance Max kampanyası kur.”
  list_merchant_accounts mağazayı seçer, ardından create_google_ads_performance_max_campaign akışı bağlı olarak duraklatılmış şekilde kurar.
• “Geçen ay para harcayıp dönüşüm getirmeyen arama terimleri hangileri? En kötü on tanesini negatif olarak ekle.”
  google_ads_report arama terimleri raporunu çeker, ardından add_google_ads_keywords negatifleri ekler.
• “Marka kampanyamıza dört site bağlantısı ekle: fiyatlandırma, demo, vaka çalışmaları ve iletişim.”
  add_google_ads_assets site bağlantılarını oluşturur ve kampanyaya bağlar.
• “Her kampanyada Search ortaklarını kapat ve önce ile sonrasını göster.”
  set_google_ads_networks önce mevcut ayarı okur, ardından kampanya kampanya değiştirir.
• “Cuma günü tetekliflerimizi biri değiştirdi. Neler değişti?”
  google_ads_change_history değişiklikleri saatleriyle listeler.
• “GA4 mülkümüzü bağla; kayıtlar Google Ads’te dönüşüm sayılsın.”
  link_google_ads_to_analytics ikisini bağlar, create_analytics_key_event kayıt olayını anahtar olay olarak işaretler.

Performance Max da aynı şekilde kurulur

create_google_ads_performance_max_campaign, Google’ın çapraz yüzeyli kampanya türünü kurar (tek kampanyadan Search, YouTube, Display, Discover, Gmail ve Maps). Bunu tek bir atomik işlemde yapar, çünkü Google bunu zorunlu kılar: bütçe, kampanya, konum ve dil hedeflemesi, reklam grubu ve her varlık bağlantısı birlikte gönderilir. Böylece reddedilen bir varlık yarım kalmış bir kampanya bırakmaz. Kampanya duraklatılmış oluşturulur ve agent sizin için bir şey söylemeden önce tüm ağaç Google’dan geri okunur.

Google’ın varlık asgarileri göndermeden önce burada kontrol edilir; böylece eksik bir kare görsel, opak bir API reddi yerine açık bir mesaj olur: 30 karakter ya da daha kısa 3–15 başlık, 90 karaktere kadar 1–5 uzun başlık, 90 karaktere kadar 2–5 açıklama, 25 karakteri aşmayan tek bir işletme adı ve en az bir logo, bir pazarlama görseli ve bir kare pazarlama görseli. Önce görselleri upload_google_ads_asset ile yükleyin ve kaynak adlarını geçin. YouTube videosu isteğe bağlıdır. Dahil etmezseniz Google reklam grubundan bir tane üretir.

Performance Max’te anahtar kelime yoktur ve manuel teklif yoktur: yalnızca dönüşümleri optimize eder. Bu yüzden kurulum, etkin dönüşüm eylemi olmayan bir hesapta, optimize edemeyecek bir kampanya yaratmak yerine reddeder ve iki çıkış yolunu da söyler: create_google_ads_conversion_action ile bir dönüşüm eylemi oluşturmak ya da buna ihtiyaç duymayan bir strateji çalıştırmak. Google Ads API v21’den beri yeni PMax kampanyalarında marka yönergeleri varsayılan olarak açıktır; bu da işletme adının ve logonun nereye bağlandığını değiştirir. Hermoso bunları sizin için kampanyaya bağlar.

Alışveriş akışı (retail) Performance Max aynı şekilde çalışır: merchantCenterId geçin, kampanya Merchant Center kataloğunuzun reklamını yapar; tek bir akışa daraltmak için feedLabel ekleyin. Yukarıdaki kampanyayla tam olarak aynı şekilde kurulur ve geri okunur. Geri okuma, Google’ın gerçekte kaydettiği Merchant Center hesabını ve akış etiketini bildirir; böylece sözümüze güvenmek yerine gerçekten bir perakende kampanyası olduğunu görebilirsiniz. Tüm akışın reklamını tek bir kök liste grubu altında yapar; akışı marka, kategori ya da özel etikete göre bölmek kurulu değildir ve sessizce yok sayılmak yerine adıyla reddedilir. Böylece akışı daraltmış sanıp daraltmamış olmazsınız.

Merchant Center: agent’ın neyi sattığını bilmesi için

“Bu ürün neden görünmüyor?” sorusuna Google Ads raporlaması yapısal olarak cevap veremez, çünkü reddedilmiş bir ürünün raporlanacak gösterimi yoktur. Cevap Merchant Center’dadır ve aynı Google bağlantısı oraya da ulaşır, ayrı bir giriş gerekmez.

Agent’ınız, bağlı Google hesabınızın erişebildiği Merchant Center hesaplarını list_merchant_accounts ile listeleyebilir (bir ajansın genellikle birkaç hesabı olur, bu yüzden tahmin etmek yerine hangi mağaza olduğunu sorar), bir akıştaki ürünleri list_merchant_products ile okuyabilir (bir alışveriş ya da perakende Performance Max kampanyasının gerçekte sunduğu katalog) ve Google’ın hesap düzeyinde kaydettiği sorunları list_merchant_issues ile okuyabilir. Bu, gerçekten var olan ürünler ve gerçekten canlı olan fiyatlar hakkında reklam metni yazmak ve sessiz kalan bir kampanyayı açıklamak için yeterlidir.

Yazma işlemleri de yapar. create_merchant_data_source bir API ürün akışı oluşturur, upsert_merchant_product akışa bir ürün koyar, update_merchant_product her gün değişen alanları (fiyat ve stok durumu) günceller; delete_merchant_product ve delete_merchant_data_source ise onay ister. list_merchant_data_sources, hangi akışların gerçekten yazmayı kabul ettiğini gösterir.

Başlamadan bilmeniz gereken üç şey var. Google, Hermoso’nun Cloud projesi Merchant Center hesabınıza kaydedilene kadar her Merchant API çağrısını engeller; register_merchant_developer bu bağlantıyı bir kez kurar ve bunu adıyla söyler. Bu bozuk bir bağlantı değildir ve yeniden bağlanmak bunu düzeltmez. Ürün yazmaları yalnızca bir API veri kaynağına gider: dosya akışları, otomatik akışlar ve Merchant Center’ın kendi arayüzünün oluşturduğu akış normalde listelenir ama hepsi yazmayı reddeder. Bu yüzden Hermoso sizin için yazılabilir bir akış seçer, yoksa oluşturur ve birden fazla varsa, kampanyalarınızın hedeflemeyebileceği bir pazara ürününüzü koymak yerine adıyla reddeder. Ayrıca upsert_merchant_product tüm satırı yazar, update_merchant_product ise bir yamadır. İlkine korunmasını istediğiniz her alanı, ikincisine yalnızca değiştirdiğiniz alanları gönderin.

Bunların hiçbiri kataloğunuzu taşımanız gerektiği anlamına gelmez. Akış zaten Shopify’da ya da platformunuzda duruyorsa orada bırakın ve agent’ın okumasına izin verin. Yazmalar, akışın henüz kimseye ait olmadığı ya da bir fiyatı ya da stok durumunu bir sonraki senkronizasyonda değil şimdi düzeltmeniz gereken durumlar içindir.

Google Analytics 4: tıklamaların ne yaptığını görün

Google Ads raporlaması tıklamada biter. Sonra ne olduğu (oturum, kayıt, sipariş) Google Analytics’te yaşar ve aynı Google girişi oraya da ulaşır. Bu ayrı bir bağlantıdır, çünkü kendi iznini gerektirir.

Agent’ınız hangi GA4 mülkünü okuyacağını list_analytics_properties ile çözebilir. Bu önemlidir, çünkü her Analytics çağrısı sayısal bir mülk kimliği alır, sizin elinizde ise takip kodunuzdaki G-XXXXXXXXX Ölçüm Kimliği vardır. Ardından analytics_report kanal, source/medium, kampanya, açılış sayfası, ülke, cihaz ya da tarihe göre oturumları, kullanıcıları, dönüşümleri ve geliri döndürür; analytics_realtime ise şu an sitede kimin olduğunu gösterir. Yani “kampanyayı kur” ile “ne kazandırdığını söyle” aynı konuşmanın parçasıdır.

Bu araç yazar da ve bu kısım doğrudan Google Ads’e geri besler: create_analytics_key_event, GA4’ün zaten topladığı bir olayı anahtar olay olarak işaretler; Google Ads bunu dönüşüm olarak içe aktarır ve bu sayfadaki her akıllı teklif stratejisi, dönüşüm eylemi olmadan çalışamaz. create_analytics_custom_dimension raporların ona göre kırılabilmesi için bir olay parametresi kaydeder; list_analytics_definitions ise ikisini de eklemeden önce mülkün zaten neyi ölçtüğünü gösterir. Her zaman geçerli olan iki şey: bu yalnızca GA4’tür, çünkü API’nin Universal Analytics yüzeyi hiç yoktur; ve özel bir boyut arşivlenebilir ama asla silinemez, mülk başına 50 olay kapsamlı yuvası vardır, bu yüzden agent önce mevcut kümeyi kontrol eder.

Canlı harcama kapısı tek bir araçtan daha geniştir

Bir kampanyayı duraklatmak harcamadan kaçmanın tek yolu değildir ve bunu öyle sanmak gerçek bir tuzaktır: zaten etkin bir üst öğenin altında etkin bir reklam grubu, reklam ya da anahtar kelime oluşturmak bir sonraki açık artırmada yayına girer. Bu yüzden set_google_ads_status’u koruyan onay, üst öğe canlıysa create_google_ads_ad_group, create_google_ads_ad ve add_google_ads_keywords’u da korur. Bu kontrol, bu araçların zaten çektiği satırdan okunur, ek bir gidiş dönüş gerekmez. Negatif anahtar kelimeler yalnızca harcamayı kısıtlar, bu yüzden hiçbir zaman kapıya takılmaz.

GAQL raporlaması ve bilmeniz gereken bir uyarı

google_ads_report serbest GAQL kabul eder; agent’ınız sabit bir rapor biçimine sıkışmak yerine ihtiyaç duyduğu dilimi isteyebilir. Sorguları elle yazıyorsanız ya da bir modelin yazmasına izin veriyorsanız aklınızda bulundurmanız gereken bir şey: GAQL, SQL değildir. Alt sorguları yoktur ve IN sabit bir liste alır. WHERE id IN (SELECT …) geçersizdir ve yanlış satırları sessizce döndürmek yerine başarısız olur. Sonucu create_sheet ve append_to_sheet ile doğrudan bir tabloya ya da create_doc ile bir dokümana aktarın.

Geri okuyun, sonra raporlayın

Mutate işleminden sonra ağaç Google’dan geri okunur ve size verilen özet, istenenden değil geri okumadan oluşturulur. Bu küçük bir disiplindir ve agent’ın bir kampanyayı Google’ın aslında zorla değiştirdiği ya da reddettiği hâliyle, özgüvenle anlatmasını yakalar.

Sormadan yapmayacakları

Bütçesi olan bir agent yalnızca harcama yetkisi sınırlandığında işe yarar; bu yüzden harcama yetkisi bir istemde değil, sunucuda sınırlandırılır. Meta kampanyaları, reklam setleri ve reklamlar hiçbir çağıran geçersiz kılmasıyla olmadan PAUSED olarak oluşturulur. Gerçek reklam harcamasını açabilen durum anahtarları (her reklam platformunda birer tane: 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 ve set_openai_ads_status bunlardan birkaçı) açık bir onay bayrağı olmadan çalışmayı reddeder ve aynı kapı, zaten etkin bir üst öğe altında etkin bir Google Ads reklam grubu, reklamı ya da anahtar kelimesi oluşturmayı da kapsar, çünkü bu bir sonraki açık artırmada yayına girer. Silmeler de onay ister. Üretim tarafında hermoso_capabilities her modelin tam kredi maliyetini bir şey çalışmadan önce yayınlar ve her render bir tahmini ayırır, sonra gerçek maliyeti öder; böylece başarısız bir gönderim sessizce sizden para almak yerine geri öder.

Google Ads hesabınızı bağlamak

Google Ads’i Hermoso’ya Google’ın kendi OAuth akışıyla, Bağlantılar ayarlarından bağlarsınız; model üzerinden hiçbir parola geçmez. Google Ads bağlantıları marka düzeyinde paylaşılır, böylece bir markadaki tüm ekip tek bir bağlantıyla çalışır ve herkes ayrı ayrı yeniden yetkilendirmek zorunda kalmaz.

Yaratıcı kısım

Kampanya yönetimi, yayınlanacak bir şey olduğunda işe yarar. Aynı sunucu, Meta, Google ve LinkedIn reklam kütüphanelerinde pazarınızda neyin işe yaradığını araştırır, gerçek ürününüzde temellenen bitmiş görsel ve video yaratıcıları 100’den fazla modelle üretir ve varlıkları yükler; böylece “ne yayınlayalım” ile “kur onu” iki ayrı araç yerine tek bir konuşmadır. Bkz. pazarlama MCP genel bakışı, tam araç listesi ya da ikisini de çalıştırıyorsanız Meta Ads MCP.

Sık sorulanlar

Google Ads için bir MCP sunucusu var mı?

Evet. Hermoso’nun MCP sunucusu, herhangi bir MCP istemcisinden Google Ads kurar ve yönetir: bir arama ya da görüntülü ağacı kurmak için create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad ve add_google_ads_keywords; Performance Max için create_google_ads_performance_max_campaign; yapılandırmak için set_google_ads_budget, set_google_ads_bidding ve set_google_ads_targeting; Keyword Planner araştırması için google_ads_keyword_ideas; raporlama için list_google_ads_campaigns ve google_ads_report; alışveriş kampanyasının arkasındaki ürün akışı için Merchant Center okumaları; etkinleştirmek için onay kapılı set_google_ads_status.

Bir AI agent Google Ads kampanyası oluşturabilir mi?

Evet; tüm ağaç tek bir atomik işlemde, geçici kaynak kimlikleri kullanılarak oluşturulur: kampanya, reklam grubu, responsive arama ya da görüntülü reklam ve anahtar kelimeler birlikte. Reklam reddedilirse bütçe de oluşturulmamış olur, yani yetim nesneleri temizlemek zorunda kalmazsınız. Bir deneme modu, hiçbir şey oluşturmadan tüm ağacı canlı API’ye karşı doğrular.

Performance Max kampanyası oluşturabilir mi?

Evet. create_google_ads_performance_max_campaign bütçeyi, kampanyayı, hedeflemeyi, reklam grubunu ve her varlık bağlantısını tek atomik işlemde kurar; çünkü Google bunların birlikte gelmesini ister. Kampanya duraklatılmış oluşturulur ve agent bunu bildirmeden önce geri okunur. Google’ın varlık asgarileri göndermeden önce uygulanır: 3–15 başlık, 1–5 uzun başlık, 2–5 açıklama, bir işletme adı ve en az bir logo, pazarlama görseli ve kare pazarlama görseli. PMax yalnızca dönüşümlere teklif verir, bu yüzden etkin dönüşüm eylemi olmayan bir hesapta optimize edemeyecek bir kampanya oluşturmak yerine kurulumu reddeder. Alışveriş akışlı (perakende) PMax da aynı şekilde çalışır: merchantCenterId geçin, kampanya Merchant Center kataloğunuzun reklamını yapar, bir akışı daraltmak için feedLabel ekleyin ve geri okuma Google’ın gerçekte kaydettiği Merchant Center hesabını ve akış etiketini bildirir.

Google Merchant Center ile çalışır mı?

Evet, okur ve yazar, aynı Google bağlantısı üzerinden. Agent, hesabınızın erişebildiği Merchant Center hesaplarını listeleyebilir, bir akıştaki ürünleri (bir alışveriş ya da perakende Performance Max kampanyasının gerçekte sunduğu katalog) okuyabilir ve Google’ın hesap düzeyinde kaydettiği sorunları okuyabilir; bir ürünün neden görünmediğini öğrenebileceğiniz tek yer burasıdır, çünkü reddedilmiş bir ürünün Google Ads raporlamasında gösterimi yoktur. Bir kez yapılması gereken bir kayıt da vardır: Hermoso’nun Cloud projesi Merchant Center hesabınıza bağlanmadan API yanıt vermez ve bunu yapan bir araç vardır. Yazar da: create_merchant_data_source, günlük değişen fiyat ve stok durumu için upsert_merchant_product ve update_merchant_product, ayrıca onay kapılı delete_merchant_product ve delete_merchant_data_source. Google ürün yazmalarını yalnızca bir API veri akışına kabul eder; bu yüzden Hermoso yazılabilir bir akış seçer ve birden fazla varsa adıyla reddeder.

Anahtar kelime araştırması yapabilir mi?

Evet. google_ads_keyword_ideas, Google’ın Keyword Planner’ını çağırır ve anahtar kelimelerden, bir açılış sayfası URL’sinden ya da bütün bir siteden yola çıkarak gerçek aylık arama hacimlerini, rekabeti ve sayfanın en üstü için teklif aralıklarını döndürür. Agent bunları doğrudan add_google_ads_keywords’e aktarabilir ya da bir Google Sheet’e yazabilir.

Google Ads bütçemi harcamaya başlayabilir mi?

Yalnızca açık onayla. set_google_ads_status gerçek parayı açan anahtardır; zaten etkin bir üst öğe altında etkin bir alt öğe oluşturmak bir sonraki açık artırmada yayına girdiği için, aynı onay üst öğe canlıysa create_google_ads_ad_group, create_google_ads_ad ve add_google_ads_keywords’ü de korur. Negatif anahtar kelimeler yalnızca harcamayı kısıtlar ve hiçbir zaman kapıya takılmaz.

Rapor çalıştırabilir mi?

Evet. google_ads_report serbest GAQL alır, bu yüzden agent ihtiyaç duyduğu dilimi isteyebilir. GAQL’ın SQL olmadığını unutmayın: alt sorgusu yoktur ve IN sabit bir liste alır, bu yüzden bir WHERE id IN (SELECT …) geçersizdir. Sonuçlar doğrudan bir Google Sheet ya da Doc’a yazılabilir.

Hangi teklif ve hedeflemeyi ayarlayabilir?

Altı teklif stratejisi, kampanya programı ve coğrafi ile dil hedeflemesi; konumları adla çözmek için find_google_ads_locations. Bütçeler set_google_ads_budget ile ayarlanır; anahtar kelimeler negatifleri ve anahtar kelime başına CPC’yi destekler.

Agent Google hesabımın parolasını alır mı?

Hayır. Google Ads’i Hermoso’nun Bağlantılar ayarlarında Google’ın kendi OAuth akışıyla bağlarsınız; Hermoso ortaya çıkan belirteci tutar. Agent yalnızca Hermoso’nun araçlarını çağırır. Google Ads bağlantıları marka düzeyinde paylaşılır, böylece bir ekip tek bir bağlantıyla çalışır.

Reklam yaratıcısını da yapabilir mi?

Evet. Aynı sunucu rakip reklamları araştırır, konsepti planlar, gerçek ürününüzle birleştirilmiş bitmiş görsel ve video yaratıcıları 100’den fazla modelle üretir ve upload_google_ads_asset ile varlıkları yükler; böylece araştırma, yaratıcı ve kampanya kurulumu tek bir konuşmada olur.