Package google.shopping.merchant.reports.v1beta

Index

ReportService

Dienst zum Abrufen von Berichten und Statistiken zu Ihren Produkten, deren Leistung und ihrem Wettbewerbsumfeld auf Google.

Suche

rpc Search(SearchRequest) returns (SearchResponse)

Ruft einen durch eine Suchanfrage definierten Bericht ab Die Antwort enthält möglicherweise weniger Zeilen als von page_size angegeben. Verwenden Sie next_page_token, um festzustellen, ob weitere Zeilen angefordert werden müssen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BestSellersBrandView

Für die Abfrage in Tabelle „best_sellers_brand_view“ verfügbare Felder.

Bestseller-Bericht mit Top-Marken.

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
report_date

Date

Datum des Berichts. Für dieses Feld ist nur einer der folgenden Werte zulässig:

  • Am ersten Tag der Woche (Montag) für wöchentliche Berichte
  • Der erste Tag des Monats für monatliche Berichte.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_date angegeben ist, wird der letzte verfügbare wöchentliche oder monatliche Bericht zurückgegeben.
report_granularity

ReportGranularityEnum

Detaillierungsgrad des Berichts. Die Einstufung kann über einen Zeitraum von einer Woche oder einem Monat erfolgen.

Erforderlich in der SELECT-Klausel. Eine Bedingung für report_granularity ist in der WHERE-Klausel erforderlich.
report_country_code

string

Land, in dem die Rangfolge berechnet wird. Wird im ISO 3166-Format dargestellt.

Erforderlich in der SELECT-Klausel. Eine Bedingung für report_country_code ist in der WHERE-Klausel erforderlich.
report_category_id

int64

ID der Google-Produktkategorie, für die der Rang berechnet werden soll, angegeben in der Produkt-Taxonomie von Google.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_category_id angegeben ist, werden Rankings für alle Kategorien der obersten Ebene zurückgegeben.
brand

string

Name der Marke.
rank

int64

Beliebtheit der Marke in Anzeigen und auf organischen Oberflächen in der ausgewählten Kategorie und im ausgewählten Land, basierend auf der geschätzten Anzahl verkaufter Einheiten.
previous_rank

int64

Beliebtheitsrang in der letzten Woche oder im letzten Monat.
relative_demand

RelativeDemandEnum

Geschätzte Nachfrage nach der Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.
previous_relative_demand

RelativeDemandEnum

Die geschätzte Nachfrage nach der Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der letzten Woche oder im letzten Monat.
relative_demand_change

RelativeDemandChangeTypeEnum

Änderung der geschätzten Nachfrage. Ob er aufstieg, sank oder flach blieb.

BestSellersProductClusterView

Für die Abfrage in Tabelle „best_sellers_product_cluster_view“ verfügbare Felder.

Bestsellerbericht mit den wichtigsten Produktclustern Ein Produkt-Cluster ist eine Gruppierung für verschiedene Angebote und Varianten, die dasselbe Produkt repräsentieren, z. B. Google Pixel 7.

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
report_date

Date

Datum des Berichts. Für dieses Feld ist nur einer der folgenden Werte zulässig:

  • Am ersten Tag der Woche (Montag) für wöchentliche Berichte
  • Der erste Tag des Monats für monatliche Berichte.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_date angegeben ist, wird der letzte verfügbare wöchentliche oder monatliche Bericht zurückgegeben.
variant_gtins[]

string

GTINs von Beispielvarianten des Produktclusters.
report_granularity

ReportGranularityEnum

Detaillierungsgrad des Berichts. Die Einstufung kann über einen Zeitraum von einer Woche oder einem Monat erfolgen.

Erforderlich in der SELECT-Klausel. Eine Bedingung für report_granularity ist in der WHERE-Klausel erforderlich.
report_country_code

string

Land, in dem die Rangfolge berechnet wird. Wird im ISO 3166-Format dargestellt.

Erforderlich in der SELECT-Klausel. Eine Bedingung für report_country_code ist in der WHERE-Klausel erforderlich.
report_category_id

int64

ID der Google-Produktkategorie, für die der Rang berechnet werden soll, angegeben in der Produkt-Taxonomie von Google.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_category_id angegeben ist, werden Rankings für alle Kategorien der obersten Ebene zurückgegeben.
title

string

Titel des Produktclusters.
brand

string

Marke des Produktclusters.
category_l1

string

Produktkategorie (1. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google.
category_l2

string

Produktkategorie (2. Ebene) des Produktclusters, die in der Produkt-Taxonomie von Google dargestellt wird.
category_l3

string

Produktkategorie (3. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google.
category_l4

string

Produktkategorie (4. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google.
category_l5

string

Produktkategorie (5. Ebene) des Produktclusters, der in der Produkt-Taxonomie von Google dargestellt wird.
inventory_status

InventoryStatus

Gibt an, ob der Produktcluster in Ihrer Produktdatenquelle in mindestens einem der Länder IN_STOCK, in Ihrer Produktdatenquelle in allen Ländern OUT_OF_STOCK oder überhaupt NOT_IN_INVENTORY ist.

Bei dem Feld wird der Länderfilter nicht berücksichtigt.
brand_inventory_status

InventoryStatus

Unabhängig davon, ob mindestens ein Produkt der Marke derzeit in Ihrer Produktdatenquelle in mindestens einem der Länder IN_STOCK ist, haben alle Produkte den Status „OUT_OF_STOCK“ in Ihrer Produktdatenquelle in allen Ländern oder NOT_IN_INVENTORY.

Bei dem Feld wird der Länderfilter nicht berücksichtigt.
rank

int64

Beliebtheit des Produkt-Clusters auf Anzeigen und organischen Oberflächen in der ausgewählten Kategorie und im ausgewählten Land, basierend auf der geschätzten Anzahl verkaufter Einheiten.
previous_rank

int64

Beliebtheitsrang in der letzten Woche oder im letzten Monat.
relative_demand

RelativeDemandEnum

Geschätzte Nachfrage im Verhältnis zum Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.
previous_relative_demand

RelativeDemandEnum

Geschätzte Nachfrage im Vergleich zum Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der letzten Woche oder im letzten Monat.
relative_demand_change

RelativeDemandChangeTypeEnum

Änderung der geschätzten Nachfrage. Ob er aufstieg, sank oder flach blieb.

InventoryStatus

Status des Produktclusters oder der Marke in Ihrem Inventar.

Enums
INVENTORY_STATUS_UNSPECIFIED Nicht angegeben.
IN_STOCK Sie haben ein Produkt für diesen Produktcluster oder diese Marke auf Lager.
OUT_OF_STOCK Sie haben ein Produkt für diesen Produktcluster oder diese Marke im Inventar, das aber derzeit nicht auf Lager ist.
NOT_IN_INVENTORY Sie haben kein Produkt für diesen Produktcluster oder diese Marke im Inventar.

CompetitiveVisibilityBenchmarkView

Für die Abfrage in Tabelle „competitive_visibility_benchmark_view“ verfügbare Felder.

Bericht Mitbewerber im Blick mit der Benchmark der Kategorie

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
date

Date

Das Datum dieser Zeile.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für date erforderlich.
report_country_code

string

Land, in dem Impressionen erschienen sind.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

ID der Google-Produktkategorie, für die der Bericht berechnet werden soll, angegeben in der Produkt-Taxonomie von Google

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_category_id erforderlich.
traffic_source

TrafficSourceEnum

Besucherquelle für Impressionen.

Erforderlich in der SELECT-Klausel.
your_domain_visibility_trend

double

Änderung der Sichtbarkeit basierend auf den Impressionen für Ihre Domain bezogen auf den Beginn des ausgewählten Zeitraums (oder den ersten Tag mit Impressionen ungleich null).

Kein Filter in der WHERE-Klausel möglich.
category_benchmark_visibility_trend

double

Änderung der Sichtbarkeit basierend auf Impressionen in Bezug auf den Beginn des ausgewählten Zeitraums (oder den ersten Tag mit Impressionen ungleich null) für eine kombinierte Gruppe von Händlern mit der höchsten Sichtbarkeit in Bezug auf den Markt.

Kein Filter in der WHERE-Klausel möglich.

CompetitiveVisibilityCompetitorView

Für die Abfrage in Tabelle „competitive_visibility_competitor_view“ verfügbare Felder.

Der Bericht Mitbewerber im Blick enthält Unternehmen mit ähnlicher Sichtbarkeit.

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
date

Date

Das Datum dieser Zeile.

In der WHERE-Klausel ist eine Bedingung für date erforderlich.
domain

string

Domain Ihres Mitbewerbers oder Ihrer Domain, wenn „is_your_domain“ wahr ist.

Erforderlich in der SELECT-Klausel. Kein Filter in der WHERE-Klausel möglich.
is_your_domain

bool

Dieser Wert ist „True“, wenn diese Zeile Daten für Ihre Domain enthält.

Kein Filter in der WHERE-Klausel möglich.
report_country_code

string

Land, in dem Impressionen erschienen sind.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

ID der Google-Produktkategorie, für die der Bericht berechnet werden soll, angegeben in der Produkt-Taxonomie von Google

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_category_id erforderlich.
traffic_source

TrafficSourceEnum

Besucherquelle für Impressionen.

Erforderlich in der SELECT-Klausel.
rank

int64

Position der Domain im Ranking ähnlicher Unternehmen für die ausgewählten Schlüssel (date, report_category_id, report_country_code, traffic_source) basierend auf Impressionen. 1 ist die höchste Zahl.

Kein Filter in der WHERE-Klausel möglich.
ads_organic_ratio

double

Verhältnis „Anzeigen / Organisch“ gibt an, wie oft die Domain Impressionen über Shopping-Anzeigen im Vergleich zu organischen Zugriffen erhält. Die Zahl wird gerundet und gruppiert.

Kein Filter in der WHERE-Klausel möglich.
page_overlap_rate

double

Häufigkeit der Seitenüberschneidung gibt an, wie oft die Angebote von Mitbewerbern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kein Filter in der WHERE-Klausel möglich.
higher_position_rate

double

Der Wert Rate höherer Position gibt an, wie oft das Angebot eines Mitbewerbers an einer höheren Position auf der Seite platziert wurde als Ihr Angebot.

Kein Filter in der WHERE-Klausel möglich.
relative_visibility

double

Die relative Sichtbarkeit gibt an, wie oft die Angebote Ihrer Mitbewerber im Vergleich zu Ihren Angeboten angezeigt werden. Sie ergibt sich also aus der Anzahl der angezeigten Impressionen eines Mitbewerbers, geteilt durch die Anzahl der angezeigten Impressionen in einem bestimmten Zeitraum für eine bestimmte Produktkategorie und ein bestimmtes Land.

Kein Filter in der WHERE-Klausel möglich.

CompetitiveVisibilityTopMerchantView

Für die Abfrage in Tabelle „competitive_visibility_top_merchant_view“ verfügbare Felder.

Im Bericht Mitbewerber im Blick finden Sie das Unternehmen mit der höchsten Sichtbarkeit.

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
date

Date

Das Datum dieser Zeile.

Kann in der SELECT-Klausel nicht ausgewählt werden. In der WHERE-Klausel ist eine Bedingung für date erforderlich.
domain

string

Domain Ihres Mitbewerbers oder Ihrer Domain, wenn „is_your_domain“ wahr ist.

Erforderlich in der SELECT-Klausel. Kein Filter in der WHERE-Klausel möglich.
is_your_domain

bool

Dieser Wert ist „True“, wenn diese Zeile Daten für Ihre Domain enthält.

Kein Filter in der WHERE-Klausel möglich.
report_country_code

string

Land, in dem Impressionen erschienen sind.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

ID der Google-Produktkategorie, für die der Bericht berechnet werden soll, angegeben in der Produkt-Taxonomie von Google

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_category_id erforderlich.
traffic_source

TrafficSourceEnum

Besucherquelle für Impressionen.

Erforderlich in der SELECT-Klausel.
rank

int64

Die Position der Domain unter den Top-Händlern für die ausgewählten Schlüssel (date, report_category_id, report_country_code, traffic_source) basierend auf den Impressionen. 1 ist die höchste Zahl.

Kein Filter in der WHERE-Klausel möglich.
ads_organic_ratio

double

Verhältnis „Anzeigen / Organisch“ gibt an, wie oft die Domain Impressionen über Shopping-Anzeigen im Vergleich zu organischen Zugriffen erhält. Die Zahl wird gerundet und gruppiert.

Kein Filter in der WHERE-Klausel möglich.
page_overlap_rate

double

Häufigkeit der Seitenüberschneidung gibt an, wie oft die Angebote von Mitbewerbern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kein Filter in der WHERE-Klausel möglich.
higher_position_rate

double

Der Wert Rate höherer Position gibt an, wie oft das Angebot eines Mitbewerbers an einer höheren Position auf der Seite platziert wurde als Ihr Angebot.

Kein Filter in der WHERE-Klausel möglich.

MarketingMethod

Dieser Typ hat keine Felder.

Marketingmethode, mit der Ihre Produkte auf Google beworben werden (organische vs. Anzeigen).

MarketingMethodEnum

Werte der Marketingmethode

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED Nicht angegeben.
ORGANIC Organisches Marketing
ADS Anzeigenbasiertes Marketing

NonProductPerformanceView

Für die Abfrage in Tabelle „non_product_performance_view“ verfügbare Felder.

Leistungsdaten zu Bildern und Links zu Onlineshops, die zu Ihren nicht produktbezogenen Seiten führen. Dazu gehören Leistungsmesswerte (z. B. clicks) und Dimensionen, nach denen Leistungsmesswerte segmentiert sind (z. B. date).

Segmentfelder können nur in Abfragen ausgewählt werden, wenn mindestens ein Messwertfeld ausgewählt wurde.

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
date

Date

Datum in der Zeitzone des Händlers, für die Messwerte gelten. Segment.

Eine Bedingung für date ist in der WHERE-Klausel erforderlich.
week

Date

Erster Tag der Woche (Montag) des Messwertdatums in der Zeitzone des Händlers. Segment.
clicks

int64

Anzahl der Klicks auf Bilder und Links zu Onlineshops, die zu nicht produktbezogenen Seiten führen. Messwert.
impressions

int64

Gibt an, wie oft Bilder und Links zu Onlineshops angezeigt wurden, die zu Ihren nicht produktbezogenen Seiten führen. Messwert.
click_through_rate

double

Klickrate – die Anzahl der Klicks (clicks) geteilt durch die Anzahl der Impressionen (impressions) von Bildern und Onlineshop-Links, die zu Ihren nicht produktbezogenen Seiten führen. Messwert.

PriceCompetitivenessProductView

Für die Abfrage in Tabelle „price_competitiveness_product_view“ verfügbare Felder.

Bericht zur Wettbewerbsfähigkeit von Preisen

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
price

Price

Aktueller Preis des Produkts.
benchmark_price

Price

Neueste verfügbare Preisvergleiche für den Katalog des Produkts im Vergleichsland.
report_country_code

string

Land des Preisvergleichs. Wird im ISO 3166-Format dargestellt.

Erforderlich in der SELECT-Klausel.
id

string

REST-ID des Produkts im Format channel~languageCode~feedLabel~offerId. Kann verwendet werden, um Daten mit der Tabelle product_view zu verknüpfen.

Erforderlich in der SELECT-Klausel.
offer_id

string

Vom Händler angegebene ID des Produkts.
title

string

Titel des Produkts.
brand

string

Marke des Produkts.
category_l1

string

Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google.
category_l2

string

Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google.
category_l3

string

Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google.
category_l4

string

Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google.
category_l5

string

Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google.
product_type_l1

string

Produkttyp (1. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l2

string

Produkttyp (2. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l3

string

Produkttyp (3. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l4

string

Produkttyp (4. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l5

string

Produkttyp (5. Ebene) in der eigenen Produkt-Taxonomie des Händlers.

PriceInsightsProductView

Für die Abfrage in Tabelle „price_insights_product_view“ verfügbare Felder.

Bericht zu Preisstatistiken

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
price

Price

Aktueller Preis des Produkts.
suggested_price

Price

Die aktuelle Preisvorstellung für das Produkt.
effectiveness

Effectiveness

Die prognostizierte Effektivität der Anwendung des Preisvorschlags, aufgeschlüsselt.
id

string

REST-ID des Produkts im Format channel~languageCode~feedLabel~offerId. Kann verwendet werden, um Daten mit der Tabelle product_view zu verknüpfen.

Erforderlich in der SELECT-Klausel.
offer_id

string

Vom Händler angegebene ID des Produkts.
title

string

Titel des Produkts.
brand

string

Marke des Produkts.
category_l1

string

Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google.
category_l2

string

Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google.
category_l3

string

Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google.
category_l4

string

Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google.
category_l5

string

Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google.
product_type_l1

string

Produkttyp (1. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l2

string

Produkttyp (2. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l3

string

Produkttyp (3. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l4

string

Produkttyp (4. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l5

string

Produkttyp (5. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
predicted_impressions_change_fraction

double

Geschätzte Änderung der Impressionen als Anteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuellen aktiven Preis. Beispielsweise ist 0, 05 eine prognostizierte Steigerung der Impressionen um 5 %.
predicted_clicks_change_fraction

double

Geschätzte Änderung der Klicks als Anteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuellen aktiven Preis. Beispiel: 0, 05 ist eine prognostizierte Steigerung der Klicks um 5 %.
predicted_conversions_change_fraction

double

Geschätzte Änderung der Conversions als Anteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuellen aktiven Preis. Beispiel: 0, 05 ist eine prognostizierte Steigerung der Conversions um 5 %.

Wirksamkeit

Gruppe mit prognostizierter Effektivität.

Die Effektivität gibt an, welche Produkte am meisten von Preisänderungen profitieren würden. Bei dieser Bewertung wird die prognostizierte Leistungssteigerung durch eine Anpassung des Sonderangebotspreises sowie die Differenz zwischen dem aktuellen und dem vorgeschlagenen Preis berücksichtigt. Preisvorschläge mit einer Effektivität von HIGH werden voraussichtlich die größte Leistungssteigerung bewirken.

Enums
EFFECTIVENESS_UNSPECIFIED Die Effektivität ist unbekannt.
LOW Die Effektivität ist gering.
MEDIUM Effektivität ist mittel.
HIGH Die Effektivität ist hoch.

ProductPerformanceView

Für die Abfrage in Tabelle „product_performance_view“ verfügbare Felder.

Daten zur Produktleistung für Ihr Konto, einschließlich Leistungsmesswerten (z. B. clicks) und Dimensionen, nach denen Leistungsmesswerte segmentiert sind (z. B. offer_id). Werte von Produktdimensionen (z. B. offer_id) spiegeln den Status eines Produkts zum Zeitpunkt der Impression wider.

Segmentfelder können nur in Abfragen ausgewählt werden, wenn mindestens ein Messwertfeld ausgewählt wurde.

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
date

Date

Datum in der Zeitzone des Händlers, für die Messwerte gelten. Segment.

Eine Bedingung für date ist in der WHERE-Klausel erforderlich.
week

Date

Erster Tag der Woche (Montag) des Messwertdatums in der Zeitzone des Händlers. Segment.
conversion_value

Price

Wert der dem Produkt zugeordneten Conversions, erfasst am Conversion-Datum. Messwert.

Nur für die Besucherquelle „FREE“ verfügbar.
marketing_method

MarketingMethodEnum

Marketingmethode, für die Messwerte gelten. Segment.
customer_country_code

string

Code des Landes, in dem sich der Kunde zum Zeitpunkt des Ereignisses befindet. Wird im ISO 3166-Format dargestellt. Segment.

Wenn das Land des Kunden nicht ermittelt werden kann, wird ein spezieller ZZ-Code zurückgegeben.
offer_id

string

Vom Händler angegebene ID des Produkts. Segment.
title

string

Titel des Produkts. Segment.
brand

string

Marke des Produkts. Segment.
category_l1

string

Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l2

string

Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l3

string

Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l4

string

Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l5

string

Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google. Segment.
product_type_l1

string

Produkttyp (1. Ebene) in der Produkt-Taxonomie des Händlers. Segment.
product_type_l2

string

Produkttyp (2. Ebene) in der Produkt-Taxonomie des Händlers. Segment.
product_type_l3

string

Produkttyp (3. Ebene) in der Produkt-Taxonomie des Händlers. Segment.
product_type_l4

string

Produkttyp (4. Ebene) in der Produkt-Taxonomie des Händlers. Segment.
product_type_l5

string

Produkttyp (5. Ebene) in der Produkt-Taxonomie des Händlers. Segment.
custom_label0

string

Benutzerdefiniertes Label 0 für benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label1

string

Benutzerdefiniertes Label 1 für benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label2

string

Benutzerdefiniertes Label 2 für die benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label3

string

Benutzerdefiniertes Label 3 für die benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label4

string

Benutzerdefiniertes Label 4 für die benutzerdefinierte Gruppierung von Produkten. Segment.
clicks

int64

Anzahl der Klicks Messwert.
impressions

int64

Gibt an, wie oft die Produkte des Händlers angezeigt werden. Messwert.
click_through_rate

double

Klickrate – die Anzahl der Klicks, die Händler auf die Produkte erhalten (Klicks), geteilt durch die Häufigkeit, mit der die Produkte angezeigt werden (Impressionen). Messwert.
conversions

double

Anzahl der dem Produkt zugeordneten Conversions, erfasst am Conversion-Datum. Je nach Attributionsmodell kann eine Conversion auf mehrere Klicks verteilt werden, wobei jedem Klick ein eigenes Guthaben zugeordnet wird. Dieser Messwert ist die Summe aller entsprechenden Guthaben. Messwert.

Nur für die Besucherquelle „FREE“ verfügbar.
conversion_rate

double

Die Anzahl der Conversions geteilt durch die Anzahl der Klicks, erfasst am Impressionsdatum. Messwert.

Nur für die Besucherquelle „FREE“ verfügbar.

ProductView

Für die Abfrage in Tabelle „product_view“ verfügbare Felder.

Produkte im aktuellen Inventar. Die Produkte in dieser Tabelle sind dieselben wie in der Unter-API „Produkte“, es können jedoch nicht alle Produktattribute aus der Unter-API „Produkte“ in dieser Tabelle abgefragt werden. Im Gegensatz zur Sub-API „Products“ können Sie in dieser Tabelle die zurückgegebene Produktliste nach Produktattributen filtern. Um ein einzelnes Produkt nach id abzurufen oder alle Produkte aufzulisten, sollte die Sub-API „Products“ verwendet werden.

Werte werden nur für Felder festgelegt, die explizit in der Suchanfrage der Anfrage angefordert werden.

Felder
price

Price

Produktpreis Wird nicht angezeigt, wenn keine Preisinformationen verfügbar sind.
gtin[]

string

Liste der Global Trade Item Numbers (GTINs) des Produkts.
creation_time

Timestamp

Die Zeit, zu der der Händler das Produkt erstellt hat, in Sekunden angegeben.
expiration_date

Date

Ablaufdatum für das Produkt, das beim Einfügen angegeben wurde.
item_issues[]

ItemIssue

Liste der Artikelprobleme bei dem Produkt.

Dieses Feld kann nicht zum Sortieren der Ergebnisse verwendet werden.

Nur ausgewählte Attribute dieses Felds (z. B. item_issues.severity.aggregated_severity) können zum Filtern der Ergebnisse verwendet werden.
click_potential

ClickPotential

Geschätztes Leistungspotenzial im Vergleich zu den leistungsstärksten Produkten des Händlers.
id

string

REST-ID des Produkts im Format channel~languageCode~feedLabel~offerId. Händler-API-Methoden für Produkte verwenden diesen als name-Parameter.

Erforderlich in der SELECT-Klausel.
channel

ChannelEnum

Kanal des Produkts. Kann ONLINE oder LOCAL sein.
language_code

string

Sprachcode des Produkts im BCP-47-Format.
feed_label

string

Feedlabel des Produkts.
offer_id

string

Vom Händler angegebene ID des Produkts.
title

string

Titel des Produkts.
brand

string

Marke des Produkts.
category_l1

string

Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google.
category_l2

string

Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google.
category_l3

string

Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google.
category_l4

string

Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google.
category_l5

string

Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google.
product_type_l1

string

Produkttyp (1. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l2

string

Produkttyp (2. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l3

string

Produkttyp (3. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l4

string

Produkttyp (4. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
product_type_l5

string

Produkttyp (5. Ebene) in der eigenen Produkt-Taxonomie des Händlers.
condition

string

Zustand des Produkts.
availability

string

Die Verfügbarkeit des Produkts.
shipping_label

string

In der Datenquelle angegebenes normalisiertes Versandlabel.
item_group_id

string

Vom Händler angegebene Artikelgruppen-ID, um Varianten zu gruppieren.
aggregated_reporting_context_status

AggregatedReportingContextStatus

Zusammengefasster Status.
click_potential_rank

int64

Rang des Produkts basierend auf seinem Klickpotenzial. Ein Produkt mit click_potential_rank 1 hat unter den Produkten des Händlers, die die Bedingungen der Suchanfrage erfüllen, das höchste Klickpotenzial.

AggregatedReportingContextStatus

Status des Produkts, aggregiert für alle Berichtskontexte.

Hier ein Beispiel für die Berechnung des aggregierten Status:

Produkteinträge Shopping-Anzeigen Status
Genehmigt Genehmigt ELIGIBLE
Genehmigt Ausstehend ELIGIBLE
Genehmigt Abgelehnt ELIGIBLE_LIMITED
Ausstehend Ausstehend AUSSTEHEND
Abgelehnt Abgelehnt NOT_ELIGIBLE_OR_DISAPPROVED
Enums
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Nicht angegeben.
NOT_ELIGIBLE_OR_DISAPPROVED Das Produkt ist nicht aktiv oder wurde für alle Berichtskontexte abgelehnt.
PENDING Der Status des Produkts ist in allen Berichtskontexten „Ausstehend“.
ELIGIBLE_LIMITED Das Produkt kommt für einige (aber nicht alle) Berichtskontexte infrage.
ELIGIBLE Das Produkt kommt für alle Berichtskontexte infrage.

ClickPotential

Anhand des Klickpotenzials eines Produkts wird das Leistungspotenzial im Vergleich zu den leistungsstärksten Produkten des Händlers geschätzt. Anhand des Klickpotenzials eines Produkts können Händler priorisieren, bei welchen Produkten Probleme auftreten, und sie können besser nachvollziehen, wie gut die Produkte im Hinblick auf ihr Potenzial abschneiden.

Enums
CLICK_POTENTIAL_UNSPECIFIED Unbekannte prognostizierte Auswirkungen auf Klicks.
LOW Sie könnten eine geringe Anzahl von Klicks im Vergleich zu den leistungsstärksten Produkten des Händlers erhalten.
MEDIUM Sie könnten im Vergleich zu den leistungsstärksten Produkten des Händlers eine mittlere Anzahl von Klicks erzielen.
HIGH Sie könnten eine ähnliche Anzahl von Klicks wie die leistungsstärksten Produkte des Händlers erhalten.

ItemIssue

Problem mit dem Artikel in Verbindung mit dem Produkt.

Felder
type

ItemIssueType

Art des Artikelproblems.
severity

ItemIssueSeverity

Schweregrad des Artikelproblems.
resolution

ItemIssueResolution

Lösung des Artikelproblems.

ItemIssueResolution

So kannst du das Problem beheben:

Enums
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Nicht angegeben.
MERCHANT_ACTION Der Händler muss das Problem beheben.
PENDING_PROCESSING Das Problem wird automatisch behoben (z. B. durch das Crawlen von Bildern) oder durch eine Überprüfung durch Google. Derzeit ist keine Aktion des Händlers erforderlich. Die Behebung kann zu einem anderen Problem führen, z. B. wenn das Crawling fehlschlägt.

ItemIssueSeverity

Wie sich das Problem auf die Bereitstellung des Produkts auswirkt.

Felder
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Schweregrad des Problems je Berichtskontext.
aggregated_severity

AggregatedIssueSeverity

Zusammengefasster Schweregrad des Problems für alle betroffenen Berichtskontexte.

Dieses Feld kann zum Filtern der Ergebnisse verwendet werden.

AggregatedIssueSeverity

Schweregrad des Problems für alle Berichtskontexte zusammengefasst.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Nicht angegeben.
DISAPPROVED Aufgrund des Problems wird das Produkt in mindestens einem Berichtskontext abgelehnt.
DEMOTED Durch das Problem wird das Produkt in allen betroffenen Berichtskontexten herabgestuft.
PENDING Die Problemlösung ist PENDING_PROCESSING.

IssueSeverityPerReportingContext

Schweregrad des Problems je Berichtskontext.

Felder
disapproved_countries[]

string

Liste der abgelehnten Länder im Berichtskontext im ISO-3166-Format.
demoted_countries[]

string

Liste der abgewerteten Länder im Berichtskontext im ISO-3166-Format.
reporting_context

ReportingContextEnum

Berichtskontext, in dem das Problem auftritt.

ItemIssueType

Art des Problems:

Felder
code

string

Fehlercode des Problems, entspricht dem code der Produktprobleme.
canonical_attribute

string

Kanonischer Attributname für attributspezifische Probleme.

RelativeDemand

Dieser Typ hat keine Felder.

Relative Nachfrage nach einem Produktcluster oder einer Marke im Bestsellerbericht.

RelativeDemandEnum

Relative Nachfragewerte

Enums
RELATIVE_DEMAND_ENUM_UNSPECIFIED Nicht angegeben.
VERY_LOW Die Nachfrage entspricht 0–5% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
LOW Die Nachfrage entspricht 6–10% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
MEDIUM Die Nachfrage entspricht 11–20% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
HIGH Die Nachfrage entspricht 21–50% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
VERY_HIGH Die Nachfrage entspricht 51–100% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.

RelativeDemandChangeType

Dieser Typ hat keine Felder.

Die relative Nachfrage nach einem Produktcluster oder einer Marke im Bestsellerbericht im Vergleich zum vorherigen Zeitraum.

RelativeDemandChangeTypeEnum

Werte für den Typ der relativen Nachfrageänderung.

Enums
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Nicht angegeben.
SINKER Die relative Nachfrage ist niedriger als im vorherigen Zeitraum.
FLAT Die relative Nachfrage entspricht der relativen Nachfrage im vorherigen Zeitraum.
RISER Die relative Nachfrage ist höher als im vorherigen Zeitraum.

ReportGranularity

Dieser Typ hat keine Felder.

Detaillierungsgrad des Bestsellerberichts. Bestseller-Berichte werden über eine Woche und einen Monat berechnet.

ReportGranularityEnum

Detaillierungsgrad der Berichte

Enums
REPORT_GRANULARITY_ENUM_UNSPECIFIED Nicht angegeben.
WEEKLY Die Berechnung des Berichts erfolgt über eine Woche.
MONTHLY Der Bericht wird über einen Zeitraum von einem Monat berechnet.

ReportRow

Ergebniszeile, die von der Suchanfrage zurückgegeben wurde.

Nur die Nachricht, die der abgefragten Tabelle entspricht, wird in die Antwort eingefügt. In der Nachricht werden nur die Felder ausgefüllt, die explizit in der Abfrage angefordert wurden.

Felder
product_performance_view

ProductPerformanceView

Für die Abfrage in Tabelle „product_performance_view“ verfügbare Felder.
non_product_performance_view

NonProductPerformanceView

Für die Abfrage in Tabelle „non_product_performance_view“ verfügbare Felder.
product_view

ProductView

Für die Abfrage in Tabelle „product_view“ verfügbare Felder.
price_competitiveness_product_view

PriceCompetitivenessProductView

Für die Abfrage in Tabelle „price_competitiveness_product_view“ verfügbare Felder.
price_insights_product_view

PriceInsightsProductView

Für die Abfrage in Tabelle „price_insights_product_view“ verfügbare Felder.
best_sellers_product_cluster_view

BestSellersProductClusterView

Für die Abfrage in Tabelle „best_sellers_product_cluster_view“ verfügbare Felder.
best_sellers_brand_view

BestSellersBrandView

Für die Abfrage in Tabelle „best_sellers_brand_view“ verfügbare Felder.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Für die Abfrage in Tabelle „competitive_visibility_competitor_view“ verfügbare Felder.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Für die Abfrage in Tabelle „competitive_visibility_top_merchant_view“ verfügbare Felder.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Für die Abfrage in Tabelle „competitive_visibility_benchmark_view“ verfügbare Felder.

SearchRequest

Anfragenachricht für die Methode ReportService.Search.

Felder
parent

string

Erforderlich. ID des Kontos, das den Anruf tätigt. Muss ein eigenständiges Konto oder ein MCA-Unterkonto sein. Format: accounts/{account}
query

string

Erforderlich. Abfrage, die einen abzurufenden Bericht definiert.

Ausführliche Informationen zum Erstellen Ihrer Abfrage finden Sie im Leitfaden zur Abfragesprache. Eine vollständige Liste der verfügbaren Tabellen und Felder finden Sie unter Verfügbare Felder.
page_size

int32

Optional. Anzahl der ReportRows, die auf einer einzelnen Seite abgerufen werden sollen. Die Standardeinstellung ist 1.000. Für Werte über 5.000 wird 5.000 erzwungen.
page_token

string

Optional. Token der abzurufenden Seite. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben. Um die nächste Ergebnisseite anzufordern, sollte der Wert aus next_page_token in der vorherigen Antwort verwendet werden.

SearchResponse

Antwortnachricht für die Methode ReportService.Search.

Felder
results[]

ReportRow

Zeilen, die der Suchanfrage entsprechen.
next_page_token

string

Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wird sie weggelassen, gibt es keine nachfolgenden Seiten.

TrafficSource

Dieser Typ hat keine Felder.

Zugriffsquellen von Impressionen im Bericht „Mitbewerber im Blick“.

TrafficSourceEnum

Werte für Besucherquellen

Enums
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Nicht angegeben.
ORGANIC Organische Zugriffe.
ADS Zugriffe über Anzeigen.
ALL Organische Zugriffe und Anzeigentraffic.