Seçiciler, programcının istenen Google Ads varlıklarını getiren sorguyu oluşturmasına yardımcı olur. Seçiciler sayesinde, alınan varlıkların listesi daraltılıp sıralanabilir. Çoğu seçici aşağıdaki yöntemlere sahiptir:
withCondition()- Seçiciye koşul ekler. Birden fazla koşul kullanılırsa bunlar birlikte VE uygulanır. Diğer bir deyişle, seçici yalnızca belirtilen koşulların tümünü karşılayan varlıkları döndürür.
withIds()- Koşul olarak kimlik koleksiyonunu ekler. Kimlik tabanlı bir koşul, diğer tüm koşullarla birlikte VE uygulanır.
forDateRange()- Bir koşul veya sipariş ifadesi TO ya da Gösterimler gibi bir Stats alanına başvurduğunda gerekir. 100'den fazla gösterime sahip tüm kampanyaları isterseniz Google Ads komut dosyalarının incelenecek tarih aralığını bilmesi gerekir.
orderBy()- Döndürülen varlıkların sıralamasını belirtir.
withLimit()- Döndürülen varlıkların sayısını, belirtilen değerle sınırlandırır. Bu özellikle "Dün en çok gösterim alan 10 anahtar kelime" gibi verileri getirmek için
orderBy()ile birlikte kullanışlıdır. Varsayılan olarak, tüm seçiciler sınırı 50.000 olarak ayarlar. Manuel olarak bir sınır belirterek sınırı artırabilirsiniz.
Bu yöntemler herhangi bir sırada çağrılabilir. Bunun bir istisnası, çağrıların sırasının gerçekten önemli olduğu orderBy() kuralıdır: Bu yönteme yapılan birden fazla çağrı, birden fazla sıralama ifadesi belirtir ve bunlar sırayla uygulanır. Aşağıdaki snippet'i göz önünde bulundurun:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Sonuçlar Tıklamalar sütununa göre azalan düzende sıralanır. Eşit tıklama değerlerine sahip sonuçlar Ctr değerine göre artan düzende sıralanır.
Seçicinin yöntemlerine yapılan çağrılar birbirine bağlanabilir. Aşağıdaki kod
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
daha küçük bir biçimde yeniden yazılabilir:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Seçici oluşturulduğunda, selector.get() çağırarak ondan bir Iterator elde edilebilir.
Etkili seçici kullanımıyla ilgili ipuçları ve püf noktaları için En İyi Uygulamaları okuyun.