Seçiciler, programcının istenen Google Ads öğelerini getiren sorguyu oluşturmasına yardımcı olur. Seçicilerle, alınan varlıkların listesi daraltılabilir ve sıralanabilir. Çoğu seçicinin aşağıdaki yöntemleri vardır:
withCondition()- Seçiciye koşul ekler. Birden fazla koşul kullanılıyorsa bunlar AND operatörüyle birleştirilir. Diğer bir deyişle, seçici yalnızca belirtilen koşulların tümünü karşılayan öğeleri döndürür.
withIds()- Koşul olarak bir kimlik koleksiyonu ekler. Kimliğe dayalı bir koşul, diğer tüm koşullarla birlikte VE ile birleştirilir.
forDateRange()- Bir koşul veya sıralama yan tümcesi, TO ya da Gösterimler gibi bir Stats alanına başvurduğunda gereklidir. 100'den fazla gösterim alan 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. Özellikle "dün en çok gösterim alan 10 anahtar kelime" gibi bilgileri almak için
orderBy()ile birlikte kullanıldığında faydalıdır. Varsayılan olarak tüm seçiciler sınırı 50.000 olarak ayarlar. Sınırı manuel olarak belirterek artırabilirsiniz.
Bu yöntemler herhangi bir sırayla çağrılabilir. Bunun tek istisnası, çağrıların sırasının önemli olduğu orderBy() yöntemidir. 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 inceleyin:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Sonuçlar, tıklama sayısına göre azalan düzende sıralanır. Tıklama değerleri eşit olan sonuçlar, TO'ya göre artan düzende sıralanır.
Seçici yöntemlerine yapılan çağrılar birbirine zincirlenebilir. 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 kompakt bir şekilde yeniden yazılabilir:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Seçici oluşturulduktan sonra selector.get() çağrısı yapılarak seçiciden Iterator elde edilebilir.
Seçicileri verimli kullanmayla ilgili ipuçları ve püf noktaları için En İyi Uygulamalar'ı okuyun.