Berichte von der Content API for Shopping migrieren

Mit der Merchant Reports API können Sie über die Datenansicht Informationen zu Ihren Produkten, ihrer Leistung und ihrer Wettbewerbsumgebung auf Google abrufen.

Mit der Merchant Reports API haben Sie folgende Möglichkeiten:

  • Leistung Ihrer Produkte analysieren: In der Merchant API ist MerchantPerformanceView jetzt product_performance_view.
  • Produkte nach bestimmten Feldern filtern: Mit der Merchant API können Sie nach allen verfügbaren Feldern filtern, mit Ausnahme von item_issues.
  • Produktpreise verbessern: Mit der Merchant API werden Micros für den Betrag und Währungsfelder in einem Feld vom Typ Price zusammengeführt.
  • Marktinformationen: Mit der Merchant API können Sie Daten zu meistverkauften Produkten und Marken, wettbewerbsfähigen Preispunkten, Vorschlägen für Sonderangebotspreise und Informationen zum Wettbewerbsumfeld in Ihrer Branche abrufen.
  • Wettbewerbslandschaft analysieren: Sie können sich einen Bericht ansehen, um die Wettbewerbssituation auf Produktkategorieebene zu verstehen und Maßnahmen zur Verbesserung Ihrer Sichtbarkeit zu ergreifen.

So können Sie die Merchant Reports API in Ihre bestehende Content API for Shopping-Implementierung einbinden.

Anfragen

Verwenden Sie für die Merchant Reports API das folgende Anfrage-URL-Format:

POST https://merchantapi.googleapis.com/reports/v1beta/{PARENT}/reports:search

Hier ist ein Beispiel für einen Vergleich der Content API for Shopping mit der Merchant Reports API für search-Anfragen:

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{PARENT}/reports:search
IDs {MERCHANT_ID} {PARENT}

Methoden

Sie können die Merchant Reports API durch Aufrufen der Methode ReportService.Search abfragen.

Aufrufe

In der Merchant API werden Tabellennamen von CammelCase in snake_case geändert.

MerchantPerformanceView heißt jetzt product_performance_view.

Hier ist eine Zuordnung zwischen Tabellennamen in der Content API for Shopping und der Merchant API:

Content API Merchant API
MerchantPerformanceView product_performance_view
ProductView product_view
PriceCompetitivenesProductView price_competitiveness_product_view
PriceInsightsProductView price_insights_product_view
BestSellersBrandView best_sellers_brand_view
BestSellersProductClusterView best_sellers_product_cluster_view
CompetitiveVisibilityCompetitorView competitive_visibility_competitor_view
CompetitiveVisibilityTopMerchantView competitive_visibility_top_merchant_view
CompetitiveVisibilityBenchmarkView competitive_visibility_benchmark_view

In der Merchant API ist es nicht mehr erforderlich, ein Feldpräfix wie segments.offer_id anzugeben. Verwenden Sie stattdessen einfach den Feldnamen offer_id.

Hier ist ein Beispiel für einen Vergleich von Abfragen in der Content API for Shopping und der Merchant API:

Content API Merchant API 
   SELECT
     segments.offer_id,
     metrics.clicks
   FROM MerchantPerformanceView
   WHERE segments.date DURING LAST_7_DAYS
   
   SELECT
     offer_id,
     clicks
   FROM product_performance_view
   WHERE date DURING LAST_7_DAYS

Sie sehen hier ein Beispiel:

Content API Merchant API 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
 
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Der Tabellenname kann als Feldpräfix verwendet werden. Sowohl offer_id als auch product_performance_view.offer_id sind beispielsweise in der Merchant API-Abfrage zulässig.

Leistung

Folgende Änderungen wurden an der Leistungsansicht in der Merchant Reports API vorgenommen:

Content API Merchant API Beschreibung
segments.program: String marketing_method: String Das program-Segment wird durch ein neues marketing_method-Feld ersetzt. Weitere Informationen finden Sie unter Neue marketing method-Werte.
metrics.ctr: double clickThroughRate: double Der Messwert ctr wurde in clickThroughRate umbenannt.
metrics.conversionValueMicros: Ganzzahl
segments.currencyCode: String 		conversionValue: {
object (Price)
} 		Mikro- und Währungsfelder für Beträge werden in ein Feld mit dem Typ Price zusammengeführt
metrics.orders,
metrics.orderedItems,
… 		Nicht unterstützt Buy on Google-Messwerte werden in der Merchant Reports API nicht unterstützt

Neue Werte für Marketingmethoden

Hier ist die Zuordnung zwischen segments.program- und marketing_method-Werten:

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Nicht unterstützt

Produkt

Folgendes hat sich für die Produktansicht in der Merchant Reports API geändert:

Content API Merchant API Beschreibung
productView.id: String id: String Das Feldformat ändert sich von channel:language:targetCountry:offerId in
channel~language~feedLabel~offerId.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Mikro- und Währungsfelder für Beträge werden in ein Feld mit dem Typ Price zusammengeführt
productView.aggregated_destination_status: String aggregated_reporting_context_status: String Das Feld aggregated_destination_status wurde in aggregated_reporting_context_status umbenannt, die Werte haben sich nicht geändert
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		Definition von ItemIssue geändert
Nicht unterstützt feedLabel: String Einführung des Felds feedLabel

Preisstatistiken

Folgendes hat sich für die Ansicht „Preisstatistiken“ in der Merchant Reports API geändert:

Content API Merchant API Beschreibung
productView.id: String id: String Das Feldformat ändert sich von channel:language:targetCountry:offerId in channel~language~feedLabel~offerId.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Mikro- und Währungsfelder für Beträge werden in ein Feld mit dem Typ Price zusammengeführt
priceInsights.suggestedPriceMicros: Ganzzahl
priceInsights.suggestedPriceCurrencyCode: String 		suggestedPrice: {
object (Price)
} 		Mikro- und Währungsfelder für Beträge werden in ein Feld mit dem Typ Price zusammengeführt
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		Nicht unterstützt Felder im Zusammenhang mit der Änderung des Bruttogewinns werden in der Merchant Reports API nicht unterstützt

Wettbewerbsfähigkeit von Preisen

Folgendes hat sich für die Ansicht zur Wettbewerbsfähigkeit von Preisen in der Merchant Reports API geändert:

Content API Merchant API Beschreibung
productView.id: String id: String Das Feldformat ändert sich von channel:language:targetCountry:offerId in channel~language~feedLabel~offerId.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Mikro- und Währungsfelder für Beträge werden in ein Feld mit dem Typ Price zusammengeführt
priceCompetitiveness.countryCode: String reportCountryCode: String Feld countryCode in reportCountryCode umbenannt
priceCompetitiveness.benchmarkPriceMicros: Ganzzahl
priceCompetitiveness.benchmarkPriceCurrencyCode: String 		benchmarkPrice: {
object (Price)
} 		Mikro- und Währungsfelder für Beträge werden in ein Feld mit dem Typ Price zusammengeführt

Bestseller

Folgende Änderungen wurden an den Bestselleransichten in der Merchant Reports API vorgenommen:

Content API Merchant API Beschreibung
bestSellers.countryCode: String reportCountryCode: String Feld countryCode in reportCountryCode umbenannt
bestSellers.categoryId: int reportCategoryId: int Feld categoryId in reportCategoryId umbenannt

Wettbewerbsposition

Folgende Änderungen wurden an den Datenansichten für die Sichtbarkeit von Mitbewerbern in der Merchant Reports API vorgenommen:

Content API Merchant API Beschreibung
competitiveVisibility.countryCode: String reportCountryCode: String Feld countryCode in reportCountryCode umbenannt
competitiveVisibility.categoryId: Ganzzahl reportCategoryId: Ganzzahl Feld categoryId in reportCategoryId umbenannt

Zurück
Migrate conversion sources management
Weiter
Migrate local feeds partnership management