Berichte von der Content API for Shopping migrieren

So integrieren Sie Händlerberichte mit Ihrer vorhandenen Content API für Shopping-Implementierung

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 sehen Sie ein Beispiel für einen Vergleich zwischen der Content API for Shopping und der 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 .

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 den Tabellennamen in der Content API for Shopping und dem Händler-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

Angabe eines Feldpräfixes in der Merchant API, z. B. segments.offer_id ist nicht mehr erforderlich. Verwenden Sie stattdessen den Feldnamen offer_id.

Im Folgenden finden Sie ein Beispiel für einen Vergleich von Suchanfragen in der Content API for Shopping und im Händler-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 sowohl offer_id als auch product_performance_view.offer_id werden in der Merchant API-Abfrage akzeptiert.

Leistung

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

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)
} 		Die Felder „Betrag“ und „Währung“ sind in einem Feld vom Typ Price zusammengefasst.
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 den Werten segments.program und marketing_method:

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

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

Content API Händler-API Beschreibung
productView.id: String id: String Das Feldformat wird von channel:language:targetCountry:offerId in
channel~language~feedLabel~offerId geändert
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Die Felder „Betrag“ und „Währung“ sind in einem Feld vom Typ Price zusammengefasst.
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)
}
] 		ItemIssue-Definition wurde geändert
Nicht unterstützt feedLabel: String Das Feld feedLabel wurde eingeführt

Preisstatistiken

Folgendes hat sich in der Ansicht „Preisinformationen“ in der Merchant Reports API geändert:

Content API Händler-API Beschreibung
productView.id: String id: String Das Feldformat wird von „channel:language:targetCountry:offerId“ zu „channel~language~feedLabel~offerId“ geändert
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Die Felder „Betrag“ und „Währung“ sind in einem Feld vom Typ Price zusammengefasst.
priceInsights.suggestedPriceMicros: Ganzzahl
priceInsights.suggestedPriceCurrencyCode: String 		suggestedPrice: {
object (Price)
} 		Die Felder „Betrag“ und „Währung“ sind in einem Feld vom Typ Price zusammengefasst.
priceInsights.predictedGrossProfitChangeFraction: doppelt
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 hat sich an der Ansicht „Wettbewerbsfähigkeit von Preisen“ in Händlerberichten geändert: API:

Content API Händler-API Beschreibung
productView.id: String id: String Das Feldformat wird von „channel:language:targetCountry:offerId“ zu „channel~language~feedLabel~offerId“ geändert
productView.priceMicros: Ganzzahl
productView.currencyCode: String 		price: {
object (Price)
} 		Die Felder „Betrag“ und „Währung“ sind in einem Feld vom Typ Price zusammengefasst.
priceCompetitiveness.countryCode: String reportCountryCode: String Das Feld „countryCode“ wurde in „reportCountryCode“ umbenannt
priceCompetitiveness.benchmarkPriceMicros: Ganzzahl
priceCompetitiveness.benchmarkPriceCurrencyCode: String 		benchmarkPrice: {
object (Price)
} 		Die Felder „Betrag“ und „Währung“ sind in einem Feld vom Typ Price zusammengefasst.

Bestseller

Folgendes hat sich 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: int reportCategoryId: int Das Feld „categoryId“ wurde in „reportCategoryId“ umbenannt

Wettbewerbsposition

Folgendes hat sich bei der Ansicht „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