Keine Messwerte

In diesem Leitfaden wird erläutert, warum Zeilen mit Nullwerten in Google Ads API-Berichten angezeigt werden und wie Sie sie in Ihren Abfragen ausschließen oder verarbeiten können.

Null-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 Berichtszeitraums pausiert.

Mit Abfrageergebnissen möchten Sie oft Informationen zur Leistung Ihrer Kampagnen erhalten. In diesem Kontext sind Null-Messwerte möglicherweise nicht wünschenswert. Wenn Sie einen nützlicheren Bericht erstellen möchten, können Sie Nullmesswerte explizit ausschließen.

Nullmesswerte 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 Null-Messwerte mit einem Prädikat explizit entfernen:

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

Nullmesswerte durch Segmentierung ausschließen

Nullmesswerte werden beim Segmentieren eines Berichts immer ausgeschlossen, sofern alle ausgewählten Messwerte null sind (siehe Zurückgegebene Zeilen mit Nullmesswerten).

Ein Bericht wird segmentiert, indem ein beliebiges segments-Feld in die SELECT-Klausel der Suchanfrage aufgenommen wird. Wenn Sie in WHERE nach einem Haupt-Datumssegment filtern, ohne es in SELECT auszuwählen, wird der Bericht nicht segmentiert. Wenn Sie einen Bericht beispielsweise nach segments.date segmentieren, werden die Messwerte mit einer Zeile für jedes Datum aufgeschlüsselt. Tage ohne Messwerte werden in einem solchen Bericht nicht zurückgegeben.

Bei der folgenden Abfrage enthält der Bericht keine Zeilen mit Nullwerten:

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

Zurückgegebene Zeilen mit Null-Messwerten

Zeilen, deren ausgewählte Messwerte alle null sind, werden bei der Segmentierung nicht zurückgegeben. Betrachten Sie beispielsweise die folgende Abfrage, die metrics.impressions, metrics.clicks und metrics.conversions auswählt:

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 älter als die Datenaufbewahrungsdauer sind, 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 v24 und höher DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (oder in v23 DateRangeError.UNKNOWN) zurück. Allgemeine aggregierte Daten (segments.month, segments.quarter und segments.year) werden 11 Jahre lang aufbewahrt, beginnend mit dem Start des nächsten vollständigen Kalenderzeitraums. Wenn der 11-jährige Lookback-Zeitraum beispielsweise am 2015-03-22 (oder 2015-03-01) endet, sind monatliche Daten ab dem ersten vollständigen Kalendermonat nach dem Ende des Zeitraums (2015-04-01) verfügbar. Weitere Informationen finden Sie unter Zeiträume.

Unterdrückung von Reichweiten-Messwerten und Nullwerte

Neben Entitäten, für die keine Impressionen erzielt wurden, können auch Reichweiten-Messwerte (z. B. metrics.unique_users und Messwerte für Häufigkeitsgruppen metrics.unique_users_two_plus bis metrics.unique_users_ten_plus) als null angezeigt oder weggelassen werden, wenn Reichweitendaten unterdrückt werden. Der Messwert metrics.unique_users (und metrics.unique_users_info) wird für Display-, Video-, Demand Gen- und App-Kampagnen unterstützt, während die Messwerte für die Häufigkeitsgruppe metrics.unique_users_*_plus (und metrics.unique_users_*_plus_info) für Videokampagnen gelten.

Die Unterdrückung der Reichweite kann verschiedene Gründe haben:

• Datenschutzgrenzwerte: Reichweitendaten werden unterdrückt, wenn die Nutzerzahlen die Datenschutzgrenzwerte (z. B. k-Anonymität) nicht erfüllen, um die Identität der Nutzer zu schützen.
• Qualitätsschwellenwerte: Reichweitendaten werden möglicherweise nicht angezeigt, wenn sie nicht den Qualitätsstandards entsprechen.
• Datenaufbewahrung: Verlaufsdaten zur Reichweite werden 3 Jahre (36 Monate) lang aufbewahrt. Bei Abfragen, die über diesen Aufbewahrungszeitraum von 3 Jahren hinausgehen, können keine Reichweiten-Messwerte zurückgegeben werden. Abfragen, die Datumsangaben zwischen 36 und 37 Monaten abdecken, werden ohne Rückgabe von DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (wie im vorherigen Abschnitt beschrieben) ausgeführt. Reichweitenmesswerte werden jedoch weggelassen und DATE_RANGE_BEYOND_RETENTION wird zurückgegeben, wenn begleitende Reichweitenmetadaten ausgewählt sind.

In v26 und höher hat jeder Messwert für die Reichweite einzelner Nutzer ein zugehöriges Metadatenfeld vom Typ ReachMetricInfo (z. B. metrics.unique_users_info und metrics.unique_users_two_plus_info bis metrics.unique_users_ten_plus_info).

In der Google Ads Query Language (GAQL) sind Felder für die Companion-Reichweite MESSAGE-Messwerte, die direkt in der SELECT-Klausel ausgewählt werden (z. B. metrics.unique_users_info). Hängen Sie .reach_metric_states nicht in der SELECT-Klausel an, da die Auswahl verschachtelter Nachrichtenfelder in GAQL mit UNRECOGNIZED_FIELD fehlschlägt. Stattdessen wird durch die Auswahl von metrics.unique_users_info eine ReachMetricInfo-Nachricht zurückgegeben, die das wiederholte Enum-Feld reach_metric_states vom Typ ReachMetricState enthält, das beschreibt, ob der Messwert unterdrückt wurde oder vollständig ist.

Wenn ein Reichweiten-Messwert unterdrückt wird oder außerhalb des Aufbewahrungszeitraums (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION oder DATE_RANGE_BEYOND_RETENTION) liegt, wird das Feld optional int64 für Metrics nicht festgelegt (was zu 0 führt, wenn das Vorhandensein des Felds nicht geprüft wird). LOW_QUALITY füllt den numerischen Messwert jedoch weiterhin aus:

• COMPLETE: Der Reichweiten-Messwert ist vollständig und wurde nicht unterdrückt.
• PRIVACY_SUPPRESSION: Reichweitendaten wurden aufgrund von Datenschutzbeschränkungen unterdrückt.
• QUALITY_SUPPRESSION: Reichweitendaten wurden aus Gründen der Datenqualität unterdrückt.
• LOW_QUALITY: Der Reichweiten-Messwert wurde berechnet, aber als von geringer Qualität gekennzeichnet.
• DATE_RANGE_BEYOND_RETENTION: Reichweiten-Messwerte sind nicht verfügbar, da der Zeitraum außerhalb der 3-jährigen Datenaufbewahrungsdauer für Reichweitendaten liegt.

Wenn Sie sowohl den Reichweiten-Messwert als auch das zugehörige Metadatenfeld auswählen, kann Ihre Anwendung zwischen einer tatsächlichen Reichweite von null und unterdrückten Reichweitenwerten unterscheiden:

SELECT
  campaign.id,
  campaign.name,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Hinweis: Metadatenfelder für die Companion-Reichweite (metrics.unique_users*_info) sind MESSAGE-Messwerte mit filterable: false und sortable: false. Sie können daher nicht in WHERE- oder ORDER BY-Klauseln verwendet werden. Außerdem können Reichweiten-Messwerte nicht über Zeilen hinweg aggregiert werden. Der Messwert metrics.unique_users kann nur für Zeiträume von maximal 92 Tagen angefordert werden, während Messwerte für die Häufigkeitsgruppe unique_users_*_plus nur für Zeiträume von maximal 31 Tagen angefordert werden können. Eine vollständige Liste der Messwerte für Reichweite und Häufigkeit von Videoanzeigen finden Sie unter Berichte zu Reichweite und Häufigkeit von Kampagnen.