Google Ads API aracısı becerileri

Google Ads API aracı becerileri, Google Ads API'ye özgü bilgi, talimat ve iş akışlarından oluşan taşınabilir ve bağımsız modüllerdir. Google Ads API aracı becerileri, Google Antigravity ve Claude Code dahil olmak üzere açık Aracı Becerileri standardını destekleyen yapay zeka asistanlarıyla çalışır.

Bu ajan becerileri, yapay zeka asistanlarının Google Ads API ile ilgili en iyi uygulamaları anlamasına, araçları yapılandırmasına ve iş akışlarını daha yüksek doğruluk ve daha düşük jeton maliyetiyle yürütmesine yardımcı olmak için tasarlanmıştır. Kullanılabilir becerilerin listesi için Kullanılabilir beceriler başlıklı makaleye bakın.

Başlayın

Geliştirme ortamınıza uygun temsilci becerilerini yükleyin.

Google Ads API temsilci becerilerini yükleme

Çoğu durumda, Google Ads API temsilci becerileri tercih ettiğiniz düzenleyiciye tek bir komutla yüklenebilir:

Antigravity

Google Ads API aracı becerileri, Antigravity için Build with Google entegrasyon paketlerinden biri olarak sunulur. Bu paketi iki noktada global düzeyde erişim için etkinleştirebilirsiniz:

  • İlk katılım sırasında: Google Ads API yığını onay kutusunu işaretleyin.
  • Ayarlar'da:
    1. Ayarlar > Özelleştirmeler'e gidin.
    2. Build with Google Plugins (Google Eklentileriyle Oluşturun) bölümünde Customize'ı (Özelleştir) ve ardından Google Ads API entegrasyonu için Download'u (İndir) tıklayın.

Proje düzeyinde erişimi tercih ediyorsanız projenizin dizininde aşağıdaki komutu çalıştırın:

npx skills add google/skills/skills/ads --agent=antigravity

Claude Code 

npx skills add google/skills/skills/ads --agent=claude-code

Codex 

npx skills add google/skills/skills/ads --agent=codex

İmleç

Google Ads API aracı becerilerini, becerinin GitHub deposu uç noktasını (ör. https://github.com/google/skills) düzenleyicinizin ayarlarındaki özel kurallar bölümüne ekleyerek doğrudan yükleyebilirsiniz. Daha fazla bilgi için GitHub'dan beceri yüklemeyle ilgili Cursor belgelerine bakın.

Becerileri npx kullanarak da yükleyebilirsiniz (Node.js gerekir):

npx skills add google/skills/skills/ads --agent=cursor

Diğer temsilciler

Açık Agent Skills standardını destekleyen diğer yapay zeka asistanları için npx kullanarak becerileri yükleyebilirsiniz (Node.js gerekir):

npx skills add google/skills/skills/ads

Google Ads API temsilci becerilerini güncelleme

Mevcut tüm güncellemeleri almak ve güncel olmayan becerileri temizlemek için update komutunu çalıştırabilirsiniz:

Antigravity

Build with Google aracılığıyla etkinleştirilen entegrasyonlar, düzenleyici tarafından otomatik olarak yönetilir ve güncellenir.

Aracı becerilerini npx komutunu kullanarak yüklediyseniz update komutunu çalıştırarak mevcut tüm güncellemeleri alabilirsiniz:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

İmleç 

npx skills update --all

Diğer temsilciler

Açık Temsilci Becerileri standardını destekleyen diğer yapay zeka asistanları için npx kullanarak tüm etkin becerileri güncelleyebilirsiniz:

npx skills update --all

Google Ads API aracı becerilerini kullanma

Yapay zeka asistanları, bir becerinin açıklamasının mevcut isteğinizle eşleştiğini algıladıklarında becerileri otomatik olarak kullanacak şekilde tasarlanmıştır. Global olarak yüklenen beceriler, istem bağlamınız Google Ads API görevleriyle eşleşmediği sürece alakasız projelerde etkinleştirilmez.

Beceriler, temsilci sohbetine / yazıp beceri adı aranarak manuel olarak da çağrılabilir.

Becerinin temel bileşenleri

Her temsilci becerisi, yapay zeka asistanına aşağıdaki bileşenleri sağlayan özel bir pakettir:

  • Özel talimatlar: GAQL sorguları oluşturma, OAuth kimlik bilgilerini yapılandırma ve yaygın hata kodlarını işleme konusunda asistana yol göstermek için bağlam penceresine eklenen ayrıntılı istem talimatları.
  • En iyi uygulamalar: Google Ads API DevRel ekibi tarafından tanımlanan standart performans, güvenlik ve entegrasyon önerileri.
  • Otomasyon komut dosyaları: Görevleri yerel olarak yürütmek için beceri paketlerine dahil edilen yürütülebilir komut dosyaları (ör. ortam doğrulama veya çalışma alanı kurulumu için).

Becerileri kullanmanın avantajları

Temsilci becerileri, her sohbete büyük talimatlar yükleme zahmetine girmeden, asistanın yeteneklerini isteğe bağlı olarak özel bilgilerle genişletir.

Daha düşük jeton maliyetleri

Geleneksel yapay zeka entegrasyonları genellikle başlangıçta büyük miktarda belge yükler. Bu da önemli miktarda jeton tüketir ve oturum maliyetlerini artırır. Temsilci becerileri, bu ek yükü en aza indirmek için kademeli açıklama yöntemini kullanır:

  • Yapay zeka asistanı, isteğinizle alakalı olup olmadığını görmek için başlangıçta yalnızca becerinin adını ve açıklamasını kontrol eder.
  • Asistan, becerinin tüm talimatlarını ve referanslarını yalnızca göreviniz için gerekli olduğunu belirlediğinde etkin bağlam penceresine ekler. Bu sayede bağlam alanından tasarruf edilir.

Yapay zeka destekli uygulama

Dokümanları manuel olarak aramak yerine amacınızı doğal dille açıklayabilirsiniz. Beceriler, yapay zeka asistanınıza aşağıdaki gibi görevleri yerine getirmesi için yol gösterir:

  • Hesabımdan kampanya performansı metriklerini almak için GAQL sorgusu oluşturun.
  • Yeni bir kampanya oluşturmak için istemci kitaplıklarını kullanan bir Python komut dosyası yazın.
  • Google Ads API'yi kullanarak kampanya dönüşümlerini ve teşhis verilerini alma.

Kullanılabilir becerilerin tam listesi için Kullanılabilir beceriler başlıklı makaleyi inceleyin.

Google Ads API MCP sunucusuyla birlikte becerileri kullanma

Temsilci becerileri, Google Ads API Model Bağlam Protokolü (MCP) sunucusunu tamamlayacak şekilde tasarlanmıştır:

  • Google Ads API MCP sunucusu: Yapay zeka destekli geliştirme iş akışları için tasarlanmıştır. Yapay zeka asistanlarının Google Ads API kaynaklarınız, kampanyalarınız ve metriklerinizle programatik olarak etkileşim kurmasını sağlar.
  • Google Ads API aracı becerileri: Bir asistana, görevleri jeton açısından verimli ve aşamalı olarak açıklayarak gerçekleştirmesi için yol gösteren istem talimatları ve önerilen uygulamalar sağlar. Bu talimatlar, ajana MCP sunucusu ve istemci kitaplıkları gibi araçların nasıl etkili bir şekilde kullanılacağı konusunda yol gösterir.

Kullanılabilir beceriler

Google Ads API ekibi, Google Ads API ile geliştirme yapmak için bir dizi beceri sunar:

Beceri Açıklama
google-ads-api-account-diagnostics Google Ads API MCP sunucusunu kullanarak dönüşüm kaybı, düşük potansiyel müşteri hacmi ve reklam sıralaması, teklifler veya bütçeler nedeniyle kaybedilen gösterim payı gibi Google Ads hesabı performans sorunlarını teşhis eder.
google-ads-api-mcp-setup Google Ads API Model Context Protocol (MCP) sunucusunun kurulumu ve yapılandırılmasına yardımcı olarak yerel ortamlarda kimlik doğrulama ve yapılandırmayı basitleştirir.
google-ads-api-quickstart Geliştirme ortamınızı ayarlama, kimlik bilgilerini yapılandırma ve Google Ads API'ye ilk API çağrınızı yapma konusunda size yol gösterir.

Sonraki adımlar