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:
- Ansicht "Shoppingleistung"
- Produktgruppenansicht
- Asset-Gruppe – Produktgruppenansicht
- Shopping-Produkt
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
nachshopping_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.
ad_group
ad_group_ad
campaign
customer
(zusammengefasst für alle Kampagnen)product_group_view
shopping_performance_view
Die folgenden Messwerte für Warenkorbdaten können in Berichten, z. B. shopping_performance_view
, für Shopping-Kampagnen verwendet werden.
metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold
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