Mengurutkan dan membatasi hasil

Google Ads Query Language 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 dari:

FieldName (ASC | DESC)?

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

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

ORDER BY metrics.impressions DESC, campaign.name ASC
  • Berdasarkan atribut resource yang tidak dipilih
  • Berdasarkan metrik yang tidak dipilih
  • Berdasarkan 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 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

Memfilter 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); filter pada subkolom skalar primitif (int64, string, bool) atau enum.
  • 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