Metrik nol

Panduan ini menjelaskan alasan baris dengan metrik nol muncul di 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 entitas yang bernilai nol. Hal ini dapat disebabkan karena:

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

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

Mengecualikan metrik nol dengan predikat

Predikat adalah ekspresi yang bernilai TRUE, FALSE, atau UNKNOWN. Predikat digunakan dalam kondisi penelusuran klausa WHERE dalam Bahasa Kueri Google Ads.

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 melakukan segmentasi

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

Segmentasi laporan dilakukan dengan menyertakan kolom segments apa pun dalam klausa SELECT kueri penelusuran (pemfilteran pada segmen tanggal inti di WHERE tanpa memilihnya di SELECT tidak akan menyegmentasikan laporan). Misalnya, jika Anda menyegmentasikan laporan menurut segments.date, metrik akan diuraikan 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 metrik nol

Baris yang semua metrik pilihannya 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 satu dari tiga metrik yang dipilihnya lebih besar dari nol.

Saat membuat kueri data historis di luar periode retensi data, data terperinci yang lebih lama dari 37 bulan tidak akan 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 umum (segments.month, segments.quarter, dan segments.year) dipertahankan selama 11 tahun, yang disesuaikan dengan awal periode kalender lengkap berikutnya. Misalnya, jika batas lihat balik 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.

Penghapusan metrik jangkauan dan nilai nol

Selain entitas yang tidak menayangkan tayangan iklan, metrik jangkauan (seperti metrics.unique_users dan metrik bucket frekuensi metrics.unique_users_two_plus hingga metrics.unique_users_ten_plus) dapat muncul sebagai nol atau dihilangkan saat data jangkauan disembunyikan. Metrik metrics.unique_users (dan metrics.unique_users_info) didukung di kampanye Display, Video, Peningkat Permintaan, dan Aplikasi, sedangkan metrik bucket frekuensi metrics.unique_users_*_plus (dan metrics.unique_users_*_plus_info) berlaku untuk kampanye Video.

Penekanan jangkauan terjadi karena beberapa alasan:

• Nilai minimum privasi: Data jangkauan akan disembunyikan jika jumlah pengguna tidak memenuhi nilai minimum privasi (seperti k-anonymity) untuk melindungi identitas pengguna.
• Nilai minimum kualitas: Data jangkauan dapat ditahan jika data tidak memenuhi standar kualitas.
• Retensi data: Data jangkauan historis disimpan selama 3 tahun (36 bulan). Kueri yang mencakup tanggal di luar periode retensi 3 tahun ini tidak dapat menampilkan metrik jangkauan. Meskipun kueri yang mencakup tanggal antara 36 dan 37 bulan yang lalu berhasil tanpa menampilkan DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED yang dijelaskan di bagian sebelumnya, kueri tersebut menghilangkan metrik jangkauan (dan menampilkan DATE_RANGE_BEYOND_RETENTION saat metadata jangkauan pengiring dipilih).

Di v26 dan yang lebih baru, setiap metrik jangkauan pengguna unik memiliki kolom metadata pendamping dari jenis ReachMetricInfo (seperti metrics.unique_users_info dan metrics.unique_users_two_plus_info hingga metrics.unique_users_ten_plus_info).

Dalam Bahasa Kueri Google Ads (GAQL), kolom jangkauan pengiring adalah metrik MESSAGE yang dipilih langsung dalam klausa SELECT (misalnya, metrics.unique_users_info). Jangan tambahkan .reach_metric_states dalam klausa SELECT, karena memilih kolom pesan bertingkat di GAQL akan gagal dengan UNRECOGNIZED_FIELD. Sebagai gantinya, memilih metrics.unique_users_info akan menampilkan pesan ReachMetricInfo yang berisi kolom enum berulang reach_metric_states dari jenis ReachMetricState, yang menjelaskan apakah metrik disembunyikan atau sudah lengkap.

Setiap kali metrik jangkauan ditiadakan atau berada di luar periode retensi (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION, atau DATE_RANGE_BEYOND_RETENTION), kolom optional int64-nya di Metrics tidak ditetapkan (yang dievaluasi ke 0 jika keberadaan kolom tidak diperiksa), sedangkan LOW_QUALITY masih mengisi metrik numerik:

• COMPLETE: Metrik jangkauan sudah lengkap tanpa penghapusan.
• PRIVACY_SUPPRESSION: Data jangkauan dikurangi karena batasan privasi.
• QUALITY_SUPPRESSION: Data jangkauan tidak ditampilkan karena alasan kualitas data.
• LOW_QUALITY: Metrik jangkauan dihitung, tetapi ditandai sebagai berkualitas rendah.
• DATE_RANGE_BEYOND_RETENTION: Metrik jangkauan tidak tersedia karena rentang tanggal berada di luar batas retensi data 3 tahun untuk data jangkauan.

Dengan memilih metrik jangkauan dan kolom metadata pendampingnya, aplikasi Anda dapat membedakan antara nilai jangkauan nol yang sebenarnya dan nilai jangkauan yang disembunyikan:

SELECT
  campaign.id,
  campaign.name,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Catatan: Kolom metadata jangkauan pengiring (metrics.unique_users*_info) adalah metrik MESSAGE dengan filterable: false dan sortable: false, sehingga tidak dapat digunakan dalam klausa WHERE atau ORDER BY. Selain itu, metrik jangkauan tidak dapat digabungkan di seluruh baris. Metrik metrics.unique_users hanya dapat diminta untuk rentang tanggal 92 hari atau kurang, sedangkan metrik bucket frekuensi unique_users_*_plus hanya dapat diminta untuk rentang tanggal 31 hari atau kurang. Lihat Pelaporan jangkauan dan frekuensi kampanye untuk mengetahui daftar lengkap metrik jangkauan dan frekuensi Video.