Metrik nol

Panduan ini menjelaskan alasan baris dengan metrik nol muncul dalam laporan Google Ads API dan cara mengecualikan atau menanganinya dalam kueri Anda.

Metrik nol di hasil penelusuran

Saat menjalankan kueri, Anda mungkin menemukan metrik untuk entity yang bernilai nol. Hal ini dapat disebabkan karena:

  • Entitas tidak memenuhi syarat untuk ditampilkan.
  • Kampanye tersebut dijeda dalam rentang tanggal laporan.

Dengan hasil kueri, Anda sering kali ingin mendapatkan informasi tentang performa kampanye Anda. Dalam konteks ini, metrik nol mungkin tidak diinginkan. Untuk membuat laporan yang lebih berguna, Anda dapat secara eksplisit mengecualikan metrik nol.

Mengecualikan metrik nol dengan predikat

Predikat adalah ekspresi yang dievaluasi menjadi TRUE, FALSE, atau UNKNOWN. Predikat digunakan dalam kondisi penelusuran klausa WHERE di Google Ads Query Language.

Kueri berikut menunjukkan cara menghapus metrik nol secara eksplisit dengan predikat:

SELECT
  campaign.id,
  metrics.impressions
FROM campaign
WHERE metrics.impressions > 0

Mengecualikan metrik nol dengan membuat segmen

Metrik nol selalu dikecualikan saat menyegmentasikan laporan, asalkan semua metrik yang dipilih bernilai nol (lihat Baris yang ditampilkan dengan metrik nol).

Penyegmenan laporan dilakukan dengan menyertakan kolom segments dalam klausa SELECT kueri penelusuran (memfilter segmen tanggal inti di WHERE tanpa memilihnya di SELECT tidak akan menyegmentasikan laporan). Misalnya, jika Anda menyegmentasikan laporan menurut segments.date, metrik akan dikelompokkan dengan satu baris untuk setiap tanggal. Tanggal tanpa metrik tidak ditampilkan dalam laporan tersebut.

Untuk kueri berikut, laporan tidak akan menyertakan baris metrik nol:

SELECT
  campaign.name,
  metrics.impressions,
  segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Baris yang ditampilkan dengan nol metrik

Baris yang metrik terpilihnya bernilai nol tidak akan ditampilkan saat melakukan segmentasi. Misalnya, pertimbangkan kueri berikut yang memilih metrics.impressions, metrics.clicks, dan metrics.conversions:

SELECT
  ad_group_criterion.criterion_id,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  segments.date
FROM keyword_view
WHERE segments.date BETWEEN '2026-01-01' AND '2026-01-31'

Laporan yang dihasilkan tidak akan berisi baris yang ketiga metrik yang dipilihnya bernilai nol, tetapi akan menampilkan baris yang setidaknya salah satu dari ketiga metrik yang dipilihnya bernilai lebih besar dari nol.

Saat membuat kueri data historis di luar periode retensi data, data terperinci yang lebih lama dari 37 bulan tidak tersedia dan tidak akan menampilkan baris. Permintaan untuk segmen tanggal terperinci (segments.date, segments.week, dan segments.hour) yang mencakup rentang yang lebih lama dari 37 bulan akan menampilkan DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED di v24 dan yang lebih baru (atau DateRangeError.UNKNOWN di v23). Data gabungan tingkat tinggi (segments.month, segments.quarter, dan segments.year) disimpan selama 11 tahun, sesuai dengan awal periode kalender lengkap berikutnya. Misalnya, jika batas periode lihat kembali 11 tahun jatuh pada 2015-03-22 (atau 2015-03-01), data bulanan tersedia mulai dari bulan kalender penuh pertama setelah batas (2015-04-01). Lihat Rentang Tanggal untuk mengetahui detailnya.