0 wskaźników

Z tego przewodnika dowiesz się, dlaczego w raportach interfejsu Google Ads API pojawiają się wiersze z zerowymi danymi, oraz jak je wykluczyć lub obsługiwać w zapytaniach.

Zerowe dane w wynikach wyszukiwania

Podczas wykonywania zapytania możesz natrafić na dane dotyczące jednostek, które mają wartość zero. Może to być spowodowane tym, że:

• jednostki nie kwalifikują się do wyświetlania;
• zostały wstrzymane w zakresie dat raportu.

W wynikach zapytań często chcesz uzyskać informacje o skuteczności swoich kampanii. W tym kontekście zerowe dane mogą być niepożądane. Aby uzyskać bardziej przydatny raport, możesz wyraźnie wykluczyć zerowe dane.

Wykluczanie zerowych danych za pomocą predykatu

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

To zapytanie pokazuje, jak wyraźnie usunąć zerowe dane za pomocą predykatu:

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

Wykluczanie zerowych danych przez segmentowanie

Zerowe dane są zawsze wykluczane podczas segmentowania raportu, pod warunkiem że wszystkie wybrane dane mają wartość zero (patrz Zwrócone wiersze z zerowymi danymi).

Segmentowanie raportu odbywa się przez dodanie dowolnego pola segments do klauzuli SELECT zapytania (filtrowanie według podstawowego segmentu daty w klauzuli WHERE bez wybrania go w klauzuli SELECT nie powoduje segmentowania raportu). Jeśli na przykład podzielisz raport na segmenty według segments.date, dane zostaną podzielone na wiersze według dat. Daty bez danych nie są uwzględniane w takim raporcie.

W przypadku tego zapytania raport nie będzie zawierać wierszy z zerowymi danymi:

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żmy 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'

Wynikowy raport nie będzie zawierać wierszy, w których wszystkie 3 wybrane dane mają wartość zero, ale będzie zawierać wiersze, w których co najmniej 1 z 3 wybranych danych jest większa od zera.

Podczas wysyłania zapytań o dane historyczne wykraczające poza okres przechowywania danychszczegółowe dane starsze niż 37 miesięcy są niedostępne i nie będą zwracać wierszy. W przypadku zapytań o szczegółowe segmenty dat (segments.date, segments.week i segments.hour) obejmujące zakresy starsze niż 37 miesięcy w wersji 24 i nowszych zwracany jest błąd DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (lub DateRangeError.UNKNOWN w wersji 23). Dane zbiorcze wyższego poziomu (segments.month, segments.quarter i segments.year) są przechowywane przez 11 lat, licząc od początku następnego pełnego okresu kalendarzowego. Jeśli na przykład 11-letni okres wsteczny przypada na 2015-03-22 (lub 2015-03-01), dane miesięczne są dostępne od pierwszego pełnego miesiąca kalendarzowego po dacie odcięcia (2015-04-01). Więcej informacji znajdziesz w sekcji Zakresy dat.