Berichte von der Content API for Shopping migrieren

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

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 optimieren: Mit der Merchant API werden die Felder „Betrag in Mikroeinheiten“ und „Währung“ in einem Feld vom Typ Price zusammengeführt.
  • Markt verstehen: Mit der Merchant API können Sie Daten zu meistverkauften Produkten und Marken, wettbewerbsfähigen Preispunkten, Vorschlägen für Angebotspreise und Informationen zum Wettbewerbsumfeld für Ihre Branche abrufen.
  • Wettbewerbsumfeld analysieren: Sie können einen Bericht erstellen, um die Wettbewerbssituation auf Produktkategorieebene zu analysieren und Maßnahmen zu ergreifen, mit denen Sie Ihre Sichtbarkeit erhöhen.

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/v1/{PARENT}/reports:search

Hier sehen Sie 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/v1/{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 CamelCase zu snake_case geändert.

MerchantPerformanceView heißt jetzt product_performance_view.

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

Hier sehen Sie ein Beispiel für den Vergleich von Anfragen 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

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

Content API Merchant API Beschreibung
segments.program: String marketing_method: String Das Segment program wird durch das neue Feld marketing_method ersetzt. Weitere Informationen finden Sie unter Neue marketing method-Werte.
metrics.ctr: double clickThroughRate: double Der Messwert ctr wurde in clickThroughRate umbenannt.
metrics.conversionValueMicros: Integer
segments.currencyCode: String 		conversionValue: {
object (Price)
} 		Die Felder „Betrag (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 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: Integer
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 „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 „Betrag (Mikros)“ und „Währung“ werden in einem Feld vom Typ Price zusammengeführt.
priceInsights.suggestedPriceMicros: Integer
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: 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 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: Integer
productView.currencyCode: String 		price: {
object (Price)
} 		Die Felder „Betrag (Mikros)“ und „Währung“ werden in einem Feld vom Typ Price zusammengeführt.
priceCompetitiveness.countryCode: String reportCountryCode: String Das Feld countryCode wurde in reportCountryCode umbenannt.
priceCompetitiveness.benchmarkPriceMicros: Integer
priceCompetitiveness.benchmarkPriceCurrencyCode: String 		benchmarkPrice: {
object (Price)
} 		Die Felder „Betrag (Mikros)“ und „Währung“ werden in 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 wurde in reportCountryCode umbenannt.
bestSellers.categoryId: int reportCategoryId: int Das Feld categoryId wurde in reportCategoryId umbenannt.

Wettbewerbsposition

Folgendes hat sich bei den Ansichten für die Mitbewerber im Blick in der Merchant Reports API geändert:

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

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