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ındaki sıfır metrikler
Bir sorgu yürüttüğünüzde, sıfır olan varlıkların metrikleriyle karşılaşabilirsiniz. Bunun nedeni aşağıdakilerden biri olabilir:
- Öğeler gösterime uygun değil.
- Bu kampanyalar, raporun tarih aralığında duraklatılmış olmalıdır.
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 nasıl açıkça 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
Tüm seçili metrikler sıfır olduğu sürece rapor segmentlere ayrılırken sıfır metrikler her zaman hariç tutulur (bkz. Sıfır metrik içeren döndürülen satırlar).
Bir raporu segmentlere ayırmak için arama sorgusunun segments ifadesine herhangi bir SELECT alanı eklenir (WHERE içinde temel tarih segmenti üzerinde SELECT'te seçmeden filtreleme, raporu segmentlere ayırmaz). Örneğin, bir raporu segments.date göre segmentlere ayırırsanız metrikler her tarih için bir satır olacak şekilde 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
Metrikleri sıfır olan döndürülen satırlar
Seçilen metriklerinin tümü sıfır olan satırlar, segmentlere ayırma işlemi sırasında döndürülmez. Örneğin, metrics.impressions, metrics.clicks ve metrics.conversions değerlerini 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'
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 DateRangeError.UNKNOWN) döndürür. Üst düzeyde toplanmış veriler (segments.month, segments.quarter ve segments.year), bir sonraki tam takvim döneminin başlangıcına uygun olarak 11 yıl boyunca saklanır. Örneğin, 11 yıllık geriye bakma kesme tarihi 2015-03-22 (veya 2015-03-01) ise aylık veriler, kesme tarihinden sonraki ilk tam takvim ayından (2015-04-01) itibaren kullanılabilir. Ayrıntılar için Tarih Aralığı bölümüne bakın.