Method: accounts.reports.search

Ruft einen durch eine Suchanfrage definierten Bericht ab. Die Antwort enthält möglicherweise weniger Zeilen als von pageSize angegeben. Verlassen Sie sich auf nextPageToken, um festzustellen, ob weitere Zeilen angefordert werden sollen.

HTTP-Anfrage

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die ID des Kontos, das den Anruf durchführt. Muss ein eigenständiges Konto oder ein MCA-Unterkonto sein. Format: accounts/{account}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
Felder
query

string

Erforderlich. Abfrage, die einen abzurufenden Bericht definiert.

Weitere Informationen zum Erstellen einer Abfrage finden Sie im Query Language-Handbuch. Eine vollständige Liste der verfügbaren Tabellen und Felder finden Sie unter Verfügbare Felder.

pageSize

integer

Optional. Anzahl der ReportRows, die auf einer einzelnen Seite abgerufen werden sollen. Die Standardeinstellung ist 1.000. Werte über 5.000 werden in 5.000 umgewandelt.

pageToken

string

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

Antworttext

Antwortnachricht für die Methode ReportService.Search.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Felder
results[]

object (ReportRow)

Zeilen, die mit der Suchanfrage übereinstimmen.

nextPageToken

string

Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn keine Angabe gemacht wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

ReportRow

Die von der Suchanfrage zurückgegebene Ergebniszeile.

Nur die Nachricht, die der abgefragten Tabelle entspricht, wird in die Antwort eingefügt. Innerhalb der ausgefüllten Nachricht werden nur die Felder ausgefüllt, die ausdrücklich in der Abfrage angefordert wurden.

JSON-Darstellung
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Felder
productPerformanceView

object (ProductPerformanceView)

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

nonProductPerformanceView

object (NonProductPerformanceView)

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

productView

object (ProductView)

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

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

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

priceInsightsProductView

object (PriceInsightsProductView)

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

bestSellersProductClusterView

object (BestSellersProductClusterView)

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

bestSellersBrandView

object (BestSellersBrandView)

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

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

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

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

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

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

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

ProductPerformanceView

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

Produktleistungsdaten für Ihr Konto, einschließlich Leistungsmesswerte (z. B. clicks) und Dimensionen, nach denen die Leistungsmesswerte segmentiert sind (z. B. offerId). Die Werte von Produktdimensionen wie offerId 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 ist.

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

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Felder
date

object (Date)

Datum in der Händlerzeitzone, für die Messwerte gelten. Segment.

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

week

object (Date)

Erster Wochentag (Montag) des Messwertdatums in der Händlerzeitzone. Segment.

conversionValue

object (Price)

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

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

marketingMethod

enum (MarketingMethodEnum)

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

customerCountryCode

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 Code „ZZ“ zurückgegeben.

offerId

string

Vom Händler bereitgestellte ID des Produkts. Segment.

title

string

Titel des Produkts. Segment.

brand

string

Marke des Produkts. Segment.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

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

clicks

string (int64 format)

Anzahl der Klicks Messwert.

impressions

string (int64 format)

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

clickThroughRate

number

Klickrate (Click-through-Rate, CTR): die Anzahl der Klicks auf die Produkte des Händlers (Klicks) geteilt durch die Anzahl der Einblendungen der Produkte (Impressionen). Messwert.

conversions

number

Die Anzahl der dem Produkt zugeordneten Conversions, die am Conversion-Datum erfasst wurden. Je nach Attributionsmodell kann eine Conversion auf mehrere Klicks verteilt sein, wobei jedem Klick ein anderer Wert zugeordnet wird. Dieser Messwert ergibt sich aus der Summe all dieser Gutschriften. Messwert.

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

conversionRate

number

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

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

MarketingMethodEnum

Werte für Marketingmethoden

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED Nicht angegeben.
ORGANIC Organisches Marketing
ADS Anzeigenbasiertes Marketing

NonProductPerformanceView

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

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

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

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

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Felder
date

object (Date)

Datum in der Händlerzeitzone, für die Messwerte gelten. Segment.

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

week

object (Date)

Erster Wochentag (Montag) des Messwertdatums in der Händlerzeitzone. Segment.

clicks

string (int64 format)

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

impressions

string (int64 format)

Die Häufigkeit, mit der Bilder und Links zu Onlineshops, die zu nicht produktbezogenen Seiten führen, angezeigt wurden. Messwert.

clickThroughRate

number

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.

ProductView

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

Produkte im aktuellen Inventar. Die Produkte in dieser Tabelle sind dieselben wie in der Unter-API „Produkte“, aber nicht alle Produktattribute der untergeordneten API „Produkte“ können in dieser Tabelle abgefragt werden. Im Gegensatz zur Sub-API „Products“ kann in dieser Tabelle die zurückgegebene Produktliste nach Produktattributen gefiltert werden. Wenn Sie ein einzelnes Produkt über id abrufen oder alle Produkte auflisten möchten, sollte die Unter-API „Products“ verwendet werden.

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

JSON-Darstellung
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Felder
price

object (Price)

Produktpreis Wird nicht angezeigt, wenn die Preisinformationen des Produkts nicht verfügbar sind.

gtin[]

string

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

creationTime

string (Timestamp format)

Der Zeitpunkt in Sekunden, zu dem der Händler das Produkt erstellt hat.

expirationDate

object (Date)

Das Ablaufdatum des Produkts wird bei der Eingabe angegeben.

itemIssues[]

object (ItemIssue)

Liste der Artikelprobleme mit dem Produkt.

Dieses Feld kann nicht zum Sortieren der Ergebnisse verwendet werden.

Nur ausgewählte Attribute dieses Felds, z. B. itemIssues.severity.aggregated_severity, können zum Filtern der Ergebnisse verwendet werden.

clickPotential

enum (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. Für die Händler-API-Methoden für Produkte wird dies als name-Parameter verwendet.

In der SELECT-Klausel erforderlich.

channel

enum (ChannelEnum)

Kanal des Produkts. Kann ONLINE oder LOCAL sein.

languageCode

string

Sprachcode des Produkts im BCP-47-Format.

feedLabel

string

Feedlabel des Produkts.

offerId

string

Vom Händler bereitgestellte ID des Produkts.

title

string

Titel des Produkts.

brand

string

Marke des Produkts.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Produkttyp (1. Ebene) in der händlereigenen Produkt-Taxonomie.

productTypeL2

string

Produkttyp (2. Ebene) in der händlereigenen Produkt-Taxonomie.

productTypeL3

string

Produkttyp (3. Ebene) in der Händler-Produkttaxonomie.

productTypeL4

string

Produkttyp (4. Ebene) in der Händlertaxonomie.

productTypeL5

string

Produkttyp (5. Ebene) in der Händlertaxonomie.

condition

string

Zustand des Produkts.

availability

string

Verfügbarkeit des Produkts.

shippingLabel

string

Normalisiertes Versandlabel, das in der Datenquelle angegeben ist.

itemGroupId

string

Die Artikelgruppen-ID, die vom Händler angegeben wurde, um Varianten zu gruppieren.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Zusammengefasster Status.

clickPotentialRank

string (int64 format)

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

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 ist für einige (aber nicht alle) Berichtskontexte geeignet.
ELIGIBLE Das Produkt kann in allen Berichtskontexten verwendet werden.

ItemIssue

Mit dem Produkt verbundenes Problem mit dem Artikel.

JSON-Darstellung
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Felder
type

object (ItemIssueType)

Art des Artikelproblems.

severity

object (ItemIssueSeverity)

Schweregrad des Artikelproblems.

resolution

enum (ItemIssueResolution)

Lösung des Artikelproblems.

ItemIssueType

Art des Problems.

JSON-Darstellung
{
  "code": string,
  "canonicalAttribute": string
}
Felder
code

string

Fehlercode des Problems, entspricht code unter Produktprobleme.

canonicalAttribute

string

Kanonischer Attributname für attributspezifische Probleme.

ItemIssueSeverity

Wie sich das Problem auf die Bereitstellung des Produkts auswirkt.

JSON-Darstellung
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Felder
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Schweregrad des Problems nach Berichtskontext.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Zusammengefasster Schweregrad des Problems für alle betroffenen Berichtskontexte.

Dieses Feld kann zum Filtern der Ergebnisse verwendet werden.

IssueSeverityPerReportingContext

Schweregrad des Problems nach Berichtskontext.

JSON-Darstellung
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Felder
disapprovedCountries[]

string

Liste der abgelehnten Länder im Berichtskontext, dargestellt im ISO 3166-Format.

demotedCountries[]

string

Liste der abgewerteten Länder im Berichtskontext, dargestellt im Format ISO 3166.

reportingContext

enum (ReportingContextEnum)

Berichtskontext, auf den sich das Problem bezieht.

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 Bei diesem Problem wird das Produkt in allen betroffenen Berichtskontexten herabgestuft.
PENDING Das Problem wurde am PENDING_PROCESSING behoben.

ItemIssueResolution

So beheben Sie das Problem:

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 Crawling von Bildern) oder durch eine Überprüfung durch Google. Sie müssen nichts weiter tun. Die Lösung kann zu einem anderen Problem führen, z. B. wenn das Crawling fehlschlägt.

ClickPotential

Anhand des Klickpotenzials eines Produkts wird das Leistungspotenzial im Vergleich zu den leistungsstärksten Produkten des Händlers geschätzt. Das Klickpotenzial eines Produkts hilft Händlern, die zu korrigierenden Produkte zu priorisieren und zu verstehen, wie die Produkte im Hinblick auf ihr Potenzial abschneiden.

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

PriceCompetitivenessProductView

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

Bericht zur Wettbewerbsfähigkeit von Preisen

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

JSON-Darstellung
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Felder
price

object (Price)

Aktueller Preis des Produkts.

benchmarkPrice

object (Price)

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

reportCountryCode

string

Land der Preisvergleiche. Wird im ISO 3166-Format dargestellt.

In der SELECT-Klausel erforderlich.

id

string

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

In der SELECT-Klausel erforderlich.

offerId

string

Vom Händler bereitgestellte ID des Produkts.

title

string

Titel des Produkts.

brand

string

Marke des Produkts.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Produkttyp (1. Ebene) in der händlereigenen Produkt-Taxonomie.

productTypeL2

string

Produkttyp (2. Ebene) in der händlereigenen Produkt-Taxonomie.

productTypeL3

string

Produkttyp (3. Ebene) in der Händler-Produkttaxonomie.

productTypeL4

string

Produkttyp (4. Ebene) in der Händlertaxonomie.

productTypeL5

string

Produkttyp (5. Ebene) in der Händlertaxonomie.

PriceInsightsProductView

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

Bericht zu Preisstatistiken

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

JSON-Darstellung
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Felder
price

object (Price)

Aktueller Preis des Produkts.

suggestedPrice

object (Price)

Neueste Preisvorstellung für das Produkt.

effectiveness

enum (Effectiveness)

Die prognostizierte Effektivität der Anwendung des Preisvorschlags, gruppiert.

id

string

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

In der SELECT-Klausel erforderlich.

offerId

string

Vom Händler bereitgestellte ID des Produkts.

title

string

Titel des Produkts.

brand

string

Marke des Produkts.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Produkttyp (1. Ebene) in der händlereigenen Produkt-Taxonomie.

productTypeL2

string

Produkttyp (2. Ebene) in der händlereigenen Produkt-Taxonomie.

productTypeL3

string

Produkttyp (3. Ebene) in der Händler-Produkttaxonomie.

productTypeL4

string

Produkttyp (4. Ebene) in der Händlertaxonomie.

productTypeL5

string

Produkttyp (5. Ebene) in der Händlertaxonomie.

predictedImpressionsChangeFraction

number

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

predictedClicksChangeFraction

number

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

predictedConversionsChangeFraction

number

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

Wirksamkeit

Bucket für prognostizierte Effektivität.

Die Effektivität gibt an, welche Produkte am meisten von Preisänderungen profitieren würden. Bei dieser Bewertung wird die prognostizierte Leistungssteigerung berücksichtigt, indem der Sonderangebotspreis und die Differenz zwischen dem aktuellen und dem vorgeschlagenen Preis angepasst werden. Preisvorschläge mit einer Effektivität von HIGH werden voraussichtlich die größte Leistungssteigerung erzielen.

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

BestSellersProductClusterView

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

Der Bestsellerbericht mit den Top-Produktclustern Ein Produktcluster ist eine Gruppierung für verschiedene Angebote und Varianten desselben Produkts, z. B. Google Pixel 7.

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

JSON-Darstellung
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Felder
reportDate

object (Date)

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

  • Der erste Tag der Woche (Montag) für wöchentliche Berichte,
  • Der erste Tag des Monats bei monatlichen Berichten.

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

variantGtins[]

string

GTINs von Beispielvarianten des Produktclusters.

reportGranularity

enum (ReportGranularityEnum)

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

In der SELECT-Klausel erforderlich. Eine Bedingung für reportGranularity ist in der WHERE-Klausel erforderlich.

reportCountryCode

string

Land, in dem der Anzeigenrang berechnet wird. Wird im ISO 3166-Format dargestellt.

In der SELECT-Klausel erforderlich. Eine Bedingung für reportCountryCode ist in der WHERE-Klausel erforderlich.

reportCategoryId

string (int64 format)

ID der Google-Produktkategorie, für die der Anzeigenrang berechnet wird, angegeben in der Produkt-Taxonomie von Google.

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

title

string

Titel des Produktclusters.

brand

string

Marke des Produktclusters.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

inventoryStatus

enum (InventoryStatus)

Ob der Produktcluster IN_STOCK in Ihrer Produktdatenquelle in mindestens einem der Länder, OUT_OF_STOCK in Ihrer Produktdatenquelle in allen Ländern oder NOT_IN_INVENTORY ist.

Der Länderfilter im Bestsellerbericht wird im Feld nicht berücksichtigt.

brandInventoryStatus

enum (InventoryStatus)

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

Der Länderfilter im Bestsellerbericht wird im Feld nicht berücksichtigt.

rank

string (int64 format)

Beliebtheit des Produktclusters in Google Ads und organischen Plattformen in der ausgewählten Kategorie und im ausgewählten Land. Sie beruht auf der geschätzten Anzahl verkaufter Einheiten.

previousRank

string (int64 format)

Beliebtheitsrang in der vorherigen Woche oder im vorherigen Monat.

relativeDemand

enum (RelativeDemandEnum)

Die geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.

previousRelativeDemand

enum (RelativeDemandEnum)

Die geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der vorherigen Woche oder im gleichen Monat.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Änderung der geschätzten Nachfrage. Ob er angestiegen, gesunken oder flach geblieben ist.

ReportGranularityEnum

Detaillierungsgrad von Berichten

Enums
REPORT_GRANULARITY_ENUM_UNSPECIFIED Nicht angegeben.
WEEKLY Der Bericht wird über einen Zeitraum von einer Woche berechnet.
MONTHLY Der Bericht wird über einen Zeitraum von einem Monat berechnet.

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, es ist aber derzeit nicht auf Lager.
NOT_IN_INVENTORY Sie haben kein Produkt für diesen Produktcluster oder diese Marke im Inventar.

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 des Produktclusters oder der Marke mit dem höchsten Rang.

RelativeDemandChangeTypeEnum

Relative Werte des Nachfrageänderungstyps.

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

BestSellersBrandView

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

Der Bestsellerbericht enthält Top-Marken.

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

JSON-Darstellung
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Felder
reportDate

object (Date)

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

  • Der erste Tag der Woche (Montag) für wöchentliche Berichte,
  • Der erste Tag des Monats bei monatlichen Berichten.

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

reportGranularity

enum (ReportGranularityEnum)

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

In der SELECT-Klausel erforderlich. Eine Bedingung für reportGranularity ist in der WHERE-Klausel erforderlich.

reportCountryCode

string

Land, in dem der Anzeigenrang berechnet wird. Wird im ISO 3166-Format dargestellt.

In der SELECT-Klausel erforderlich. Eine Bedingung für reportCountryCode ist in der WHERE-Klausel erforderlich.

reportCategoryId

string (int64 format)

ID der Google-Produktkategorie, für die der Anzeigenrang berechnet wird, angegeben in der Produkt-Taxonomie von Google.

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

brand

string

Name der Marke.

rank

string (int64 format)

Beliebtheit der Marke in Google Ads und organischen Plattformen in der ausgewählten Kategorie und im ausgewählten Land. Sie beruht auf der geschätzten Anzahl verkaufter Einheiten.

previousRank

string (int64 format)

Beliebtheitsrang in der vorherigen Woche oder im vorherigen Monat.

relativeDemand

enum (RelativeDemandEnum)

Die geschätzte Nachfrage im Verhältnis zur Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.

previousRelativeDemand

enum (RelativeDemandEnum)

Die geschätzte Nachfrage im Verhältnis zur Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der vorherigen Woche oder im gleichen Monat.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Änderung der geschätzten Nachfrage. Ob er angestiegen, gesunken oder flach geblieben ist.

CompetitiveVisibilityCompetitorView

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

Bericht „Mitbewerber im Blick“ mit Unternehmen mit ähnlicher Sichtbarkeit.

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

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Felder
date

object (Date)

Das Datum dieser Zeile.

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

domain

string

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

In der SELECT-Klausel erforderlich. Kann nicht in der WHERE-Klausel gefiltert werden.

isYourDomain

boolean

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

Kann nicht in der WHERE-Klausel gefiltert werden.

reportCountryCode

string

Land, in dem Impressionen aufgetreten sind.

In der SELECT-Klausel erforderlich. In der WHERE-Klausel ist eine Bedingung für reportCountryCode erforderlich.

reportCategoryId

string (int64 format)

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

In der SELECT-Klausel erforderlich. In der WHERE-Klausel ist eine Bedingung für reportCategoryId erforderlich.

trafficSource

enum (TrafficSourceEnum)

Zugriffsquelle von Impressionen.

In der SELECT-Klausel erforderlich.

rank

string (int64 format)

Position der Domain in dem Ranking ähnlicher Unternehmen für die ausgewählten Schlüssel (date, reportCategoryId, reportCountryCode, trafficSource) basierend auf den Impressionen. 1 ist der höchste Wert.

Kann nicht in der WHERE-Klausel gefiltert werden.

adsOrganicRatio

number

Das Verhältnis von 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.

Kann nicht in der WHERE-Klausel gefiltert werden.

pageOverlapRate

number

Die Überschneidungsrate der Seiten gibt an, wie oft die Angebote von Mitbewerbern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kann nicht in der WHERE-Klausel gefiltert werden.

higherPositionRate

number

Höhere Positionsrate gibt an, wie oft das Angebot eines Mitbewerbers an einer höheren Position auf der Seite platziert wurde als Ihr Angebot.

Kann nicht in der WHERE-Klausel gefiltert werden.

relativeVisibility

number

Die Relative Sichtbarkeit gibt an, wie oft die Angebote Ihrer Mitbewerber im Vergleich zu Ihren Angeboten präsentiert werden. Anders ausgedrückt: Die Anzahl der angezeigten Impressionen eines Mitbewerbers geteilt durch die Anzahl der angezeigten Impressionen in einem bestimmten Zeitraum für eine ausgewählte Produktkategorie und ein ausgewähltes Land.

Kann nicht in der WHERE-Klausel gefiltert werden.

TrafficSourceEnum

Werte für Besucherquellen

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

CompetitiveVisibilityTopMerchantView

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

Der Bericht Wettbewerbsposition mit dem Unternehmen mit der höchsten Sichtbarkeit.

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

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Felder
date

object (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

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

In der SELECT-Klausel erforderlich. Kann nicht in der WHERE-Klausel gefiltert werden.

isYourDomain

boolean

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

Kann nicht in der WHERE-Klausel gefiltert werden.

reportCountryCode

string

Land, in dem Impressionen aufgetreten sind.

In der SELECT-Klausel erforderlich. In der WHERE-Klausel ist eine Bedingung für reportCountryCode erforderlich.

reportCategoryId

string (int64 format)

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

In der SELECT-Klausel erforderlich. In der WHERE-Klausel ist eine Bedingung für reportCategoryId erforderlich.

trafficSource

enum (TrafficSourceEnum)

Zugriffsquelle von Impressionen.

In der SELECT-Klausel erforderlich.

rank

string (int64 format)

Position der Domain im Top-Händler-Ranking für die ausgewählten Schlüssel (date, reportCategoryId, reportCountryCode, trafficSource) basierend auf den Impressionen. 1 ist der höchste Wert.

Kann nicht in der WHERE-Klausel gefiltert werden.

adsOrganicRatio

number

Das Verhältnis von 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.

Kann nicht in der WHERE-Klausel gefiltert werden.

pageOverlapRate

number

Die Überschneidungsrate der Seiten gibt an, wie oft die Angebote von Mitbewerbern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kann nicht in der WHERE-Klausel gefiltert werden.

higherPositionRate

number

Höhere Positionsrate gibt an, wie oft das Angebot eines Mitbewerbers an einer höheren Position auf der Seite platziert wurde als Ihr Angebot.

Kann nicht in der WHERE-Klausel gefiltert werden.

CompetitiveVisibilityBenchmarkView

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

Bericht Wettbewerbsposition mit der Kategorie-Benchmark.

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

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Felder
date

object (Date)

Das Datum dieser Zeile.

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

reportCountryCode

string

Land, in dem Impressionen aufgetreten sind.

In der SELECT-Klausel erforderlich. In der WHERE-Klausel ist eine Bedingung für reportCountryCode erforderlich.

reportCategoryId

string (int64 format)

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

In der SELECT-Klausel erforderlich. In der WHERE-Klausel ist eine Bedingung für reportCategoryId erforderlich.

trafficSource

enum (TrafficSourceEnum)

Zugriffsquelle von Impressionen.

In der SELECT-Klausel erforderlich.

yourDomainVisibilityTrend

number

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

Kann nicht in der WHERE-Klausel gefiltert werden.

categoryBenchmarkVisibilityTrend

number

Ä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 annähernd höchsten Sichtbarkeit.

Kann nicht in der WHERE-Klausel gefiltert werden.