In diesem Leitfaden wird erläutert, warum in Google Ads API-Berichten Zeilen mit null Messwerten angezeigt werden und wie Sie sie in Ihren Abfragen ausschließen oder verarbeiten können.
Keine Messwerte in Suchergebnissen
Wenn Sie eine Abfrage ausführen, werden möglicherweise Messwerte für Entitäten angezeigt, die null sind. Mögliche Gründe:
- Die Entitäten können nicht angezeigt werden.
- Sie wurden innerhalb des Zeitraums des Berichts pausiert.
Mit Abfrageergebnissen möchten Sie oft Informationen zur Leistung Ihrer Kampagnen erhalten. In diesem Kontext sind Messwerte von null möglicherweise nicht wünschenswert. Um einen nützlicheren Bericht zu erstellen, können Sie Messwerte mit dem Wert „0“ explizit ausschließen.
Messwerte mit dem Wert „0“ mit einem Prädikat ausschließen
Ein Prädikat ist ein Ausdruck, der als TRUE, FALSE oder UNKNOWN ausgewertet wird.
Prädikate werden in der Suchbedingung der WHERE-Klauseln in der Google Ads-Abfragesprache verwendet.
Die folgende Abfrage zeigt, wie Sie Messwerte mit dem Wert „0“ explizit mit einem Prädikat entfernen:
SELECT
campaign.id,
metrics.impressions
FROM campaign
WHERE metrics.impressions > 0
Messwerte mit dem Wert „0“ durch Segmentierung ausschließen
Messwerte mit dem Wert „0“ werden beim Segmentieren eines Berichts immer ausgeschlossen, sofern alle ausgewählten Messwerte null sind (siehe Zurückgegebene Zeilen mit Messwerten mit dem Wert „0“).
Ein Bericht wird segmentiert, indem ein beliebiges segments-Feld in die SELECT-Klausel der Suchanfrage aufgenommen wird. Wenn Sie in WHERE nach einem Hauptdatumssegment filtern, ohne es in SELECT auszuwählen, wird der Bericht nicht segmentiert. Wenn Sie einen Bericht beispielsweise nach segments.date segmentieren, werden die Messwerte in einer Zeile für jedes Datum aufgeschlüsselt. Datumsangaben ohne Messwerte werden in einem solchen Bericht nicht zurückgegeben.
Für die folgende Abfrage enthält der Bericht keine Zeilen mit dem Messwert „Null“:
SELECT
campaign.name,
metrics.impressions,
segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Zurückgegebene Zeilen ohne Messwerte
Zeilen, deren ausgewählte Messwerte alle null sind, werden bei der Segmentierung nicht zurückgegeben. Betrachten Sie beispielsweise die folgende Abfrage, mit der metrics.impressions, metrics.clicks und metrics.conversions ausgewählt werden:
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'
Der resultierende Bericht enthält keine Zeilen, in denen alle drei ausgewählten Messwerte null sind. Es werden jedoch Zeilen zurückgegeben, in denen mindestens einer der drei ausgewählten Messwerte größer als null ist.
Wenn Sie Verlaufsdaten abfragen, die über den Aufbewahrungszeitraum für Daten hinausgehen, sind detaillierte Daten, die älter als 37 Monate sind, nicht verfügbar und es werden keine Zeilen zurückgegeben. Anfragen für detaillierte Datumssegmente (segments.date, segments.week und segments.hour), die Zeiträume abdecken, die älter als 37 Monate sind, geben in Version 24 und höher DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED zurück (oder DateRangeError.UNKNOWN in Version 23). Aggregierte Daten auf hoher Ebene (segments.month, segments.quarter und segments.year) werden 11 Jahre lang aufbewahrt, beginnend mit dem Start des nächsten vollständigen Kalenderzeitraums. Wenn der Stichtag für den 11-Jahres-Rückblick beispielsweise auf den 2015-03-22 (oder 2015-03-01) fällt, sind monatliche Daten ab dem ersten vollständigen Kalendermonat nach dem Stichtag (2015-04-01) verfügbar. Weitere Informationen finden Sie unter Zeiträume.