Berichte von der Content API for Shopping migrieren

Im Folgenden wird beschrieben, wie Sie die Merchant Reports API in Ihre bestehende Content API for Shopping-Implementierung einbinden.

Anfragen

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

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

Hier ein Beispielvergleich der Content API for Shopping mit der Merchant Reports API für search-Anfragen:

Content API Händler-API
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
IDs {merchantId} {parent}

Methoden

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

Aufrufe

In der Merchant API werden Tabellennamen von CammelCase 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 Händler-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 ein Beispiel für Abfragen in der Content API for Shopping und in der Merchant API:

Content API Händler-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 Händler-API 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Der Tabellenname kann als Feldpräfix verwendet werden. Beispielsweise werden in der Merchant API-Abfrage sowohl offer_id als auch product_performance_view.offer_id akzeptiert.

Leistung

Für die Leistungsansicht in der Merchant Reports API wurden folgende Änderungen vorgenommen:

Content API Händler-API Beschreibung
segments.program: String marketing_method: String program Segment wird durch ein neues marketing_method-Feld ersetzt. Weitere Informationen finden Sie unter Neue marketing method-Werte.
metrics.ctr: doppelt clickThroughRate: doppelt Messwert „ctr“ wurde in „clickThroughRate“ umbenannt
metrics.conversionValueMicros: Ganzzahl
segments.currencyCode: String 		conversionValue: {
object (Price)
} 		Betragsfelder und Währungsfelder werden zu einem 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 sehen Sie die Zuordnung zwischen segments.program- und marketing_method-Werten:

Content API Händler-API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Nicht unterstützt

Produkt

Für die Produktansicht in der Merchant Reports API wurden folgende Änderungen vorgenommen:

Content API Händler-API Beschreibung
productView.id: String id: String Das Format des Felds wird von channel:language:targetCountry:offerId in
channel~language~feedLabel~offerId geändert.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Betragsfelder und Währungsfelder werden zu einem 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)
}
] 		Die Definition von „ItemIssue“ hat sich geändert
Nicht unterstützt feedLabel: String Feld „feedLabel“ wurde eingeführt

Preisstatistiken

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

Content API Händler-API Beschreibung
productView.id: String id: String Das Format des Felds wird von channel:language:targetCountry:offerId in channel~language~feedLabel~offerId geändert.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Betragsfelder und Währungsfelder werden zu einem Feld mit dem Typ Price zusammengeführt.
priceInsights.suggestedPriceMicros: Ganzzahl
priceInsights.suggestedPriceCurrencyCode: String 		suggestedPrice: {
object (Price)
} 		Betragsfelder und Währungsfelder werden zu einem Feld mit dem Typ Price zusammengeführt.
priceInsights.predictedGrossProfitChangeFraction: Double
priceInsights.predictedMonthlyGrossProfitChangeMicros: Ganzzahl
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: String 		Nicht unterstützt Felder, die sich auf die Änderung des Bruttogewinns beziehen, werden in der Merchant Reports API nicht unterstützt

Wettbewerbsfähigkeit von Preisen

Folgendes wurde in der Merchant Reports API in der Ansicht „Wettbewerbsfähigkeit von Preisen“ geändert:

Content API Händler-API Beschreibung
productView.id: String id: String Das Format des Felds wird von channel:language:targetCountry:offerId in channel~language~feedLabel~offerId geändert.
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Betragsfelder und Währungsfelder werden zu einem Feld mit dem Typ Price zusammengeführt.
priceCompetitiveness.countryCode: String reportCountryCode: String Das Feld „countryCode“ wurde in „reportCountryCode“ umbenannt
priceCompetitiveness.benchmarkPriceMicros: Ganzzahl
priceCompetitiveness.benchmarkPriceCurrencyCode: String 		benchmarkPrice: {
object (Price)
} 		Betragsfelder und Währungsfelder werden zu einem Feld mit dem Typ Price zusammengeführt.

Bestseller

Folgendes wurde für die Bestseller-Ansichten in der Merchant Reports API geändert:

Content API Händler-API Beschreibung
bestSellers.countryCode: String reportCountryCode: String Das Feld „countryCode“ wurde in „reportCountryCode“ umbenannt
bestSellers.categoryId: Ganzzahl reportCategoryId: Ganzzahl Das Feld „categoryId“ wurde in „reportCategoryId“ umbenannt

Wettbewerbsposition

Folgendes wurde an den Ansichten „Mitbewerber im Blick“ in der Merchant Reports API geändert:

Content API Händler-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
Verwaltung von Conversion-Quellen migrieren
Weiter
Partnerschaftsverwaltung für lokale Feeds migrieren