Metrik yok

Bu kılavuzda, sıfır metrik içeren satırların Google Ads API raporlarında neden göründüğü ve sorgularınızda bunları nasıl hariç tutacağınız veya işleyeceğiniz açıklanmaktadır.

Arama sonuçlarında sıfır metrikler

Bir sorgu çalıştırdığınızda, sıfır olan varlıklar için metriklerle karşılaşabilirsiniz. Bunun nedeni aşağıdakilerden biri olabilir:

• Öğeler gösterilmeye uygun değil.
• Raporun tarih aralığında duraklatılmış olmaları gerekir.

Sorgu sonuçlarıyla genellikle kampanyalarınızın nasıl performans gösterdiği hakkında bilgi edinmek istersiniz. Bu bağlamda, sıfır metrikler istenmeyebilir. Daha faydalı bir rapor oluşturmak için sıfır metrikleri açıkça hariç tutabilirsiniz.

Sıfır metrikleri bir koşulla hariç tutma

Yüklem, TRUE, FALSE veya UNKNOWN olarak değerlendirilen bir ifadedir. Yüklemler, Google Ads Sorgu Dili'ndeki WHERE yan tümcelerinin arama koşulunda kullanılır.

Aşağıdaki sorguda, sıfır metriklerin bir yüklemle açıkça nasıl kaldırılacağı gösterilmektedir:

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

Segmentlere ayırarak sıfır metrikleri hariç tutma

Seçilen tüm metriklerin sıfır olması koşuluyla, bir rapor segmentlere ayrılırken sıfır metrikler her zaman hariç tutulur (Sıfır metrik içeren döndürülen satırlar bölümüne bakın).

Bir raporu segmentlere ayırmak için arama sorgusunun SELECT ifadesine herhangi bir segments alanı eklenir (SELECT ifadesinde seçmeden WHERE ifadesindeki temel tarih segmentini filtrelemek raporu segmentlere ayırmaz). Örneğin, bir raporu segments.date değerine göre segmentlere ayırırsanız metrikler her tarih için bir satır olacak şekilde dökümlere ayrılır. Metrik içermeyen tarihler bu tür raporlarda döndürülmez.

Aşağıdaki sorgu için rapor, sıfır metrik satırları içermez:

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

Sıfır metrik içeren döndürülen satırlar

Segmentlere ayırma sırasında, seçilen metriklerinin tümü sıfır olan satırlar döndürülmez. Örneğin, metrics.impressions, metrics.clicks ve metrics.conversions sütunlarını seçen aşağıdaki sorguyu inceleyin:

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'

Elde edilen rapor, seçilen üç metriğin de sıfır olduğu satırları içermez ancak seçilen üç metrikten en az birinin sıfırdan büyük olduğu satırları döndürür.

Veri saklama süresinden daha eski geçmiş verileri sorgularken 37 aydan eski ayrıntılı veriler kullanılamaz ve satır döndürmez. 37 aydan eski aralıkları kapsayan ayrıntılı tarih segmentleri (segments.date, segments.week ve segments.hour) için yapılan istekler, v24 ve sonraki sürümlerde DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (veya v23'te DateRangeError.UNKNOWN) döndürür. Üst düzey birleştirilmiş veriler (segments.month, segments.quarter ve segments.year), bir sonraki tam takvim döneminin başlangıcına göre 11 yıl boyunca saklanır. Örneğin, 11 yıllık geriye dönük inceleme sınırı 2015-03-22 (veya 2015-03-01) tarihine denk geliyorsa aylık veriler, sınırdan sonraki ilk tam takvim ayından (2015-04-01) itibaren kullanılabilir. Ayrıntılar için Tarih Aralıkları bölümüne bakın.

Erişim metriği gizleme ve sıfır değerleri

Gösterim yayınlamayan öğelere ek olarak, erişim metrikleri (ör. metrics.unique_users ve sıklık grubu metrikleri metrics.unique_users_two_plus - metrics.unique_users_ten_plus) sıfır olarak görünebilir veya erişim verileri gizlendiğinde atlanabilir. metrics.unique_users metriği (ve metrics.unique_users_info) Görüntülü Reklam Ağı, Video, Talep Yaratma ve uygulama kampanyalarında desteklenirken metrics.unique_users_*_plus sıklık grubu metrikleri (ve metrics.unique_users_*_plus_info) video kampanyaları için geçerlidir.

Erişim engelleme birkaç nedenden dolayı gerçekleşir:

• Gizlilik eşikleri: Kullanıcı kimliğini korumak için kullanıcı sayıları gizlilik eşiklerini (ör. k-anonimlik) karşılamadığında erişim verileri gizlenir.
• Kalite eşikleri: Kalite standartlarını karşılamayan erişim verileri gösterilmeyebilir.
• Veri saklama: Geçmiş erişim verileri 3 yıl (36 ay) boyunca saklanır. Bu 3 yıllık saklama süresinin dışındaki tarihleri kapsayan sorgular, erişim metriklerini döndüremez. 36 ila 37 ay önceki tarihleri kapsayan sorgular, önceki bölümde açıklanan DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED hatasını döndürmeden başarılı olur ancak erişim metriklerini atlar (ve tamamlayıcı erişim meta verileri seçildiğinde DATE_RANGE_BEYOND_RETENTION hatasını döndürür).

Sürüm 26 ve sonraki sürümlerde, her benzersiz kullanıcı erişimi metriğinin ReachMetricInfo türünde bir tamamlayıcı meta veri alanı vardır (ör. metrics.unique_users_info ve metrics.unique_users_two_plus_info ile metrics.unique_users_ten_plus_info arası).

Google Ads Sorgu Dili'nde (GAQL), tamamlayıcı erişim alanları doğrudan SELECT ifadesinde seçilen MESSAGE metrikleridir (ör. metrics.unique_users_info). GAQL'de iç içe yerleştirilmiş mesaj alanları seçildiğinde UNRECOGNIZED_FIELD hatası oluştuğu için SELECT ifadesine .reach_metric_states eklemeyin. Bunun yerine, metrics.unique_users_info seçildiğinde, metriğin gizlenip gizlenmediğini veya tamamlanıp tamamlanmadığını açıklayan ReachMetricState türünde yinelenen enum alanı reach_metric_states içeren bir ReachMetricInfo mesajı döndürülür.

Bir erişim metriği gizlendiğinde veya saklama süresinin (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION veya DATE_RANGE_BEYOND_RETENTION) dışında olduğunda Metrics üzerindeki optional int64 alanı ayarlanmaz (alan varlığı kontrol edilmezse 0 olarak değerlendirilir). LOW_QUALITY ise sayısal metriği doldurmaya devam eder:

• COMPLETE: Erişim metriği, gizleme olmadan tamamlandı.
• PRIVACY_SUPPRESSION: Erişim verileri, gizlilik kısıtlamaları nedeniyle engellendi.
• QUALITY_SUPPRESSION: Erişim verileri, veri kalitesiyle ilgili nedenlerden dolayı engellendi.
• LOW_QUALITY: Erişim metriği hesaplandı ancak düşük kaliteli olarak işaretlendi.
• DATE_RANGE_BEYOND_RETENTION: Tarih aralığı, erişim verileri için 3 yıllık veri saklama sınırının dışında olduğundan erişim metrikleri kullanılamıyor.

Hem erişim metriğini hem de tamamlayıcı meta veri alanını seçerek uygulamanız, gerçek sıfır erişim ile gizlenen erişim değerlerini ayırt edebilir:

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

Not: Tamamlayıcı erişim meta veri alanları (metrics.unique_users*_info), filterable: false ve sortable: false içeren MESSAGE metrikleridir. Bu nedenle WHERE veya ORDER BY yan tümcelerinde kullanılamazlar. Ayrıca erişim metrikleri satırlar arasında birleştirilemez. metrics.unique_users metriği yalnızca 92 gün veya daha kısa tarih aralıkları için istenebilirken unique_users_*_plus sıklık grubu metrikleri yalnızca 31 gün veya daha kısa tarih aralıkları için istenebilir. Video erişim ve sıklık metriklerinin tam listesi için Kampanya erişim ve sıklık raporları bölümüne bakın.