Mengurutkan dan membatasi hasil

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

Hasil pesanan

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 ditetapkan secara default ke ASC. Jika Anda menghilangkan klausa ORDER BY sepenuhnya, urutan baris yang ditampilkan tidak deterministik.

Klausa ORDER BY berikut mengurutkan laporan tingkat kampanye berdasarkan tayangan iklan menurun dan nama kampanye menaik:

ORDER BY metrics.impressions DESC, campaign.name ASC
  • Berdasarkan 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 menggabungkan ini 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 pada kolom MESSAGE gabungan secara langsung (kecuali pesan wrapper primitif seperti Int64Value dan StringValue); sebagai gantinya, filter pada subkolom enum atau skalar primitif (int64, string, bool).
  • Pemfilteran tidak diizinkan pada atribut MESSAGE gabungan dari kolom berulang; hanya subkolom skalar primitif (int64, string, bool), enum, atau wrapper primitif yang dapat difilter.
Sebelumnya
Kepekaan huruf besar/kecil