Eseguire la migrazione dei report dall'API Content for Shopping

Ecco come puoi integrare l'API Merchant Reports con l'implementazione esistente dell'API Content for Shopping.

Richieste

Utilizza il seguente formato di URL di richiesta per l'API Merchant Reports:

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

Ecco un esempio di confronto tra l'API Content for Shopping e l'API Merchant Report per le richieste search:

API Content API Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Identificatori {merchantId} {parent}

Metodi

Puoi eseguire query sull'API Merchant Reports chiamando il metodo ReportService.Search.

Visualizzazioni

Nell'API Merchant, i nomi delle tabelle sono cambiati da CammelCase a snake_case.

MerchantPerformanceView ora è product_performance_view.

Ecco una mappatura tra i nomi delle tabelle nell'API Content for Shopping e nell'API Merchant:

API Content API Merchant
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

Nell'API Merchant, specificare un prefisso di campo, ad esempio segments.offer_id, non è più obbligatorio. Utilizza invece il nome del campo offer_id.

Ecco un esempio di confronto tra query nell'API Content for Shopping e nell'API Merchant:

API Content API Merchant 
   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

Ecco un esempio di risposta:

API Content API Merchant 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

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

Il nome della tabella può essere utilizzato come prefisso di campo. Ad esempio, sia offer_id sia product_performance_view.offer_id sono accettati nella query dell'API Merchant.

Esibizione

Ecco che cosa è cambiato per la visualizzazione del rendimento nell'API Merchant Reports:

API Content API Merchant Descrizione
segments.program: stringa marketing_method: stringa Il segmento program è stato sostituito da un nuovo campo marketing_method. Per informazioni dettagliate, consulta la sezione Nuovi valori di marketing method.
metrics.ctr: doppio clickThroughRate: doppio La metrica ctr è stata rinominata clickThroughRate
metrics.conversionValueMicros: numero intero
segments.currencyCode: stringa 		conversionValue: {
object (Price)
} 		I micro di importo e i campi di valuta vengono uniti in un unico campo di tipo Price
metrics.orders,
metrics.orderedItems,
… 		Non supportata Le metriche di Acquista su Google non sono supportate nell'API Merchant Reports

Nuovi valori del metodo di marketing

Ecco la mappatura tra i valori segments.program e marketing_method:

API Content API Merchant
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Non supportata

Prodotto

Ecco che cosa è cambiato per la visualizzazione dei prodotti nell'API Merchant Reports:

API Content API Merchant Descrizione
productView.id: stringa id: stringa Il formato del campo cambia da channel:language:targetCountry:offerId a
channel~language~feedLabel~offerId
productView.priceMicros: numero intero
productView.currencyCode: stringa 		price: {
object (Price)
} 		I micro di importo e i campi di valuta vengono uniti in un unico campo di tipo Price
productView.aggregated_destination_status: stringa aggregated_reporting_context_status: stringa Il campo aggregated_destination_status è stato rinominato in aggregated_reporting_context_status, i valori non sono cambiati
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		La definizione di ItemIssue è stata modificata
Non supportata feedLabel: stringa Viene introdotto il campo feedLabel

Approfondimenti sul prezzo

Ecco cosa è cambiato per la visualizzazione Approfondimenti sul prezzo nell'API Merchant Reports:

API Content API Merchant Descrizione
productView.id: stringa id: stringa Il formato del campo cambia da channel:language:targetCountry:offerId a channel~language~feedLabel~offerId
productView.priceMicros: numero intero
productView.currencyCode: stringa 		price: {
object (Price)
} 		I micro di importo e i campi di valuta vengono uniti in un unico campo di tipo Price
priceInsights.suggestedPriceMicros: numero intero
priceInsights.suggestedPriceCurrencyCode: stringa 		suggestedPrice: {
object (Price)
} 		I micro di importo e i campi di valuta vengono uniti in un unico campo di tipo Price
priceInsights.predictedGrossProfitChangeFraction: doppio
priceInsights.predictedMonthlyGrossProfitChangeMicros: numero intero
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: stringa 		Non supportata I campi relativi alla variazione del profitto lordo non sono supportati nell'API Merchant Reports

Competitività dei prezzi

Ecco cosa è cambiato per la visualizzazione Competitività del prezzo nell'API Merchant Reports:

API Content API Merchant Descrizione
productView.id: stringa id: stringa Il formato del campo cambia da channel:language:targetCountry:offerId a channel~language~feedLabel~offerId
productView.priceMicros: numero intero
productView.currencyCode: stringa 		price: {
object (Price)
} 		I micro di importo e i campi di valuta vengono uniti in un unico campo di tipo Price
priceCompetitiveness.countryCode: stringa reportCountryCode: stringa Il campo countryCode è stato rinominato reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: numero intero
priceCompetitiveness.benchmarkPriceCurrencyCode: stringa 		benchmarkPrice: {
object (Price)
} 		I micro di importo e i campi di valuta vengono uniti in un unico campo di tipo Price

Più venduti

Ecco che cosa è cambiato per le visualizzazioni Più venduti nell'API Merchant Reports:

API Content API Merchant Descrizione
bestSellers.countryCode: stringa reportCountryCode: stringa Il campo countryCode è stato rinominato reportCountryCode
bestSellers.categoryId: int reportCategoryId: int Il campo categoryId è stato rinominato reportCategoryId

Scenario competitivo

Ecco che cosa è cambiato per quanto riguarda le visualizzazioni dello scenario competitivo nell'API Merchant Reports:

API Content API Merchant Descrizione
competitiveVisibility.countryCode: stringa reportCountryCode: stringa Il campo countryCode è stato rinominato reportCountryCode
competitiveVisibility.categoryId: numero intero reportCategoryId: numero intero Il campo categoryId è stato rinominato reportCategoryId

Indietro
Esegui la migrazione della gestione delle origini conversione
Avanti
Esegui la migrazione della gestione della partnership per i feed locali