Berichterstellung

Wie bei anderen Anzeigentypen können Sie GoogleAdsService.SearchStream verwenden, um Produktstatus und Leistungsdaten für Shopping-Produkte abzurufen.

Für Kampagnen, die Produkte unterstützen, sind die folgenden Berichte verfügbar:

Shopping-Leistungsansicht

Die Shopping-Leistungsansicht enthält zusammengefasste Verlaufsdaten für Produkte nach Attributen wie product_item_id.

In der Shopping-Leistungsansicht wird der Status des Produkts zum Zeitpunkt der Erfassung der relevanten Messwerte erfasst. Dazu gehören Segmente wie product_title, die sich seit der Erfassung des Messwerts möglicherweise geändert haben.

Mit der folgenden Beispielabfrage werden Impressionen, Klicks, Kosten, Conversions und alle Conversions für Produkte nach product_item_id mit Klicks in den letzten 30 Tagen abgerufen (in absteigender Reihenfolge sortiert nach allen Conversions, dann Conversions, dann nach Klicks, schließlich nach Kosten und schließlich nach Impressionen):

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM  shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

Produktgruppenansicht

In der Produktgruppenansicht finden Sie zusammengefasste Berichtsstatistiken für Shopping-Eintragsgruppen. Diese werden in der Benutzeroberfläche als Produktgruppen bezeichnet. Beispiele für die Produktgruppenansicht für Asset-Gruppen finden Sie im Leitfaden zu Performance Max-Kampagnen.

Hier sehen Sie eine Beispielabfrage, mit der Impressionen, Klicks, Conversions und alle Conversions für Gruppen von Shopping-Einträgen nach Kampagne mit Impressionen in den letzten 30 Tagen abgerufen werden (in absteigender Reihenfolge nach allen Conversions > Conversions > Klicks > Impressionen sortiert):

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Shopping-Produkt

Der Bericht Shopping-Produkt enthält die Attribute und Berichtsstatistiken für Produkte, die in Google Merchant Center-Konten vorhanden sind, die mit dem Google Ads-Konto verknüpft sind. Mit diesem Bericht können Sie Statistiken auf Kunden-, Kampagnen- oder Anzeigengruppenebene überprüfen.

Mit dieser Beispielabfrage werden Impressionen, Klicks, Conversions und alle Conversions der letzten 30 Tage (in absteigender Reihenfolge sortiert nach allen Conversions, dann Conversions, dann Klicks und schließlich Impressionen) für alle Shopping-Produkte aus allen verknüpften Google Merchant Center-Konten abgerufen:

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Weitere Informationen zu Abfragen finden Sie im Leitfaden zu Berichten.

Hinweise zur Leistung

Der Shopping-Produktbericht kann eine große Menge an Daten zurückgeben, wenn ein Konto mit einer großen Anzahl von Produkten verknüpft ist. Die folgenden Empfehlungen können Ihnen dabei helfen, die Leistung Ihrer GAQL-Abfragen zu verbessern:

  • Abfragen auf Kampagnen- und Anzeigengruppenebene sind in der Regel schneller als Abfragen auf Kontoebene, da sie wahrscheinlich weniger Produkte enthalten und Zugriff auf weniger Daten erfordern.
  • Je mehr Felder und Messwerte die SELECT-Klausel enthält, desto langsamer ist die Antwortzeit. Wir empfehlen, nur die Felder und Messwerte auszuwählen, die in der Abfrage erforderlich sind.
  • Beachten Sie, dass Produkte mit einem oder mehreren Problemen mehr Daten zurückgeben. Sie können in der WHERE nach shopping_product.status filtern, um herauszufinden, welche Produkte wahrscheinlich Probleme zurückgeben, die den entsprechenden Status verursacht haben.

Anwendungsfälle für Shopping-Produktberichte

Der Bericht Shopping-Produkt bietet flexiblen Zugriff auf Produktinformationen für Kampagnen mit Produktfeeds. Sie erhalten damit einen Einblick in den Status von Produkten aus Google Merchant Center-Konten und können auch spezifische Informationen wie Leistungsmesswerte und Probleme anzeigen, die verhindern, dass Anzeigen für Produkte ausgeliefert werden.

In diesem Abschnitt werden einige typische Anwendungsfälle beschrieben, die denen in der Ansicht Produkte der Google Ads-Benutzeroberfläche ähneln.

Das Feld "issues" für das Shopping-Produkt ähnelt dem Feld productstatuses in der Content API for Shopping. Es gibt jedoch zusätzliche Probleme, die speziell für Google Ads gelten. Wenn du prüfen möchtest, ob das Problem im Google Merchant Center oder in Google Ads behoben werden muss, prüfe zuerst das Feld shopping_product.issues.documentation der Antwort. Es enthält auch einen Hilfeartikel.

Produktstatus (Kontoebene)

Wenn Sie den Bericht ohne Filter für die Kampagne oder Anzeigengruppe angeben, werden alle Produkte auf Kontoebene zurückgegeben.

Unterstützt werden Messwerte, Status und Probleme aller Kampagnen im Konto des folgenden Typs:

  • Shopping
  • Performance Max-Kampagnen

Diese Abfrage zeigt den Status des Produkts, z. B. NOT_ELIGIBLE, und eine Liste der produktspezifischen Probleme, die zu diesem Status geführt haben:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

Produktstatus (Kampagnenebene)

Wenn Sie den Bericht mit einer Kampagnenressource als Teil der WHERE-Klausel angeben, werden alle Produkte zurückgegeben, die in der ausgewählten Kampagne enthalten sind.

Die folgenden Kampagnentypen, für die Produktfeeds verwendet werden können, werden unterstützt:

  • Shopping
  • Performance Max-Kampagnen
  • Demand Gen
  • Video

Mit dieser Abfrage können Sie den Status des Produkts in einer bestimmten Kampagne ermitteln. Sie können damit den Status jedes Produkts prüfen, einschließlich der Probleme, die den Status verursachen. Eine pausierte Kampagne wirkt sich beispielsweise auf den Produktstatus aus:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"

Produktstatus (Anzeigengruppenebene)

Wenn Sie im Bericht sowohl eine Anzeigengruppen- als auch eine Kampagnenressource als Teil der WHERE-Klausel angeben, werden alle Produkte zurückgegeben, die in der ausgewählten Kampagne enthalten sind. Aus den Messwerten, dem Status und den Problemen des Produkts geht hervor, ob es in die ausgewählte Anzeigengruppe aufgenommen oder in der ausgewählten Anzeigengruppe ausgeschlossen ist.

Diese Abfrage zeigt den Status des Produkts in Bezug auf diese Anzeigengruppe an. Damit können Sie prüfen, ob Produktgruppenfilter (auf Anzeigengruppenebene) richtig angewendet werden, und den Status der einzelnen Produkte prüfen:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"
  AND shopping_product.ad_group = "customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>"

Produktmesswerte, gefiltert nach Datum (Kontoebene)

Wenn Sie in der WHERE-Klausel für den Bericht ein Datum oder einen Zeitraum angeben, werden für den angegebenen Zeitraum Messwerte für alle Produkte auf Kontoebene zurückgegeben, die unabhängig davon sind, ob die Messwerte ungleich null sind.

Sie können segments.date nicht auswählen, da dies zu einem UNSUPPORTED_DATE_SEGMENTATION-Fehler führen würde.

Mit dieser Abfrage können Sie die Leistung des aktuellen Produkts für einen bestimmten Tag oder einen anderen kompatiblen Datumswert anzeigen. Damit kann für jedes zurückgegebene Produkt, das über alle Kampagnen hinweg aggregiert wurde, eine Zusammenfassung erstellt werden:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date = '2024-01-01'

Produktleistung mit Warenkorbdaten

Werbetreibende im Einzelhandel haben Zugriff auf relevante Verkaufs- und Gewinnmesswerte wie Umsatz, Bruttogewinn, Bruttogewinnmarge und verkaufte Einheiten. Diese Messwerte stehen allen Werbetreibenden zur Verfügung, die in Shopping-Kampagnen Conversions mit Warenkorbdaten implementieren. Sie sind mit den folgenden Berichten kompatibel.

Die folgenden Messwerte für Warenkorbdaten können in Berichten, z. B. shopping_performance_view, für Shopping-Kampagnen verwendet werden.

Das folgende Beispiel zeigt, wie Messwerte für Warenkorbdaten verwendet werden können, um die Leistung auf Produktebene für Shopping-Kampagnen in den letzten 30 Tagen zu analysieren.

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

Kampagnenleistung mit Warenkorbdaten

Messwerte für Warenkorbdaten können auf Kampagnenebene verwendet und mit anderen Leistungsmesswerten wie Impressionen, Klicks und Kosten kombiniert werden.

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC