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 metrik

Bir sorgu çalıştırdığınızda, varlıklar için sıfır olan 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 segmentine göre filtreleme yapmak raporu segmentlere ayırmaz). Örneğin, bir raporu segments.date boyutuna göre segmentlere ayırırsanız metrikler her tarih için bir satır olacak şekilde dökümlenir. Metrik içermeyen tarihler bu tür bir raporda döndürülmez.

Aşağıdaki sorgu için raporda sıfır metrikli satırlar yer almaz:

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

Bu hariç tutma, herhangi bir metrics alanı seçmeden segments alanlarını (ör. segments.ad_network_type veya segments.device alanları) seçtiğinizde de geçerli olur. Bir öğenin gösterim sayısı sıfırsa segmentlere ayrılmış bir sorgu, yalnızca campaign.network_settings.target_search_network alanı gibi kaynak özelliklerini seçseniz bile bu öğeyi atlar. Gösterim sayısından bağımsız olarak tüm varlıkların kaynak ayarlarını almak için SELECT yan tümcesinden segments alanlarını çıkarın.

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 ele alalım:

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'

Oluşturulan raporda, seçilen üç metriğin de sıfır olduğu satırlar yer almaz ancak seçilen üç metrikten en az birinin sıfırdan büyük olduğu satırlar döndürülü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 daha eski aralıkları kapsayan ayrıntılı tarih segmentleri (segments.date, segments.week ve segments.hour) için yapılan istekler, 24. sürüm ve sonraki sürümlerde DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (veya 23. sürümde 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ında 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 tekil 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ğundan 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 aralığının (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). Ancak LOW_QUALITY, sayısal metriği doldurmaya devam eder:

• COMPLETE: Erişim metriği, gizleme olmadan tamamlanmıştır.
• 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ğerleri arasında ayrım yapabilir:

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