Google Ads komut dosyaları, tarayıcı tabanlı bir IDE'de modern JavaScript (ES6+) kullanarak Google Ads reklam verilerinizi programatik olarak yönetmenize ve sorgulamanıza olanak tanıyan sunucusuz bir otomasyon platformu sağlar. Google Ads komut dosyalarıyla, sunucu sağlamaya veya geliştirici kimlik bilgilerini yönetmeye gerek kalmadan rutin hesap yönetimi iş akışlarını otomatikleştirebilir, özel raporlar oluşturabilir ve Google Ads'i harici veri kaynaklarıyla (tek bir hesapta veya binlerce hesapta) entegre edebilirsiniz.
Google Ads'in çoğu özelliği, mutate ve search çağrıları aracılığıyla Google Ads komut dosyalarında kullanılabilir. Komut dosyalarını kullanarak şunları yapabilirsiniz:
- Kampanyaları, reklam gruplarını, anahtar kelimeleri ve reklamları yönetme
- Teklifleri, bütçeleri ve durumu gerçek zamanlı performansa veya harici verilere göre ayarlayın.
- Özel raporlar ve kontrol panelleri oluşturmak için Google Ads Sorgu Dili'ni (GAQL) kullanarak sorgular çalıştırın.
- Otomatik yürütmeleri saatlik, günlük, haftalık, aylık veya isteğe bağlı olarak çalışacak şekilde planlayın.
- Yönetici komut dosyalarını kullanarak alt hesaplar genelinde çoklu hesap işlemlerini koordine edin.
- Google Workspace hizmetlerine (ör. E-Tablolar ve Drive), Google Cloud hizmetlerine (ör. BigQuery) ve üçüncü taraf API'lerine bağlanın.
Komut dosyaları, yerleşik varlık seçiciler ve raporlar da içerir.
Temel teknik özellikler
Aşağıdaki teknik özellikler, Google Ads komut dosyalarının yürütme ortamını ve operasyonel sınırlarını tanımlar:
| Spesifikasyon | Tek hesap komut dosyası | Yönetici hesabı komut dosyası |
|---|---|---|
| Yürütme zaman aşımı | Maksimum 30 dakika |
executeInParallel ve geri arama ile 60 dakikaya kadar
(standart 30 dakika)
|
| Çalışma zamanı motoru | V8 JavaScript çalışma zamanı (ECMAScript 6+) | V8 JavaScript çalışma zamanı (ECMAScript 6+) |
| Öğe yineleyici sınırı | Yineleyici başına varsayılan olarak 50.000 öğe (raporlar ve arama sorguları hariçtir) | Alt hesap başına 50.000 öğe (raporlar ve arama sorguları hariçtir) |
| Paralel hesaplar | Yok (1 hesap) | Aynı anda 50 hesap |
| Toplu yükleme sınırı | 50 MB dosya boyutu, 1.000.000 satır | 50 MB dosya boyutu, 1.000.000 satır |
| Yetkili komut dosyaları | Kullanıcı başına en fazla 250 yetkili komut dosyası | Kullanıcı başına en fazla 250 yetkili komut dosyası |
| Barındırma ve altyapı | Google tarafından tümüyle yönetilir (sunucusuz) | Google tarafından tümüyle yönetilir (sunucusuz) |
Daha fazla bilgi için Sınırlar bölümüne bakın.
Google Ads komut dosyaları benim için doğru ürün mü?
Google, Google Ads hesaplarını otomatikleştirmeye yardımcı olan birden fazla ürün sunar. Aşağıdaki tabloda, ihtiyaçlarınıza uygun ürünü seçmenize yardımcı olacak yaygın senaryolar ve öneriler özetlenmektedir:
| Senaryo | Öneri | Başlıca özellikler |
|---|---|---|
| Kendi yazılım ürünümü oluşturmak veya Google Ads API ile entegrasyon yapmak isteyen bir geliştiriciyim. Kod yazma, sunucular ve veritabanları dahil olmak üzere yazılım altyapısını yönetme konusunda kendime güveniyorum. | Google Ads API'yi kullanın. | Tam API kontrolü, daha yüksek işleme hızı, özel barındırma ve OAuth yönetimi. |
| Kod yazma konusunda rahat olan bir geliştiriciyim ancak kendi yazılım altyapımı yönetmeyi tercih etmiyorum. | Google Ads komut dosyalarını kullanma | Google Ads'de sunucusuz yürütme, otomatik planlama, tarayıcı tabanlı IDE. |
| Geliştirici değilim ancak Google Ads'i otomatikleştirmek için programlama öğrenmeye zaman ayırabilirim. | Google Ads komut dosyalarını kullanma | Basit JavaScript söz dizimi, önceden oluşturulmuş komut dosyası şablonları, IDE otomatik tamamlama ve söz dizimi vurgulama. |
| Video kampanyalarını programatik olarak yönetmek istiyorum. | Google Ads komut dosyalarını kullanın. |
AdsApp.videoCampaigns() kullanarak doğrudan video kampanyası yönetimi.
|
| Görevleri, etkin bir kullanıcı oturumu olmadan çalışacak şekilde planlamak istiyorum. | Google Ads komut dosyalarını kullanma | Saatlik, günlük, haftalık veya aylık otomatik planlamayla OAuth2 arka plan yetkilendirmesi. |
| İç içe yerleştirilmiş Google Ads hesaplarıma programatik olarak erişmek istiyorum. | Yayın yapan alt hesaplara tek bir komut dosyasından erişmek için yönetici komut dosyalarını kullanın. |
Alt hesaplar arasında sıralı iterasyon veya executeInParallel kullanarak 50'ye kadar alt hesapta paralel yürütme.
|
| Google'a ait veya üçüncü taraf API'leri Google Ads yönetimime entegre etmek istiyorum. | Google Ads komut dosyalarıyla Google API'lerini veya üçüncü taraf API'lerini kullanma |
Yerleşik Google Workspace hizmetleri (E-Tablolar, Drive, Mail), gelişmiş Google API'leri (BigQuery, Analytics, YouTube) ve UrlFetchApp harici REST API'leri.
|
| Daha ayrıntılı analiz için Google Ads raporlarını indirmek isteyen bir veri analistiyim (veya benzer bir rolde çalışıyorum). | Google Ads için BigQuery Veri Aktarım Hizmeti'ni kullanın. | Google Ads reklam verilerini kod kullanmadan BigQuery'ye aktarmak için planlanmış otomatik ardışık düzen. |
| Google Ads'i toplu olarak yönetmek istiyorum ve kod yazmak benim için sorun değil. | Google Ads komut dosyalarıyla toplu yüklemeleri kullanın. | 1.000.000 satıra kadar destekleyen programatik CSV veya e-tablo yükleme. |
| Google Ads'i toplu olarak yönetmek istiyorum ancak kod yazmak istemiyorum. | Otomatik kuralları, toplu yüklemeleri veya Google Ads Editor'ı kullanın. | Toplu güncellemeler ve planlanmış kurallar için kodlama gerektirmeyen masaüstü veya kullanıcı arayüzü araçları. |
Ön koşullar
Yalnızca giriş seviyesinde JavaScript bilgisi yeterlidir. IDE; söz dizimi vurgulama, otomatik tamamlama ve önizleme konusunda yardımcı olur. İlk komut dosyanızı yazmaya başlamak için ihtiyacınız olan tek şey bir Google Ads hesabıdır.
Sık sorulan sorular
Google Ads komut dosyaları mimarisi, yürütme sınırları ve entegrasyonlar hakkında sık sorulan soruların yanıtlarını bulun.
Google Ads komut dosyaları nedir?
Google Ads komut dosyaları, Google Ads içinde sunucusuz bir otomasyon ortamı sağlar. Reklamverenlerin ve geliştiricilerin sunucu yapılandırmadan, OAuth jetonlarını yönetmeden veya altyapı için ödeme yapmadan performans metriklerini sorgulamak, kampanya oluşturup değiştirmek, teklifleri ve bütçeleri güncellemek ve harici API'lere bağlanmak için JavaScript kodu yazmasına olanak tanır.
Google Ads komut dosyalarının Google Ads API'den farkı nedir?
Google Ads komut dosyaları, JavaScript kullanılarak doğrudan Google Ads hesabınızda çalışır, sunucu altyapısı gerektirmez ve yetkilendirmeyi tarayıcıda otomatik olarak gerçekleştirir. Google Ads API, daha büyük ölçekli kurumsal uygulamalar, üçüncü taraf araçları ve kendi sunucularınızda çalışan, yüksek hacimli veri işlem hatları için tasarlanmış bir REST ve gRPC API'sidir. Bu API, özel geliştirici jetonları ve OAuth kimlik bilgileri gerektirir.
Google Ads komut dosyalarını çalıştırmak için sunucuya ihtiyacım var mı?
Hayır. Google Ads komut dosyaları, ek ücret ödemeden tamamen Google'ın bulut altyapısında çalışır. Komut dosyaları yazabilir, bunları önizleme modu ile test edebilir ve doğrudan Google Ads web arayüzünde planlayabilirsiniz.
Google Ads komut dosyaları için yürütme sınırları nelerdir?
Bireysel hesaplardaki standart komut dosyaları, yürütme başına en fazla 30 dakika çalışabilir. executeInParallel kullanan yönetici hesabı komut dosyaları, 50 alt hesapta 60 dakikaya kadar yürütülebilir (geri çağırma işlevi belirtildiğinde). Bir komut dosyası zaman aşımına uğrarsa Google Ads, iptalden önce yapılan değişiklikleri yine de uygular. Zaman aşımları, kotalar ve toplu yükleme sınırlarıyla ilgili tüm ayrıntılar için Sınırlar bölümüne bakın.
Google Ads komut dosyaları harici API'lere bağlanabilir mi?
Evet. Google Ads komut dosyaları, Google E-Tabloları okuma ve yazma için SpreadsheetApp, harici REST API'lerine HTTP istekleri gönderme için UrlFetchApp ve BigQuery ile YouTube gibi hizmetlerle entegrasyon için Gelişmiş Google API'leri gibi yerleşik hizmetler içerir. Daha fazla bilgi için Üçüncü taraf API'leri ve Gelişmiş Google API'leri başlıklı makaleleri inceleyin.
Geri bildirim
Google Ads komut dosyalarıyla ilgili geri bildirimlerinizi bizimle paylaşabilirsiniz. Discord'da bize ulaşın.
Desteğe ihtiyacınız varsa komut dosyaları teknik destek ekibiyle iletişime geçin.