Berichte von der Content API for Shopping migrieren

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

Mit der Merchant Reports API können Sie Folgendes tun:

  • Leistung Ihrer Produkte messen: 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: In der Merchant API werden die Felder für den Betrag in Mikros und die Währung in einem Feld vom Typ Price zusammengefasst.
  • Markt verstehen: Mit der Merchant API erhalten Sie Daten zu den meistverkauften Produkten und Marken, wettbewerbsfähigen Preispunkten, Vorschlägen für Sonderangebotspreise und Informationen zur Wettbewerbslandschaft in Ihrer Branche.
  • Wettbewerbslandschaft analysieren: Sie können einen Bericht abrufen, um die Wettbewerbssituation auf Produktkategorieebene zu verstehen und Maßnahmen zur Verbesserung Ihrer Sichtbarkeit zu ergreifen.

So binden Sie die Merchant Reports API in Ihre bestehende Content API for Shopping-Implementierung ein:

Anfragen

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

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

Hier ist ein Beispielvergleich 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/v1/{PARENT}/reports:search
IDs {MERCHANT_ID} {PARENT}

Methoden

Sie können die Merchant Reports API abfragen, indem Sie die Methode ReportService.Search aufrufen.

Aufrufe

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

MerchantPerformanceView ist 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 die Angabe eines Feldpräfixes, z. B. segments.offer_id, nicht mehr erforderlich. Verwenden Sie stattdessen einfach den Feldnamen offer_id.

Hier ist ein Beispielvergleich 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. In der Merchant API-Abfrage werden beispielsweise sowohl offer_id als auch product_performance_view.offer_id akzeptiert.

Leistung

Folgendes hat sich in der Leistungsansicht der Merchant Reports API geändert:

Content API Merchant API Beschreibung
segments.program: String marketing_method: String Das Segment program wird durch ein neues Feld marketing_method ersetzt. Weitere Informationen finden Sie unter Neue marketing method-Werte.
metrics.ctr: Double clickThroughRate: Double Der Messwert ctr wird in clickThroughRate umbenannt.
metrics.conversionValueMicros: Ganzzahl
segments.currencyCode: String 		conversionValue: {
object (Price)
} 		Die Felder „Betrag (Mikros)“ und „Währung“ werden zu einem Feld vom 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 zu
channel~language~feedLabel~offerId.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Die Felder „Betrag (Mikros)“ und „Währung“ werden in einem Feld vom 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)
}
] 		Die Definition von ItemIssue hat sich geändert
Nicht unterstützt feedLabel: String Das Feld feedLabel wird eingeführt.

Preisstatistiken

Folgendes hat sich bei der Ansicht der Preisinformationen 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 zu channel~language~feedLabel~offerId.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Die Felder „Betrag (Mikros)“ und „Währung“ werden zu einem Feld vom Typ Price zusammengeführt.
priceInsights.suggestedPriceMicros: Ganzzahl
priceInsights.suggestedPriceCurrencyCode: String 		suggestedPrice: {
object (Price)
} 		Die Felder „Betrag (Mikros)“ und „Währung“ werden in einem Feld vom Typ Price zusammengeführt
priceInsights.predictedGrossProfitChangeFraction: Double
priceInsights.predictedMonthlyGrossProfitChangeMicros: Ganzzahl
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 bei der 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 zu channel~language~feedLabel~offerId.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Die Felder für Betrag (Mikros) und Währung werden in einem Feld vom Typ Price zusammengeführt.
priceCompetitiveness.countryCode: String reportCountryCode: String Das Feld countryCode wird in reportCountryCode umbenannt.
priceCompetitiveness.benchmarkPriceMicros: Ganzzahl
priceCompetitiveness.benchmarkPriceCurrencyCode: String 		benchmarkPrice: {
object (Price)
} 		Die Felder „Betrag (Mikros)“ und „Währung“ werden zu einem Feld vom Typ Price zusammengeführt.

Bestseller

Folgendes hat sich bei den Bestselleransichten in der Merchant Reports API geändert:

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

Wettbewerbsposition

Folgendes hat sich bei den Ansichten zur Wettbewerbsposition in der Merchant Reports API geändert:

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

Zurück
Migrate products management
Weiter
Migrate data sources management