Sonuçları sıralama ve sınırlama

Google Ads Sorgu Dili, ORDER BY ve LIMIT ifadelerini kullanarak sorgu yanıtlarınızda döndürülen satırları sıralamanıza ve sınırlamanıza olanak tanır.

Sonuçları sıralama

Yanıtınızdaki satırların sırasını, virgülle ayrılmış bir veya daha fazla sıralama dizisinden oluşan ORDER BY ifadesini kullanarak belirtebilirsiniz:

FieldName (ASC | DESC)?

Bir alan adından sonra ASC veya DESC belirtmezseniz Google Ads API varsayılan olarak ASC değerini kullanır. ORDER BY ifadesini tamamen çıkarırsanız döndürülen satırların sırası belirlenemez.

Aşağıdaki ORDER BY ifadesi, kampanya düzeyindeki bir raporu azalan gösterim sayısına ve artan kampanya adına göre sıralar:

ORDER BY metrics.impressions DESC, campaign.name ASC
  • Seçilmeyen kaynakların özelliklerine göre
  • Seçilmeyen metriklere göre
  • Seçilmeyen segmentlere göre
  • Aşağıdaki türlerdeki alanlar için:
    • MESSAGE
    • Yinelenen alanlar
    • Yinelenen alanların özellikleri

Sonuç sayısını sınırlama

Döndürülen toplam sonuç sayısını, pozitif bir tam sayıyla (1 veya daha büyük; LIMIT 0 geçerli değildir) LIMIT ifadesini kullanarak sınırlayabilirsiniz. Bunu sonuç sıralamasıyla birleştirerek "en iyi N" raporları oluşturabilirsiniz. Örneğin, son 30 gün içinde en yüksek gösterim sayısına sahip beş kampanyayı içeren bir rapor oluşturabilirsiniz:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

Sonuçları filtrele

WHERE filtrelerini ORDER BY ve LIMIT ile birleştirirken aşağıdaki filtreleme kısıtlamalarını göz önünde bulundurun:

  • "Temel" tarih segmenti alanları (segments.date, segments.week, segments.month, segments.quarter ve segments.year) hariç olmak üzere, segmentler seçilmeden filtreleme yapılamaz.
  • Bileşik MESSAGE alanlarında doğrudan filtrelemeye izin verilmez (Int64Value ve StringValue gibi temel sarmalayıcı mesajlar hariç). Bunun yerine, temel skaler (int64, string, bool) veya enum alt alanlarında filtreleme yapın.
  • Yinelenen alanların bileşik MESSAGE özelliklerinde filtrelemeye izin verilmez. Yalnızca temel skaler (int64, string, bool), enum veya temel sarmalayıcı alt alanları filtrelenebilir.