Bu kılavuzda, Google Ads API raporlarında neden sıfır metrik içeren satırların göründüğü ve bunları sorgularınızda 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österime 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.
Koşul kullanarak sıfır metrikleri hariç tutma
Yüklem, TRUE, FALSE veya UNKNOWN olarak değerlendirilen bir ifadedir.
Yüklemler, Google Ads sorgu dilindeki WHERE ifadelerinin 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).
Raporu segmentlere ayırmak için arama sorgusunun SELECT ifadesine herhangi bir segments alanı eklenir (SELECT ifadesinde seçmeden WHERE ifadesindeki bir temel tarih segmentine göre filtreleme yapmak raporu segmentlere ayırmaz). Örneğin, bir raporu segments.date ölçütüne 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 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
Sıfır metrik içeren döndürülen satırlar
Segmentasyon yapılırken, seçilen metriklerinin tümü sıfır olan satırlar döndürülmez. Örneğin, metrics.impressions, metrics.clicks ve metrics.conversions alanları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'
Sonuçta elde edilen 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üresinin ötesindeki geçmiş veriler sorgulanırken 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) istekleri, v24 ve sonraki sürümlerde DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (v23'te ise 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 bakma kesme tarihi 2015-03-22 (veya 2015-03-01) ise kesme tarihinden sonraki ilk tam takvim ayından (2015-04-01) itibaren aylık veriler kullanılabilir. Ayrıntılar için Tarih Aralığı bölümüne bakın.