Migrer les rapports depuis Content API for Shopping

Voici comment intégrer l'API Merchant Reports à votre implémentation Content API for Shopping existante.

Requêtes

Utilisez le format d'URL de requête suivant pour l'API Merchant Reports:

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

Voici un exemple de comparaison de Content API for Shopping et de l'API Merchant Reports pour les requêtes search:

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

Méthodes

Vous pouvez interroger l'API Merchant Reports en appelant la méthode ReportService.Search.

Vues

Dans l'API Merchant Center, les noms de tables CammelCase sont remplacés par snake_case.

MerchantPerformanceView est désormais product_performance_view.

Voici une mise en correspondance des noms de tables dans Content API for Shopping et dans Merchant API:

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

Dans l'API Merchant Center, il n'est plus nécessaire de spécifier un préfixe de champ (par exemple, segments.offer_id). Utilisez plutôt le nom du champ, offer_id.

Voici un exemple de comparaison des requêtes dans Content API pour Shopping et dans Merchant API:

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

Voici un exemple de réponse :

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

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

Le nom de la table peut être utilisé comme préfixe de champ. Par exemple, offer_id et product_performance_view.offer_id sont acceptés dans la requête de l'API Merchant Center.

Performances

Voici les modifications apportées à l'affichage des performances dans Merchant Reports:

Content API API Merchant Center Description
segments.program : chaîne marketing_method : chaîne Le segment program est remplacé par un nouveau champ marketing_method. Pour en savoir plus, consultez Nouvelles valeurs marketing method.
metrics.ctr: double clickThroughRate: double La métrique "ctr" a été renommée clickThroughRate
metrics.conversionValueMicros: entier
segments.currencyCode: chaîne 		conversionValue: {
object (Price)
} 		Les champs de devise et de micro-unités sont fusionnés en un seul champ de type Price.
metrics.orders,
metrics.orderedItems,
… 		Non autorisé Les métriques Acheter sur Google ne sont pas compatibles avec l'API Merchant Reports

Nouvelles valeurs de méthode marketing

Voici le mappage entre les valeurs segments.program et marketing_method:

Content API API Merchant Center
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Non autorisé

Produit

Voici ce qui a changé pour l'affichage des produits dans Merchant Reports:

Content API API Merchant Center Description
productView.id : chaîne id : chaîne Le format du champ passe de channel:language:targetCountry:offerId à
channel~language~feedLabel~offerId.
productView.priceMicros: entier
productView.currencyCode: chaîne 		price: {
object (Price)
} 		Les champs de devise et de micro-unités sont fusionnés en un seul champ de type Price.
productView.aggregated_destination_status : chaîne aggregated_reporting_context_status : chaîne Le champ aggregated_destination_status a été renommé aggregated_reporting_context_status, les valeurs n'ont pas changé
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		La définition de ItemIssue a changé
Non autorisé feedLabel : chaîne Le champ feedLabel est ajouté

Tendances des prix

Voici les modifications apportées à la vue "Tendances des prix" dans l'API Merchant Reports:

Content API API Merchant Center Description
productView.id : chaîne id : chaîne Le format du champ passe de channel:language:targetCountry:offerId à channel~language~feedLabel~offerId.
productView.priceMicros: entier
productView.currencyCode: chaîne 		price: {
object (Price)
} 		Les champs de devise et de micro-unités sont fusionnés en un seul champ de type Price.
priceInsights.suggestedPriceMicros: entier
priceInsights.suggestedPriceCurrencyCode: chaîne 		suggestedPrice: {
object (Price)
} 		Les champs de devise et de micro-unités sont fusionnés en un seul champ de type Price.
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: entier
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: chaîne 		Non autorisé Les champs liés à la variation de la marge brute ne sont pas acceptés dans l'API Merchant Reports.

Compétitivité tarifaire

Voici les modifications apportées à l'affichage "Compétitivité tarifaire" dans l'API Merchant Reports:

Content API API Merchant Center Description
productView.id : chaîne id : chaîne Le format du champ passe de channel:language:targetCountry:offerId à channel~language~feedLabel~offerId.
productView.priceMicros: entier
productView.currencyCode: chaîne 		price: {
object (Price)
} 		Les champs de devise et de micro-unités sont fusionnés en un seul champ de type Price.
priceCompetitiveness.countryCode : chaîne reportCountryCode : chaîne Le champ "countryCode" a été renommé reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: entier
priceCompetitiveness.benchmarkPriceCurrencyCode: chaîne 		benchmarkPrice: {
object (Price)
} 		Les champs de devise et de micro-unités sont fusionnés en un seul champ de type Price.

Meilleures ventes

Voici ce qui a changé pour les vues "Meilleures ventes" dans l'API Merchant Reports:

Content API API Merchant Center Description
bestSellers.countryCode : chaîne reportCountryCode : chaîne Le champ "countryCode" a été renommé reportCountryCode
bestSellers.categoryId: int reportCategoryId: int Le champ "categoryId" a été renommé reportCategoryId

Visibilité par rapport à vos concurrents

Voici les modifications apportées à la visibilité sur les concurrents dans l'API Merchant Reports:

Content API API Merchant Center Description
competitiveVisibility.countryCode : chaîne reportCountryCode : chaîne Le champ "countryCode" a été renommé reportCountryCode
competitiveVisibility.categoryId: entier reportCategoryId: entier Le champ "categoryId" a été renommé reportCategoryId

Précédent
Migrer la gestion des sources de conversion
Suivant
Migrer la gestion des partenariats pour les flux en magasin