Migrer les rapports depuis Content API for Shopping

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

Demandes

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 avec l'API Merchant Reports pour les requêtes search:

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

Méthodes

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

Vues

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

MerchantPerformanceView est désormais product_performance_view.

Voici un mappage entre les noms de tables dans Content API for Shopping et l'API Merchant:

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

Dans l'API Merchant, 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 for Shopping et l'API Merchant:

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

Voici un exemple de réponse :

Content API API Merchant 
{
  "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.

Performances

Voici ce qui a changé pour la vue "Performances" dans l'API Merchant Reports:

Content API API Merchant 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é rebaptisée clickThroughRate.
metrics.conversionValueMicros: entier
segments.currencyCode: chaîne 		conversionValue: {
object (Price)
} 		Les champs de montant en micro-unités et de devise sont fusionnés en un seul champ de type Price.
metrics.orders,
metrics.orderedItems,
… 		Non compatible 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
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Non compatible

Produit

Voici ce qui a changé pour la vue produit dans l'API Merchant Reports:

Content API API Merchant 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 montant en micro-unités et de devise 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 est renommé aggregated_reporting_context_status, mais les valeurs n'ont pas changé
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		La définition de ItemIssue a changé
Non compatible feedLabel : chaîne Introduction du champ feedLabel

Tendances des prix

Voici ce qui a changé pour la vue "Insights sur les prix" dans l'API Merchant Reports:

Content API API Merchant 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 montant en micro-unités et de devise sont fusionnés en un seul champ de type Price.
priceInsights.suggestedPriceMicros: entier
priceInsights.suggestedPriceCurrencyCode: chaîne 		suggestedPrice: {
object (Price)
} 		Les champs de montant en micro-unités et de devise sont fusionnés en un seul champ de type Price.
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: entier
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: chaîne 		Non compatible Les champs liés à la variation de la marge brute ne sont pas acceptés dans l'API Merchant Reports.

Compétitivité tarifaire

Voici ce qui a changé pour la vue "Compétitivité tarifaire" dans l'API Merchant Reports:

Content API API Merchant 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 montant en micro-unités et de devise 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 montant en micro-unités et de devise 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 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 aux concurrents

Voici ce qui a changé pour les vues de visibilité par rapport aux concurrents dans l'API Merchant Reports:

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