Yeni Google Ads komut dosyası altyapısı Google Ads API'yi temel alır. İlgili API'nin farklı mimarisi nedeniyle mevcut komut dosyalarınızı güncellemeniz gerekebilir. Geriye dönük uyumluluğu mümkün olduğunca sağlamak için mümkün olan her türlü çabayı gösterdik. Bu nedenle, bu değişiklikler önemsizdir.
Raporlar
Birçok AWQL raporu çalışmaya devam edecektir. Perde arkasında, yeni altyapıyı kullanırken, komut dosyaları AWQL sorgunuzu GAQL'ye (Google Ads API'nin yeni sorgu dili) dönüştürür, yeni arka uçla karşılaştırır ve ardından sonuçları tekrar AWQL raporlarında kullanılan biçime dönüştürür. GAQL içeren sorgular olduğu gibi aktarılır.
Bu ek yük nedeniyle, komut dosyalarınızı gözden geçirmenizi ve AWQL sorgularını mümkün olduğunda GAQL olarak güncellemenizi öneririz. Belirli bir AWQL sorgusu için GAQL sorgusunu belirlemek için komut dosyalarıyla aynı mantığı kullanan sorgu taşıma aracını veya sorgular oluşturmanıza yardımcı olması için etkileşimli sorgu oluşturucuyu kullanabilirsiniz.
Otomatik AWQL'den GAQL'ye çeviriyle ilgili bazı sınırlamaları aşağıda bulabilirsiniz:
- Tüm AWQL sorguları, GAQL sorgularına doğru bir şekilde dönüştürülmez. Bu tür durumlarda, hatayı manuel olarak düzeltmenize yardımcı olmak için hatayla ilgili bazı ayrıntıları içeren bir hata mesajı günlüğe kaydedilir.
- GAQL'deki tüm rapor türleri AWQL'de desteklenmez.
- GAQL'de "sıfır gösterim satırı" desteği yoktur. Bir raporun sıfır gösterim içermesi gerektiğinin belirtilmesi hatayla sonuçlanır.
- Bazı belirsiz alanlar filtrelerde kullanılamaz. Örneğin "Başlık", herhangi bir sayıda farklı reklam alanına referans verebilir.
- Bazı alanlar, bir sonucu birden fazla sütuna bölmek gibi sonuçları farklı biçimde döndürebilir.
Seçicileri düzenleme
Komut dosyalarını kullanarak kaynak getirilirken, sonuçları yinelemek veya sıralamak için withCondition ve orderBy çağrıları yaygın olarak kullanılır. Bu çağrılardaki alanlar artık yeni Google Ads API adlarını kullanıyor. Örneğin, kampanya adına göre filtreleme yapmak için daha önce şunu kullanmanız gerekirdi:
.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')
Artık, mümkün olduğunda bu koşullar için yeni alan adlarını kullanmanız gerekir:
.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')
Bununla birlikte, eski adlarla yeni adların eşlemesini eklemek için çaba sarf ettik. Bu nedenle, komut dosyanız hâlâ CampaignName kullanıyorsa, komut dosyasının hâlâ çalıştığından emin olmak için çalışma zamanında otomatik olarak campaign.name ile değiştirilir. Eski stil adlarıyla ilgili herhangi bir sorunla karşılaşırsanız komut dosyalarınızı, ilk sorun giderme adımı olarak yeni stil adlarını kullanacak şekilde güncelleyin.
Sınırlar
Çoğu sınır, eski altyapıyla aynıdır ve burada yapılan değişiklikler genellikle performansı artırmaya yardımcı olur.
- Süre sınırları aynıdır. Bir komut dosyası 30 dakika boyunca yürütülebilir.
- Tek bir yineleyici varsayılan olarak 50.000 varlık döndürür ancak bu geçersiz kılınabilir. Daha önce bu 50.000 sınırı özelleştirilemiyordu.
- Tek bir seçici en fazla 10.000 kimliği işleyebilir (değiştirilmemiştir).
- Yeni altyapıda, tek bir komut dosyası içinde işlenebilecek varlık sayısıyla ilgili bir sınırlama yoktur. Daha önce sınır 250.000'di.
- Yeni altyapıda, yürütme başına oluşturulabilecek anahtar kelime veya reklam sayısıyla ilgili bir sınırlama yoktur. Daha önce sınır 250.000'di.
- Günlük çıktısı, 100 KB olacak şekilde kısaltılır (değiştirilmemiştir).
- Apps Komut Dosyası hizmetlerinin (SpreadsheetApp, MailApp vb.) kotaları değişmez.
- Google Ads kotaları, API'yi kullanıyormuşsunuz gibi uygulanır. Yani komut dosyanız API hız sınırlarına tabi olacaktır ancak bu, daha fazla rapora erişmek veya yürütme başına daha fazla değişiklik yapmak için daha fazla esneklik sağlar.
Diğer değişiklikler
getRemainingCreateQuota() veya getRemainingGetQuota() kotaları yeni deneyimde artık geçerli olmadığı için ExecutionInfo artık bunları açığa çıkarmıyor.