In diesem Leitfaden wird erläutert, warum in Google Ads API-Berichten Zeilen mit Messwerten von null angezeigt werden und wie Sie sie in Ihren Abfragen ausschließen oder verarbeiten.
Messwerte von null 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.
Bei Abfrageergebnissen möchten Sie oft Informationen zur Leistung Ihrer Kampagnen erhalten. In diesem Zusammenhang sind Messwerte von null möglicherweise nicht erwünscht. Um einen nützlicheren Bericht zu erstellen, können Sie Messwerte von null explizit ausschließen.
Messwerte von null 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
Google Ads Query Language verwendet.
Die folgende Abfrage zeigt, wie Sie Messwerte von null mit einem Prädikat explizit entfernen:
SELECT
campaign.id,
metrics.impressions
FROM campaign
WHERE metrics.impressions > 0
Messwerte von null durch Segmentierung ausschließen
Messwerte von null werden immer ausgeschlossen, wenn ein Bericht segmentiert wird, sofern alle ausgewählten Messwerte null sind (siehe Zurückgegebene Zeilen mit Messwerten von null).
Ein Bericht wird segmentiert, indem Sie ein beliebiges segments-Feld in die SELECT-Klausel der Suchanfrage einfügen. Wenn Sie in WHERE nach einem Kernsegment filtern, es aber nicht in SELECT auswählen, wird der Bericht nicht segmentiert. Wenn Sie einen Bericht beispielsweise nach segments.date segmentieren, werden die Messwerte nach Datum aufgeschlüsselt und für jedes Datum wird eine Zeile angezeigt. Daten ohne Messwerte werden in einem solchen Bericht nicht zurückgegeben.
Für die folgende Abfrage enthält der Bericht keine Zeilen mit Messwerten von null:
SELECT
campaign.name,
metrics.impressions,
segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Zurückgegebene Zeilen mit Messwerten von null
Zeilen, deren ausgewählte Messwerte alle null sind, werden bei der Segmentierung nicht zurückgegeben. Betrachten Sie beispielsweise die folgende Abfrage, bei 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
Datenaufbewahrungszeitraum 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) für Zeiträume, die älter als 37 Monate sind, geben in Version 24 und höher DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (oder in Version 23 DateRangeError.UNKNOWN) zurück. Aggregierte Daten auf hoher Ebene (segments.month, segments.quarter und segments.year) werden 11 Jahre lang aufbewahrt, ausgerichtet auf den Beginn des nächsten vollständigen Kalenderzeitraums. Wenn die
11-Jahres-Frist beispielsweise am 2015-03-22 (oder 2015-03-01) endet,
sind monatliche Daten ab dem ersten vollständigen Kalendermonat nach dem
Ende der Frist (2015-04-01) verfügbar. Weitere Informationen finden Sie unter Zeiträume.