- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ReportRow
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ProductPerformanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- MarketingMethodEnum
- NonProductPerformanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ProductView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- AggregatedReportingContextStatus
- ItemIssue
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ItemIssueType
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ItemIssueSeverity
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- IssueSeverityPerReportingContext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- AggregatedIssueSeverity
- ItemIssueResolution
- ClickPotential
- PriceCompetitivenessProductView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- PriceInsightsProductView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Effektivität
- BestSellersProductClusterView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ReportGranularityEnum
- InventoryStatus
- RelativeDemandEnum
- RelativeDemandChangeTypeEnum
- BestSellersBrandView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CompetitiveVisibilityCompetitorView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TrafficSourceEnum
- CompetitiveVisibilityTopMerchantView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CompetitiveVisibilityBenchmarkView
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Testen!
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 |
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 |
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 |
Optional. Anzahl der |
pageToken |
Optional. Token der abzurufenden Seite. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben. Um die nächste Seite mit Ergebnissen anzufordern, sollte der Wert verwendet werden, der in der vorherigen Antwort von |
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 ( |
Felder | |
---|---|
results[] |
Zeilen, die mit der Suchanfrage übereinstimmen. |
nextPageToken |
Token, das als |
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 ( |
Felder | |
---|---|
productPerformanceView |
Für die Abfrage in Tabelle „ |
nonProductPerformanceView |
Für die Abfrage in Tabelle „ |
productView |
Für die Abfrage in Tabelle „ |
priceCompetitivenessProductView |
Für die Abfrage in Tabelle „ |
priceInsightsProductView |
Für die Abfrage in Tabelle „ |
bestSellersProductClusterView |
Für die Abfrage in Tabelle „ |
bestSellersBrandView |
Für die Abfrage in Tabelle „ |
competitiveVisibilityCompetitorView |
Für die Abfrage in Tabelle „ |
competitiveVisibilityTopMerchantView |
Für die Abfrage in Tabelle „ |
competitiveVisibilityBenchmarkView |
Für die Abfrage in Tabelle „ |
ProductPerformanceView
Für die Abfrage in Tabelle „productPerformanceView
“ verfügbare Felder.
Produktleistungsdaten für Ihr Konto, einschließlich Leistungsmesswerten (z. B. clicks
) und Dimensionen, anhand derer Leistungsmesswerte segmentiert sind (z. B. offerId
). Werte von Produktdimensionen wie z. B. offerId
spiegeln den Zustand 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 ( |
Felder | |
---|---|
date |
Datum in der Händlerzeitzone, für die Messwerte gelten. Segment. Eine Bedingung für |
week |
Erster Wochentag (Montag) des Messwertdatums in der Händlerzeitzone. Segment. |
conversionValue |
Wert der dem Produkt zugeordneten Conversions, erfasst am Conversion-Datum. Messwert. Nur für die Besucherquelle „ |
marketingMethod |
Marketingmethode, für die die Messwerte gelten. Segment. |
customerCountryCode |
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 spezielles „ZZ“ angezeigt. -Code zurückgegeben. |
offerId |
Vom Händler bereitgestellte ID des Produkts. Segment. |
title |
Titel des Produkts. Segment. |
brand |
Marke des Produkts. Segment. |
categoryL1 |
Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google. Segment. |
categoryL2 |
Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google. Segment. |
categoryL3 |
Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google. Segment. |
categoryL4 |
Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google. Segment. |
categoryL5 |
Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google. Segment. |
productTypeL1 |
Produkttyp (1. Ebene) in der Produkt-Taxonomie des Händlers. Segment. |
productTypeL2 |
Produkttyp (2. Ebene) in der Produkt-Taxonomie des Händlers. Segment. |
productTypeL3 |
Produkttyp (3. Ebene) in der Produkt-Taxonomie des Händlers. Segment. |
productTypeL4 |
Produkttyp (4. Ebene) in der Produkt-Taxonomie des Händlers. Segment. |
productTypeL5 |
Produkttyp (5. Ebene) in der Produkt-Taxonomie des Händlers. Segment. |
customLabel0 |
Benutzerdefiniertes Label 0 für die benutzerdefinierte Gruppierung von Produkten. Segment. |
customLabel1 |
Benutzerdefiniertes Label 1 für die benutzerdefinierte Gruppierung von Produkten. Segment. |
customLabel2 |
Benutzerdefiniertes Label 2 für die benutzerdefinierte Gruppierung von Produkten. Segment. |
customLabel3 |
Benutzerdefiniertes Label 3 für die benutzerdefinierte Gruppierung von Produkten. Segment. |
customLabel4 |
Benutzerdefiniertes Label 4 für die benutzerdefinierte Gruppierung von Produkten. Segment. |
clicks |
Anzahl der Klicks Messwert. |
impressions |
Gibt an, wie oft die Produkte des Händlers angezeigt werden. Messwert. |
clickThroughRate |
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 |
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 „ |
conversionRate |
Die Anzahl der Conversions geteilt durch die Anzahl der Klicks, die am Impressionsdatum erfasst wurde. Messwert. Nur für die Besucherquelle „ |
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 ( |
Felder | |
---|---|
date |
Datum in der Händlerzeitzone, für die Messwerte gelten. Segment. Eine Bedingung für |
week |
Erster Wochentag (Montag) des Messwertdatums in der Händlerzeitzone. Segment. |
clicks |
Anzahl der Klicks auf Bilder und Links zu Onlineshops, die zu nicht produktbezogenen Seiten führen. Messwert. |
impressions |
Die Häufigkeit, mit der Bilder und Links zu Onlineshops, die zu nicht produktbezogenen Seiten führen, angezeigt wurden. Messwert. |
clickThroughRate |
Klickrate: die Anzahl der Klicks ( |
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 ( |
Felder | |
---|---|
price |
Produktpreis Wird nicht angezeigt, wenn die Preisinformationen des Produkts nicht verfügbar sind. |
gtin[] |
Liste der Global Trade Item Numbers (GTINs) des Produkts. |
creationTime |
Der Zeitpunkt in Sekunden, zu dem der Händler das Produkt erstellt hat. |
expirationDate |
Das Ablaufdatum des Produkts wird bei der Eingabe angegeben. |
itemIssues[] |
Liste der Artikelprobleme mit dem Produkt. Dieses Feld kann nicht zum Sortieren der Ergebnisse verwendet werden. Nur ausgewählte Attribute dieses Felds, z. B. |
clickPotential |
Geschätztes Leistungspotenzial im Vergleich zu den leistungsstärksten Produkten des Händlers. |
id |
REST-ID des Produkts im Format In der |
channel |
Kanal des Produkts. Kann |
languageCode |
Sprachcode des Produkts im BCP-47-Format. |
feedLabel |
Feedlabel des Produkts. |
offerId |
Vom Händler bereitgestellte ID des Produkts. |
title |
Titel des Produkts. |
brand |
Marke des Produkts. |
categoryL1 |
Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google. |
categoryL2 |
Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google. |
categoryL3 |
Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google. |
categoryL4 |
Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google. |
categoryL5 |
Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google. |
productTypeL1 |
Produkttyp (1. Ebene) in der händlereigenen Produkt-Taxonomie. |
productTypeL2 |
Produkttyp (2. Ebene) in der händlereigenen Produkt-Taxonomie. |
productTypeL3 |
Produkttyp (3. Ebene) in der Händler-Produkttaxonomie. |
productTypeL4 |
Produkttyp (4. Ebene) in der Händlertaxonomie. |
productTypeL5 |
Produkttyp (5. Ebene) in der Händlertaxonomie. |
condition |
Zustand des Produkts. |
availability |
Verfügbarkeit des Produkts. |
shippingLabel |
Normalisiertes Versandlabel, das in der Datenquelle angegeben ist. |
itemGroupId |
Die Artikelgruppen-ID, die vom Händler angegeben wurde, um Varianten zu gruppieren. |
thumbnailLink |
Link zum verarbeiteten Bild des Produkts, das auf der Google-Infrastruktur gehostet wird. |
aggregatedReportingContextStatus |
Zusammengefasster Status. |
clickPotentialRank |
Rang des Produkts auf Grundlage seines Klickpotenzials. Ein Produkt mit |
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 ( |
Felder | |
---|---|
type |
Art des Artikelproblems. |
severity |
Schweregrad des Artikelproblems. |
resolution |
Lösung des Artikelproblems. |
ItemIssueType
Art des Problems.
JSON-Darstellung |
---|
{ "code": string, "canonicalAttribute": string } |
Felder | |
---|---|
code |
Fehlercode des Problems, entspricht |
canonicalAttribute |
Kanonischer Attributname für attributspezifische Probleme. |
ItemIssueSeverity
Wie sich das Problem auf die Bereitstellung des Produkts auswirkt.
JSON-Darstellung |
---|
{ "severityPerReportingContext": [ { object ( |
Felder | |
---|---|
severityPerReportingContext[] |
Schweregrad des Problems nach Berichtskontext. |
aggregatedSeverity |
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 ( |
Felder | |
---|---|
disapprovedCountries[] |
Liste der abgelehnten Länder im Berichtskontext, dargestellt im ISO 3166-Format. |
demotedCountries[] |
Liste der abgewerteten Länder im Berichtskontext, dargestellt im Format ISO 3166. |
reportingContext |
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 ( |
Felder | |
---|---|
price |
Aktueller Preis des Produkts. |
benchmarkPrice |
Neueste verfügbare Preisvergleiche für den Katalog des Produkts im Benchmarkland. |
reportCountryCode |
Land der Preisvergleiche. Wird im ISO 3166-Format dargestellt. In der |
id |
REST-ID des Produkts im Format In der |
offerId |
Vom Händler bereitgestellte ID des Produkts. |
title |
Titel des Produkts. |
brand |
Marke des Produkts. |
categoryL1 |
Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google. |
categoryL2 |
Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google. |
categoryL3 |
Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google. |
categoryL4 |
Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google. |
categoryL5 |
Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google. |
productTypeL1 |
Produkttyp (1. Ebene) in der händlereigenen Produkt-Taxonomie. |
productTypeL2 |
Produkttyp (2. Ebene) in der händlereigenen Produkt-Taxonomie. |
productTypeL3 |
Produkttyp (3. Ebene) in der Händler-Produkttaxonomie. |
productTypeL4 |
Produkttyp (4. Ebene) in der Händlertaxonomie. |
productTypeL5 |
Produkttyp (5. Ebene) in der Händlertaxonomie. |
PriceInsightsProductView
Für die Abfrage in Tabelle „priceInsightsProductView
“ verfügbare Felder.
Werte werden nur für Felder festgelegt, die ausdrücklich in der Suchanfrage der Anfrage angefordert werden.
JSON-Darstellung |
---|
{ "price": { object ( |
Felder | |
---|---|
price |
Aktueller Preis des Produkts. |
suggestedPrice |
Neueste Preisvorstellung für das Produkt. |
effectiveness |
Die prognostizierte Effektivität der Anwendung des Preisvorschlags, gruppiert. |
id |
REST-ID des Produkts im Format In der |
offerId |
Vom Händler bereitgestellte ID des Produkts. |
title |
Titel des Produkts. |
brand |
Marke des Produkts. |
categoryL1 |
Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google. |
categoryL2 |
Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google. |
categoryL3 |
Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google. |
categoryL4 |
Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google. |
categoryL5 |
Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google. |
productTypeL1 |
Produkttyp (1. Ebene) in der händlereigenen Produkt-Taxonomie. |
productTypeL2 |
Produkttyp (2. Ebene) in der händlereigenen Produkt-Taxonomie. |
productTypeL3 |
Produkttyp (3. Ebene) in der Händler-Produkttaxonomie. |
productTypeL4 |
Produkttyp (4. Ebene) in der Händlertaxonomie. |
productTypeL5 |
Produkttyp (5. Ebene) in der Händlertaxonomie. |
predictedImpressionsChangeFraction |
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 |
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 |
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 ( |
Felder | |
---|---|
reportDate |
Datum des Berichts. Für dieses Feld ist nur einer der folgenden Werte zulässig:
In der |
variantGtins[] |
GTINs von Beispielvarianten des Produktclusters. |
reportGranularity |
Detaillierungsgrad des Berichts Das Ranking kann über einen Zeitraum von einer Woche oder einem Monat erfolgen. In der |
reportCountryCode |
Land, in dem der Anzeigenrang berechnet wird. Wird im ISO 3166-Format dargestellt. In der |
reportCategoryId |
ID der Google-Produktkategorie, für die der Anzeigenrang berechnet wird, angegeben in der Produkt-Taxonomie von Google. In der |
title |
Titel des Produktclusters. |
brand |
Marke des Produktclusters. |
categoryL1 |
Produktkategorie (1. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google. |
categoryL2 |
Produktkategorie (2. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google. |
categoryL3 |
Produktkategorie (3. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google. |
categoryL4 |
Produktkategorie (4. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google. |
categoryL5 |
Produktkategorie (5. Ebene) des Produktclusters, dargestellt in der Produkt-Taxonomie von Google. |
inventoryStatus |
Ob der Produktcluster Der Länderfilter im Bestsellerbericht wird im Feld nicht berücksichtigt. |
brandInventoryStatus |
Unabhängig davon, ob in mindestens einem der Länder derzeit mindestens ein Produkt der Marke „ Der Länderfilter im Bestsellerbericht wird im Feld nicht berücksichtigt. |
rank |
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 |
Beliebtheitsrang in der vorherigen Woche oder im vorherigen Monat. |
relativeDemand |
Die geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land. |
previousRelativeDemand |
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 |
Ä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 ( |
Felder | |
---|---|
reportDate |
Datum des Berichts. Für dieses Feld ist nur einer der folgenden Werte zulässig:
In der |
reportGranularity |
Detaillierungsgrad des Berichts Das Ranking kann über einen Zeitraum von einer Woche oder einem Monat erfolgen. In der |
reportCountryCode |
Land, in dem der Anzeigenrang berechnet wird. Wird im ISO 3166-Format dargestellt. In der |
reportCategoryId |
ID der Google-Produktkategorie, für die der Anzeigenrang berechnet wird, angegeben in der Produkt-Taxonomie von Google. In der |
brand |
Der Name der Marke. |
rank |
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 |
Beliebtheitsrang in der vorherigen Woche oder im vorherigen Monat. |
relativeDemand |
Die geschätzte Nachfrage im Verhältnis zur Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land. |
previousRelativeDemand |
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 |
Ä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 ( |
Felder | |
---|---|
date |
Das Datum dieser Zeile. In der |
domain |
Die Domain Ihres Mitbewerbers oder Ihre Domain, falls „isYourDomain“ trifft zu. In der |
isYourDomain |
Dieser Wert ist auf „True“ gesetzt, wenn diese Zeile Daten für Ihre Domain enthält. Kann nicht im Bereich "WHERE" gefiltert werden Klausel. |
reportCountryCode |
Land, in dem Impressionen aufgetreten sind. In der |
reportCategoryId |
Die Google-Produktkategorie-ID, für die der Bericht berechnet werden soll, angegeben in der Produkt-Taxonomie von Google. In der |
trafficSource |
Zugriffsquelle von Impressionen. In der |
rank |
Position der Domain in dem Ranking ähnlicher Unternehmen für die ausgewählten Schlüssel ( Kann nicht im Bereich "WHERE" gefiltert werden Klausel. |
adsOrganicRatio |
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 im Bereich "WHERE" gefiltert werden Klausel. |
pageOverlapRate |
Die Überschneidungsrate der Seiten gibt an, wie oft die Angebote von Mitbewerbern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden. Kann nicht im Bereich "WHERE" gefiltert werden Klausel. |
higherPositionRate |
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 im Bereich "WHERE" gefiltert werden Klausel. |
relativeVisibility |
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 im Bereich "WHERE" gefiltert werden Klausel. |
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.
Bericht „Mitbewerber im Blick“ 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 ( |
Felder | |
---|---|
date |
Das Datum dieser Zeile. Kann in der |
domain |
Die Domain Ihres Mitbewerbers oder Ihre Domain, falls „isYourDomain“ trifft zu. In der |
isYourDomain |
Dieser Wert ist auf „True“ gesetzt, wenn diese Zeile Daten für Ihre Domain enthält. Kann nicht im Bereich "WHERE" gefiltert werden Klausel. |
reportCountryCode |
Land, in dem Impressionen aufgetreten sind. In der |
reportCategoryId |
Die Google-Produktkategorie-ID, für die der Bericht berechnet werden soll, angegeben in der Produkt-Taxonomie von Google. In der |
trafficSource |
Zugriffsquelle von Impressionen. In der |
rank |
Position der Domain im Top-Händler-Ranking für die ausgewählten Schlüssel ( Kann nicht im Bereich "WHERE" gefiltert werden Klausel. |
adsOrganicRatio |
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 im Bereich "WHERE" gefiltert werden Klausel. |
pageOverlapRate |
Die Überschneidungsrate der Seiten gibt an, wie oft die Angebote von Mitbewerbern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden. Kann nicht im Bereich "WHERE" gefiltert werden Klausel. |
higherPositionRate |
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 im Bereich "WHERE" gefiltert werden Klausel. |
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 ( |
Felder | |
---|---|
date |
Das Datum dieser Zeile. In der |
reportCountryCode |
Land, in dem Impressionen aufgetreten sind. In der |
reportCategoryId |
Die Google-Produktkategorie-ID, für die der Bericht berechnet werden soll, angegeben in der Produkt-Taxonomie von Google. In der |
trafficSource |
Zugriffsquelle von Impressionen. In der |
yourDomainVisibilityTrend |
Ä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 im Bereich "WHERE" gefiltert werden Klausel. |
categoryBenchmarkVisibilityTrend |
Ä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 im Bereich "WHERE" gefiltert werden Klausel. |