Google Ads API Geliştirici Asistanı'nı yükleme ve kullanma

Ön koşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  1. Google Ads API Erişimi:

  2. Yazılım:

    • Python 3.10 veya sonraki sürümler. Varsayılan dil Python olduğundan bu dili yüklemiş ve yolunuza eklemiş olmanız gerekir.
    • Google Antigravity komut satırı aracı yüklü olmalıdır.
    • jq (komut satırı JSON işlemcisi). Yükleme komut dosyası, eksikse bunu yüklemeyi dener.

  3. Depo:

Başlayın

  1. Proje dizinine gidin:

    cd <full path>/google-ads-api-developer-assistant

    (Not: Antigravity kabuk entegrasyonu etkinse bu dizine girdiğinizde asistan oturumu otomatik olarak başlatılır).

  2. Yükleme komut dosyasını çalıştırın: Bu komut dosyası, geliştirme ortamını başlatır ve gerekli Google Ads istemci kitaplıklarını klonlar (Python varsayılan olarak yüklenir).

    ./install.sh

    Windows kullanıyorsanız install.ps1 PowerShell komut dosyasını çalıştırın.

  3. Kimlik bilgilerini yapılandırın: google-ads.yaml (veya dil eşdeğeri) dosyanızın ana dizininize yerleştirildiğinden emin olun.

  4. Asistan ile etkileşim kurma: Oturum etkin olduktan sonra doğrudan terminalinizde doğal dil kullanarak Asistan ile etkileşim kurabilirsiniz.

Temel özellikler

  • Doğal dil soru-cevap: Google Ads API özellikleri, en iyi uygulamalar veya belirli kaynaklar hakkında sorular sorun.

    • "Mevcut kampanya türleri nelerdir?"
    • "GAQL'de tarihe göre nasıl filtreleme yaparım?"
    • "click_view ile impression_view arasındaki farkı açıkla."

  • Kod oluşturma: GAQL sorguları ve çalıştırılabilir Python kodu snippet'leri oluşturun.

    • "Son 30 günde en çok dönüşüm elde eden kampanyaları göster."
    • "12345 kampanya kimliği için etkinleştirilmiş tüm reklam grubu adlarını al."
    • "Tüm kampanyalardaki onaylanmayan reklamları bulun." Oluşturulan kod, ruff kullanılarak otomatik olarak lintlenir ve saved/code/ dizinine kaydedilir.

  • Doğrudan API yürütme: Oluşturulan salt okunur Python komut dosyalarını doğrudan yalıtılmış bir sanal ortamda (.venv) çalıştırın ve biçimlendirilmiş sonuçları terminalinizde tablo olarak görüntüleyin.

    • Asistan'a "Kodu çalıştır" veya "Komut dosyasını yürüt" demeniz yeterlidir.
    • Güvenlik nedeniyle, değiştirme işlemleri (oluşturma, güncelleme, silme) oluşturulur ancak hiçbir zaman yürütülmez.

  • CSV dışa aktarma: API çağrılarından elde edilen tablo biçimindeki sonuçları CSV dosyasına kaydedin.

    • "Sonuçları bir CSV dosyasına kaydedin." Dosyalar saved/csv/ dizinine kaydedilir.

  • Gelişmiş teşhis ve sorun giderme: Hata mesajları, beklenmedik API davranışı veya çevrimdışı dönüşüm sorunlarıyla ilgili yardım alın.

    • "Sorgumla ilgili neden sonuç göremiyorum?"
    • "123-456-7890 numaralı müşteri için dönüşümlerimle ilgili sorunları gider." (saved/data/ içinde ayrıntılı bir teşhis raporu oluşturur.)

  • Ek bağlam: Bağlam için kendi kod tabanınızı veya özel kitaplıklarınızı ekleyin.

    • Proje dosyalarınızı kaydetmek için update.sh komut dosyasını --context_path seçeneğiyle kullanın: none ./update.sh --context_path /path/to/your/codebase
    • Bu sayede Asistan, yanıt oluştururken veya tercih ettiğiniz dilde kod üretirken uygulama mantığınızı da değerlendirebilir.

Örnek kullanım alanları

  • Raporlama:
    • "12345678 numaralı müşteri için geçen ay maliyete göre ilk 5 anahtar kelimeyi göster."
  • Hesap yapısı:
    • "Tüm kampanya adlarını ve kimliklerini listele."
  • Sorun giderme:
    • "100 dönüşüm yükledim ancak kullanıcı arayüzünde yalnızca 78 dönüşüm görünüyor. API'yi kullanarak bu sorunu nasıl ayıklayabilirim?"
  • Öğrenme:
    • "/explain what a shared set is" (Paylaşılan kümenin ne olduğunu açıkla)
  • Kod üretme:
    • "company name için Maksimum Performans kampanyası oluşturmak üzere kod yaz."

Topluluk ve destek

Katkıda bulunma yönergeleri

Katkılarınızı bekliyoruz. Yönergeler için GitHub deposundaki CONTRIBUTING.md dosyasına bakın.

Önceki
Google Ads API Geliştirici Asistanı nedir?