Mengurutkan dan membatasi hasil

Bahasa Kueri Google Ads memungkinkan Anda mengurutkan dan membatasi baris yang ditampilkan dalam respons kueri menggunakan klausa ORDER BY dan LIMIT.

Mengurutkan hasil

Anda dapat menentukan urutan baris dalam respons menggunakan klausa ORDER BY, yang terdiri dari satu atau beberapa urutan yang dipisahkan koma:

FieldName (ASC | DESC)?

Jika Anda tidak menentukan ASC atau DESC setelah nama kolom, Google Ads API akan menggunakan ASC secara default. Jika Anda menghilangkan klausa ORDER BY sepenuhnya, urutan baris yang ditampilkan tidak ditentukan.

Klausul ORDER BY berikut mengurutkan laporan tingkat kampanye menurut tayangan menurun dan nama kampanye menaik:

ORDER BY metrics.impressions DESC, campaign.name ASC

• Menurut atribut resource yang tidak dipilih
• Menurut metrik yang tidak dipilih
• Menurut segmen yang tidak dipilih
• Untuk kolom dengan jenis berikut:
  • MESSAGE
  • Kolom berulang
  • Atribut kolom berulang

Membatasi jumlah hasil

Anda dapat membatasi jumlah total hasil yang ditampilkan menggunakan klausa LIMIT dengan bilangan bulat positif (1 atau lebih besar; LIMIT 0 tidak valid). Dengan menggabungkannya dengan pengurutan hasil, Anda dapat membuat laporan "N teratas", seperti laporan yang berisi lima kampanye dengan tayangan iklan tertinggi selama 30 hari terakhir:

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

Filter hasil

Saat menggabungkan filter WHERE dengan ORDER BY dan LIMIT, perhatikan batasan pemfilteran berikut:

• Pemfilteran tidak diizinkan pada segmen tanpa memilihnya, kecuali untuk kolom segmen tanggal "inti" (segments.date, segments.week, segments.month, segments.quarter, dan segments.year).
• Pemfilteran tidak diizinkan langsung pada kolom MESSAGE komposit (kecuali pesan wrapper primitif seperti Int64Value dan StringValue); filter pada subkolom skalar primitif (int64, string, bool) atau enumnya.
• Pemfilteran tidak diizinkan pada atribut MESSAGE komposit dari kolom berulang; hanya sub-kolom skalar primitif (int64, string, bool), enum, atau wrapper primitif yang dapat difilter.