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ünde en yüksek gösterime sahip beş kampanyayı içeren bir rapor:
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.quartervesegments.year) hariç olmak üzere, segmentler seçilmeden filtreleme yapılamaz. - Doğrudan bileşik
MESSAGEalanlarında filtreleme işlemine izin verilmez (Int64ValueveStringValuegibi temel sarmalayıcı iletiler hariç). Bunun yerine, temel skaler (int64,string,bool) veya enum alt alanlarında filtreleme yapın. - Tekrarlanan alanların bileşik
MESSAGEözelliklerinde filtrelemeye izin verilmez. Yalnızca temel skaler (int64,string,bool), enum veya temel sarmalayıcı alt alanları filtrelenebilir.