0 wskaźników

Z tego przewodnika dowiesz się, dlaczego w raportach interfejsu Google Ads API pojawiają się wiersze z zerowymi wartościami danych i jak je wykluczać lub obsługiwać w zapytaniach.

Wartości zerowe w wynikach wyszukiwania

Podczas wykonywania zapytania możesz napotkać dane dotyczące encji, które mają wartość zero. Oto możliwe przyczyny:

• Encje nie kwalifikują się do wyświetlania.
• zostały wstrzymane w okresie objętym raportem.

Wyniki zapytań często służą do uzyskiwania informacji o skuteczności kampanii. W tym kontekście dane równe zero mogą być niepożądane. Aby uzyskać bardziej przydatny raport, możesz wyraźnie wykluczyć dane o wartości zero.

Wykluczanie wskaźników o wartości zero za pomocą predykatu

Predykat to wyrażenie, które zwraca wartość TRUE, FALSE lub UNKNOWN. Predykaty są używane w warunku wyszukiwania klauzul WHERE w języku zapytań Google Ads.

To zapytanie pokazuje, jak jawnie usunąć dane o wartości zero za pomocą predykatu:

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

Wykluczanie wskaźników o wartości zero przez segmentację

Dane o wartości zero są zawsze wykluczane podczas segmentowania raportu, pod warunkiem że wszystkie wybrane dane mają wartość zero (patrz Wiersze zwracane z danymi o wartości zero).

Podział raportu na segmenty następuje przez uwzględnienie dowolnego pola segments w klauzuli SELECT zapytania (filtrowanie według podstawowego segmentu daty w WHERE bez wybrania go w SELECT nie powoduje podziału raportu na segmenty). Jeśli na przykład posegmentujesz raport według segments.date, wartości zostaną podzielone na wiersze, po jednym na każdą datę. Daty, dla których nie ma danych, nie są uwzględniane w takim raporcie.

W przypadku tego zapytania raport nie będzie zawierać wierszy z zerowymi wartościami danych:

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

Zwrócone wiersze z zerowymi danymi

Wiersze, w których wszystkie wybrane dane mają wartość zero, nie będą zwracane podczas segmentowania. Rozważ na przykład to zapytanie, które wybiera metrics.impressions, metrics.clicks i 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'

Raport nie będzie zawierać wierszy, w których wszystkie 3 wybrane rodzaje danych mają wartość zero, ale będzie zawierać wiersze, w których co najmniej 1 z tych 3 rodzajów danych ma wartość większą od zera.

Podczas wysyłania zapytań o dane historyczne wykraczające poza okres przechowywania danych szczegółowe dane starsze niż 37 miesięcy są niedostępne i nie zwracają wierszy. Zapytania o szczegółowe segmenty daty (segments.date, segments.week i segments.hour) obejmujące zakresy starsze niż 37 miesięcy zwracają błąd DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED w wersji 24 i nowszych (lub DateRangeError.UNKNOWN w wersji 23). Dane zagregowane ogólne (segments.month, segments.quarter i segments.year) są przechowywane przez 11 lat od początku kolejnego pełnego okresu kalendarzowego. Jeśli np. 11-letni okres wsteczny kończy się 2015-03-22 (lub 2015-03-01), dane miesięczne są dostępne od pierwszego pełnego miesiąca kalendarzowego po tym terminie (2015-04-01). Więcej informacji znajdziesz w sekcji Zakresy dat.