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 (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:
- 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 arasında ç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 çalışma 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ştirmenize yardımcı olacak 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 entegre etmek 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 deneyimli bir geliştiriciyim ancak kendi yazılım altyapımı yönetmeyi tercih etmiyorum. | Google Ads komut dosyalarını kullanma | Google Ads içinde 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 planlama ile OAuth2 arka plan yetkilendirmesi. |
| İç içe yerleştirilmiş Google Ads hesaplarıma programatik olarak erişmek istiyorum. | Tek bir komut dosyasından reklam yayınlayan alt hesaplara 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 harici REST API'leri için UrlFetchApp.
|
| Daha ayrıntılı analiz için Google Ads raporlarını indirmek isteyen bir veri analistiyim (veya benzer bir roldeyim). | 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 kodsuz masaüstü veya kullanıcı arayüzü araçları. |
Ön koşullar
Yalnızca giriş seviyesinde JavaScript bilgisi gerekir. IDE; söz dizimi vurgulama, otomatik tamamlama ve önizleme konusunda yardımcı olur. İlk komut dosyanızı yazmaya başlamak için tek ihtiyacınız olan 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 performans metriklerini sorgulamak, kampanya oluşturup değiştirmek, teklifleri ve bütçeleri güncellemek ve sunucu yapılandırmadan, OAuth jetonlarını yönetmeden veya altyapı için ödeme yapmadan 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 kullanarak 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, kendi sunucularınızda çalışan ve özel geliştirici jetonları ile OAuth kimlik bilgileri gerektiren daha büyük ölçekli kurumsal uygulamalar, üçüncü taraf araçları ve yüksek hacimli veri ardışık düzenleri için tasarlanmış bir REST ve gRPC API'dir.
Google Ads komut dosyalarını çalıştırmak için bir 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ı, her yürütme için 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, iptal işleminden önce yapılan değişiklikleri uygular. Zaman aşımları, kotalar ve toplu yükleme sınırları hakkında 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'ı okumak ve yazmak için SpreadsheetApp, harici REST API'lerine HTTP istekleri göndermek 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'dan bize ulaşın.
Desteğe ihtiyacınız varsa komut dosyaları teknik destek ekibiyle iletişime geçin.