Berichte von der Content API for Shopping migrieren

Mit der Merchant Reports API können Sie anhand der angebotenen Datenansicht mehr über Ihre Produkte, ihre Leistung und das Wettbewerbsumfeld auf Google erfahren.

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

  • 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 außer item_issues.
  • Produktpreise optimieren: Mit der Merchant API werden die Felder für Beträge in Mikros und Währung in einem Feld vom Typ Price zusammengeführt.
  • Markt analysieren: Mit der Merchant API können Sie Daten zu Bestsellern und ‑Marken, wettbewerbsfähigen Preisen, Vorschlägen für Verkaufspreise und Informationen zum Wettbewerbsumfeld für Ihre Branche abrufen.
  • Wettbewerbsumfeld analysieren: Sie können einen Bericht abrufen, um Ihr Wettbewerbsumfeld auf Produkt kategorieebene zu analysieren und Maßnahmen zu ergreifen, um Ihre Sichtbarkeit zu erhöhen.

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

Anfragen

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

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

Hier sehen Sie einen Beispielvergleich zwischen der Content API for Shopping und 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 ReportService.Search Methode aufrufen.

Aufrufe

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

MerchantPerformanceView ist jetzt product_performance_view.

Hier sehen Sie 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 anzugeben, z. B. segments.offer_id. Verwenden Sie stattdessen einfach den Feldnamen offer_id.

Hier sehen Sie einen Beispielvergleich zwischen 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 für die Leistungsansicht in 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 Werte für marketing method.
metrics.ctr: double clickThroughRate: double Der Messwert ctr wird in clickThroughRate umbenannt.
metrics.conversionValueMicros: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		Die Felder für Beträge in Mikros und Währung werden in 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 „marketing method“

Hier sehen Sie die Zuordnung zwischen den Werten für segments.program und marketing_method:

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: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Die Felder für Beträge in 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 wird 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 für die Ansicht der 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 zu channel~language~feedLabel~offerId.
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Die Felder für Beträge in Mikros und Währung werden in einem Feld vom Typ Price zusammengeführt.
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		Die Felder für Beträge in Mikros und Währung werden in einem Feld vom Typ Price zusammengeführt.
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		Nicht unterstützt Felder im Zusammenhang mit Änderungen des Bruttogewinns werden in der Merchant Reports API nicht unterstützt.

Wettbewerbsfähigkeit von Preisen

Folgendes hat sich für die Ansicht der 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: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Die Felder für Beträge in 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: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		Die Felder für Beträge in Mikros und Währung werden in einem Feld vom Typ Price zusammengeführt.

Bestseller

Folgendes hat sich für die Ansichten der Bestseller 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 für die Ansichten der 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: integer reportCategoryId: integer Das Feld categoryId wird in reportCategoryId umbenannt.

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