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ı ORDER BY ifadesini kullanarak belirtebilirsiniz. Bu ifade, virgülle ayrılmış bir veya daha fazla diziden oluşur:

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 yan tümcesini tamamen atlarsanız döndürülen satırların sırası belirsiz olur.

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çili olmayan kaynakların özelliklerine göre
  • Seçili olmayan metriklere göre
  • Seçili olmayan 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

Pozitif bir tam sayı (1 veya daha büyük; LIMIT 0 geçerli değildir) ile LIMIT ifadesini kullanarak döndürülen toplam sonuç sayısını 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:

  • "Çekirdek" tarih segmenti alanları (segments.date, segments.week, segments.month, segments.quarter ve segments.year) hariç olmak üzere, segmentler seçilmeden filtrelenemez.
  • Bileşik MESSAGE alanlarında doğrudan filtrelemeye izin verilmez (Int64Value ve StringValue gibi basit sarmalayıcı mesajlar hariç). Bunun yerine basit 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.
Önceki
Büyük/küçük harf duyarlılığı