REST Resource: accounts.reports

Ressource: ReportRow

Ergebniszeile, die von der Suchabfrage zurückgegeben wurde.

In der Antwort wird nur die Nachricht eingefügt, die der abgefragten Tabelle entspricht. In der ausgefüllten Nachricht werden nur die Felder ausgefüllt, die in der Abfrage explizit 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)

Felder, die in der Tabelle productPerformanceView für Abfragen verfügbar sind.

nonProductPerformanceView

object (NonProductPerformanceView)

Felder, die in der Tabelle nonProductPerformanceView für Abfragen verfügbar sind.

productView

object (ProductView)

Felder, die in der Tabelle productView für Abfragen verfügbar sind.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Felder, die in der Tabelle priceCompetitivenessProductView für Abfragen verfügbar sind.

priceInsightsProductView

object (PriceInsightsProductView)

Felder, die in der Tabelle priceInsightsProductView für Abfragen verfügbar sind.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Felder, die in der Tabelle bestSellersProductClusterView für Abfragen verfügbar sind.

bestSellersBrandView

object (BestSellersBrandView)

Felder, die in der Tabelle bestSellersBrandView für Abfragen verfügbar sind.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Felder, die in der Tabelle competitiveVisibilityCompetitorView für Abfragen verfügbar sind.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Felder, die in der Tabelle competitiveVisibilityTopMerchantView für Abfragen verfügbar sind.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Felder, die in der Tabelle competitiveVisibilityBenchmarkView für Abfragen verfügbar sind.

ProductPerformanceView

Felder, die in der Tabelle productPerformanceView für Abfragen verfügbar sind.

Produktleistungsdaten für Ihr Konto, einschließlich Leistungsmesswerte (z. B. clicks) und Dimensionen, nach denen Leistungsmesswerte segmentiert werden (z. B. offerId). Die Werte von Produktdimensionen wie offerId spiegeln den Zustand eines Produkts zum Zeitpunkt der Impression wider.

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

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

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 Zeitzone des Händlers, für den die Messwerte gelten. Segment.

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

week

object (Date)

Der erste Tag der Woche (Montag) des Messdatums in der Zeitzone des Händlers. Segment.

conversionValue

object (Price)

Der Wert der Conversions, die dem Produkt zugeordnet wurden und am Conversion-Datum erfasst wurden. Messwert

Nur für die Zugriffsquelle FREE verfügbar.

marketingMethod

enum (MarketingMethodEnum)

Marketingmethode, auf die sich die Messwerte beziehen. Segment.

customerCountryCode

string

Der Code des Landes, in dem sich der Kunde zum Zeitpunkt des Ereignisses befindet. Muss im ISO 3166-Format angegeben werden. Segment.

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

offerId

string

Vom Händler angegebene 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 Produkttaxonomie des Händlers. Segment.

productTypeL2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers. Segment.

productTypeL3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers. Segment.

productTypeL4

string

Produkttyp (4. Ebene) in der Produkttaxonomie des Händlers. Segment.

productTypeL5

string

Produkttyp (5. Ebene) in der Produkttaxonomie 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 eines Händlers angezeigt wurden. Messwert

clickThroughRate

number

Klickrate: Die Anzahl der Klicks auf die Produkte eines Händlers (Klicks) geteilt durch die Anzahl der Impressionen (Impressionen). Messwert

conversions

number

Anzahl der Conversions, die dem Produkt zugeordnet wurden und am Conversion-Datum erfasst wurden. Je nach Attributionsmodell kann eine Conversion auf mehrere Klicks verteilt werden, wobei jedem Klick ein eigener Wert zugeordnet wird. Dieser Messwert ist die Summe aller Gutschriften. Messwert

Nur für die Zugriffsquelle FREE verfügbar.

conversionRate

number

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

Nur für die Zugriffsquelle FREE verfügbar.

MarketingMethodEnum

Werte für Marketingmethoden

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED Nicht angegeben.
ORGANIC Organisches Marketing
ADS Anzeigenbasiertes Marketing

NonProductPerformanceView

Felder, die in der Tabelle nonProductPerformanceView für Abfragen verfügbar sind.

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

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

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

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

object (Date)

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

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

week

object (Date)

Der erste Tag der Woche (Montag) des Messdatums in der Zeitzone des Händlers. Segment.

clicks

string (int64 format)

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

impressions

string (int64 format)

Anzahl der Aufrufe von Bildern und Links zu Ihrem Onlineshop, die zu nicht produktbezogenen Seiten führen. 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

Felder, die in der Tabelle productView für Abfragen verfügbar sind.

Produkte im aktuellen Inventar. Die Produkte in dieser Tabelle sind mit denen in der Products-Unter-API identisch. Nicht alle Produktattribute aus der Products-Unter-API können in dieser Tabelle abgefragt werden. Im Gegensatz zur Produkte-Unter-API können Sie in dieser Tabelle die zurückgegebene Liste der Produkte nach Produktattributen filtern. Wenn Sie ein einzelnes Produkt anhand von id abrufen oder alle Produkte auflisten möchten, sollten Sie die Produkte-Unter-API verwenden.

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

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 Fehlt, wenn keine Informationen zum Preis des Produkts verfügbar sind.

gtin[]

string

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

creationTime

string (Timestamp format)

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

expirationDate

object (Date)

Ablaufdatum des Produkts, das bei der Aufnahme angegeben wurde.

itemIssues[]

object (ItemIssue)

Liste der Artikelprobleme für das 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. Merchant API-Methoden, die auf Produkte angewendet werden, verwenden diesen als name-Parameter.

Erforderlich in der SELECT-Klausel.

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 angegebene ID des Produkts.

title

string

Titel des Produkts.

brand

string

Marke des Produkts.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Produkttyp (1. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL4

string

Produkttyp (4. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL5

string

Produkttyp (5. Ebene) in der eigenen Produkttaxonomie des Händlers.

condition

string

Zustand des Produkts.

availability

string

Verfügbarkeit des Produkts.

shippingLabel

string

Normalisiertes Versandlabel, das in der Datenquelle angegeben ist.

itemGroupId

string

Die vom Händler angegebene Artikelgruppen-ID, um Varianten zu gruppieren.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Aggregierter Status.

clickPotentialRank

string (int64 format)

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

AggregatedReportingContextStatus

Der 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 für alle Berichtskontexte nicht zulässig oder wurde 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

Artikelproblem im Zusammenhang mit dem Produkt.

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)

Problem mit Artikel behoben

ItemIssueType

Art des Problems.

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

string

Fehlercode des Problems, entspricht der code von Produktproblemen.

canonicalAttribute

string

Kanonischer Attributname für attributspezifische Probleme.

ItemIssueSeverity

Wie sich das Problem auf die Auslieferung des Produkts auswirkt.

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

object (IssueSeverityPerReportingContext)

Schweregrad des Problems pro Berichtskontext.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Die zusammengefasste Schwere des Problems für alle betroffenen Berichtskontexte.

Mit diesem Feld können Sie die Ergebnisse filtern.

IssueSeverityPerReportingContext

Schweregrad des Problems pro 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 herabgestuften Länder im Berichtskontext, dargestellt im ISO 3166-Format.

reportingContext

enum (ReportingContextEnum)

Berichtskontext, auf den sich das Problem bezieht.

AggregatedIssueSeverity

Schweregrad des Problems, zusammengefasst für alle Berichtskontexte.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Nicht angegeben.
DISAPPROVED Das Problem führt dazu, dass das Produkt in mindestens einem Meldekontext abgelehnt wird.
DEMOTED Das Problem wirkt sich auf alle Berichtskontexte aus, in denen es auftritt.
PENDING Die Problemlösung lautet PENDING_PROCESSING.

ItemIssueResolution

Problemlösung

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 Bild-Crawling) oder durch eine Google-Überprüfung. Es sind derzeit keine Maßnahmen des Händlers erforderlich. 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. So sehen Sie, bei welchen Produkten Handlungsbedarf besteht und wie sie hinsichtlich ihres Potenzials abschneiden.

Enums
CLICK_POTENTIAL_UNSPECIFIED Unbekannte Auswirkungen auf die geschätzten 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 eine moderate Anzahl von Klicks im Vergleich zu den leistungsstärksten Produkten des Händlers erhalten.
HIGH Sie könnten eine ähnliche Anzahl von Klicks wie die leistungsstärksten Produkte des Händlers erhalten.

PriceCompetitivenessProductView

Felder, die in der Tabelle priceCompetitivenessProductView für Abfragen verfügbar sind.

Bericht zur Wettbewerbsfähigkeit von Preisen

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

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)

Der aktuelle Preis des Produkts.

benchmarkPrice

object (Price)

Der aktuellste verfügbare Preis-Benchmark für den Katalog des Produkts im Benchmark-Land.

reportCountryCode

string

Land des Preisvergleichs. Muss im ISO 3166-Format angegeben werden.

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 productView zusammenzuführen.

Erforderlich in der SELECT-Klausel.

offerId

string

Vom Händler angegebene ID des Produkts.

title

string

Titel des Produkts.

brand

string

Marke des Produkts.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Produkttyp (1. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL4

string

Produkttyp (4. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL5

string

Produkttyp (5. Ebene) in der eigenen Produkttaxonomie des Händlers.

PriceInsightsProductView

Felder, die in der Tabelle priceInsightsProductView für Abfragen verfügbar sind.

Bericht zu Preisstatistiken

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

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)

Der aktuelle Preis des Produkts.

suggestedPrice

object (Price)

Der aktuelle vorgeschlagene Preis für das Produkt.

effectiveness

enum (Effectiveness)

Die geschätzte Effektivität der Anwendung des Preisvorschlags, gegliedert.

id

string

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

Erforderlich in der SELECT-Klausel.

offerId

string

Vom Händler angegebene ID des Produkts.

title

string

Titel des Produkts.

brand

string

Marke des Produkts.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Produkttyp (1. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL4

string

Produkttyp (4. Ebene) in der eigenen Produkttaxonomie des Händlers.

productTypeL5

string

Produkttyp (5. Ebene) in der eigenen Produkttaxonomie des Händlers.

predictedImpressionsChangeFraction

number

Geschätzte Änderung der Impressionen als Bruchteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuell aktiven Preis. 0, 05 entspricht beispielsweise einer prognostizierten Steigerung der Impressionen um 5 %.

predictedClicksChangeFraction

number

Geschätzte Änderung der Klicks als Bruchteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuellen aktiven Preis. 0, 05 entspricht beispielsweise einer geschätzten Steigerung der Klicks um 5 %.

predictedConversionsChangeFraction

number

Geschätzte Änderung der Conversions als Bruchteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuell aktiven Preis. 0, 05 entspricht beispielsweise einer geschätzten 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 erfolgt die Ermittlung der prognostizierten Leistungssteigerung durch Anpassung des Sonderangebotspreises mithilfe der Differenz zwischen aktuellem und vorgeschlagenem Preis. Bei Preisvorschlägen mit HIGH wird voraussichtlich die größte Leistungssteigerung erzielt.

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

BestSellersProductClusterView

Felder, die in der Tabelle bestSellersProductClusterView für Abfragen verfügbar sind.

Bestsellerbericht mit den Top-Produktclustern Ein Produktcluster ist eine Gruppierung verschiedener Angebote und Varianten, die dasselbe Produkt repräsentieren, z. B. Google Pixel 7.

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

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. Der Wert dieses Felds kann nur einer der folgenden sein:

  • Der erste Tag der Woche (Montag) für Wochenberichte,
  • Der erste Tag des Monats für monatliche Berichte.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für reportDate angegeben ist, wird der jeweils aktuelle Wochen- oder Monatsbericht 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.

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

reportCountryCode

string

Land, in dem das Ranking berechnet wird. Muss im ISO 3166-Format angegeben werden.

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

reportCategoryId

string (int64 format)

Die Google-Produktkategorie-ID, für die das Ranking berechnet werden soll, in der Google-Produkt-Taxonomie.

Erforderlich in der SELECT-Klausel. 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 Google-Produkt-Taxonomie.

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

inventoryStatus

enum (InventoryStatus)

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

Bei diesem Feld wird der Länderfilter des Bestsellerberichts nicht berücksichtigt.

brandInventoryStatus

enum (InventoryStatus)

Gibt an, ob mindestens ein Produkt der Marke derzeit IN_STOCK in Ihrer Produktdatenquelle in mindestens einem der Länder ist, alle Produkte in Ihrer Produktdatenquelle in allen Ländern OUT_OF_STOCK sind oder NOT_IN_INVENTORY.

Bei diesem Feld wird der Länderfilter des Bestsellerberichts nicht berücksichtigt.

rank

string (int64 format)

Beliebtheit des Produktclusters in Anzeigen und organischen Oberflächen 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 Vorwoche oder im Vormonat.

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

Geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der Vorwoche oder im Vormonat.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Änderung der geschätzten Nachfrage. Ob der Wert gestiegen, gesunken oder unverändert geblieben ist.

ReportGranularityEnum

Werte für die Berichtsgranularität

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

RelativeDemandEnum

Werte für die relative Nachfrage.

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.

RelativeDemandChangeTypeEnum

Werte für den Typ „Relative Änderung der Nachfrage“

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

BestSellersBrandView

Felder, die in der Tabelle bestSellersBrandView für Abfragen verfügbar sind.

Bestsellerbericht mit den Top-Marken

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

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. Der Wert dieses Felds kann nur einer der folgenden sein:

  • Der erste Tag der Woche (Montag) für Wochenberichte,
  • Der erste Tag des Monats für monatliche Berichte.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für reportDate angegeben ist, wird der jeweils aktuelle Wochen- oder Monatsbericht zurückgegeben.

reportGranularity

enum (ReportGranularityEnum)

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

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

reportCountryCode

string

Land, in dem das Ranking berechnet wird. Muss im ISO 3166-Format angegeben werden.

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

reportCategoryId

string (int64 format)

Die Google-Produktkategorie-ID, für die das Ranking berechnet werden soll, in der Google-Produkt-Taxonomie.

Erforderlich in der SELECT-Klausel. 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 Anzeigen und organischen Oberflächen 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 Vorwoche oder im Vormonat.

relativeDemand

enum (RelativeDemandEnum)

Geschätzte Nachfrage in Bezug auf die Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.

previousRelativeDemand

enum (RelativeDemandEnum)

Geschätzte Nachfrage in Bezug auf die Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der Vorwoche oder im Vormonat.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Änderung der geschätzten Nachfrage. Ob der Wert gestiegen, gesunken oder unverändert geblieben ist.

CompetitiveVisibilityCompetitorView

Felder, die in der Tabelle competitiveVisibilityCompetitorView für Abfragen verfügbar sind.

Bericht zur Wettbewerbsposition mit Unternehmen mit ähnlicher Sichtbarkeit

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

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

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

Erforderlich in der SELECT-Klausel. Kann nicht in der WHERE-Klausel gefiltert werden.

isYourDomain

boolean

„Wahr“, wenn diese Zeile Daten für Ihre Domain enthält.

Kann nicht in der WHERE-Klausel gefiltert werden.

reportCountryCode

string

Land, in dem Impressionen erzielt wurden.

Erforderlich in der SELECT-Klausel. 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, in der Google-Produkt-Taxonomie.

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

trafficSource

enum (TrafficSourceEnum)

Zugriffsquelle der Impressionen.

Erforderlich in der SELECT-Klausel.

rank

string (int64 format)

Die Position der Domain im Ranking der ähnlichen 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

Der Wert Verhältnis „Anzeigen / Organisch“ gibt an, wie oft die Domain über Shopping-Anzeigen im Vergleich zu über organische Zugriffe aufgerufen wurde. Die Zahl wird gerundet und in Kategorien unterteilt.

Kann nicht in der WHERE-Klausel gefiltert werden.

pageOverlapRate

number

Die Häufigkeit der Platzierung auf gleicher Seite gibt an, wie oft die Angebote von Einzelhändlern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kann nicht in der WHERE-Klausel gefiltert werden.

higherPositionRate

number

Mit der Häufigkeit der höheren Platzierung wird angegeben, 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 angezeigt werden. Dieser Wert zeigt also die Anzahl der Impressionen eines Mitbewerbers, geteilt durch die Anzahl der angezeigten Impressionen in einem ausgewählten Zeitraum für die ausgewählte Produktkategorie und das ausgewählte 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 Anzeigentraffic

CompetitiveVisibilityTopMerchantView

Felder, die in der Tabelle competitiveVisibilityTopMerchantView für Abfragen verfügbar sind.

Bericht Mitbewerber im Blick mit dem Unternehmen mit der höchsten Sichtbarkeit

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

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 nicht in der SELECT-Klausel ausgewählt werden. In der WHERE-Klausel ist eine Bedingung für date erforderlich.

domain

string

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

Erforderlich in der SELECT-Klausel. Kann nicht in der WHERE-Klausel gefiltert werden.

isYourDomain

boolean

„Wahr“, wenn diese Zeile Daten für Ihre Domain enthält.

Kann nicht in der WHERE-Klausel gefiltert werden.

reportCountryCode

string

Land, in dem Impressionen erzielt wurden.

Erforderlich in der SELECT-Klausel. 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, in der Google-Produkt-Taxonomie.

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

trafficSource

enum (TrafficSourceEnum)

Zugriffsquelle der Impressionen.

Erforderlich in der SELECT-Klausel.

rank

string (int64 format)

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

Kann nicht in der WHERE-Klausel gefiltert werden.

adsOrganicRatio

number

Der Wert Verhältnis „Anzeigen / Organisch“ gibt an, wie oft die Domain über Shopping-Anzeigen im Vergleich zu über organische Zugriffe aufgerufen wurde. Die Zahl wird gerundet und in Kategorien unterteilt.

Kann nicht in der WHERE-Klausel gefiltert werden.

pageOverlapRate

number

Die Häufigkeit der Platzierung auf gleicher Seite gibt an, wie oft die Angebote von Einzelhändlern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kann nicht in der WHERE-Klausel gefiltert werden.

higherPositionRate

number

Mit der Häufigkeit der höheren Platzierung wird angegeben, 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

Felder, die in der Tabelle competitiveVisibilityBenchmarkView für Abfragen verfügbar sind.

Bericht Mitbewerber im Blick mit der Benchmark der Kategorie

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

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

object (Date)

Das Datum dieser Zeile.

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

reportCountryCode

string

Land, in dem Impressionen erzielt wurden.

Erforderlich in der SELECT-Klausel. 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, in der Google-Produkt-Taxonomie.

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

trafficSource

enum (TrafficSourceEnum)

Zugriffsquelle der Impressionen.

Erforderlich in der SELECT-Klausel.

yourDomainVisibilityTrend

number

Änderung der Sichtbarkeit basierend auf Impressionen für Ihre Domain im Vergleich zum Beginn des ausgewählten Zeitraums (oder zum ersten Tag mit nicht nullwertigen Impressionen).

Kann nicht in der WHERE-Klausel gefiltert werden.

categoryBenchmarkVisibilityTrend

number

Änderung der Sichtbarkeit basierend auf Impressionen im Vergleich zum Beginn des ausgewählten Zeitraums (oder zum ersten Tag mit nicht null Impressionen) für eine Kombination von Händlern mit der höchsten Sichtbarkeit, die dem Markt entspricht.

Kann nicht in der WHERE-Klausel gefiltert werden.

Methoden

Ruft einen Bericht ab, der durch eine Suchanfrage definiert ist.