Google Ads API aracısı becerileri

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

Bu temsilci 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 bölümüne 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 temsilci becerileri, Antigravity için Build with Google entegrasyon paketlerinden biri olarak dahil edilmiştir. 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ını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 temsilci becerilerini, becerinin GitHub depo uç noktasını (ör. https://github.com/google/skills) düzenleyicinizin ayarlarındaki özel kurallara 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.

Temsilci 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 temsilci becerilerini kullanma

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

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

Bir 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 bir GAQL sorgusu oluştur.
  • 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 temsilci becerileri: Jeton açısından verimli aşamalı açıklama yoluyla bir asistanın görevleri yerine getirmesine yardımcı olan istem talimatları ve önerilen uygulamalar sağlar. Temsilciye, MCP sunucusu ve istemci kitaplıkları gibi araçları etkili bir şekilde nasıl kullanacağını gösterirler.

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 kurulumuna 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ştirici 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