Migrer les rapports depuis Content API for Shopping

Vous pouvez utiliser l'API Merchant Reports pour en savoir plus sur vos produits, leurs performances et leur environnement concurrentiel sur Google grâce à la vue de données qu'elle propose.

Vous pouvez utiliser l'API Merchant Reports pour effectuer les opérations suivantes :

• Mesurer les performances de vos produits: Dans l'API Merchant, MerchantPerformanceView est désormais product_performance_view.
• Filtrer vos produits selon des champs spécifiques: Avec l'API Merchant, vous pouvez filtrer en fonction de tous les champs disponibles, à l'exception de item_issues.
• Améliorer les prix des produits: avec l'API Merchant, les champs de micro-montant et de devise sont fusionnés en un seul champ de type Price.
• Comprendre le marché : avec l'API Merchant, vous pouvez obtenir des données sur les produits et les marques les plus vendus, les prix compétitifs, les suggestions de prix soldés et des informations sur le paysage concurrentiel de votre secteur.
• Explorer votre paysage concurrentiel: vous pouvez obtenir un rapport pour comprendre votre paysage concurrentiel au niveau des catégories de produits et prendre des mesures pour améliorer votre visibilité.

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

Requêtes

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

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

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

Méthodes

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

Vues

Dans l'API Merchant, les noms de tables passent de CamelCase à 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 :

Dans l'API Merchant, il n'est plus nécessaire de spécifier un préfixe de champ, par exemple segments.offer_id. Utilisez simplement le nom de champ, offer_id.

Voici un exemple de comparaison entre les requêtes dans Content API for Shopping et l'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 :

{
  "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 les modifications apportées à la vue des performances dans l'API Merchant Reports :

Nouvelles valeurs de la méthode marketing

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

Produit

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

Tendances des prix

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

Compétitivité tarifaire

Voici les modifications apportées à la vue de la compétitivité tarifaire dans l'API Merchant Reports :

Meilleures ventes

Voici les modifications apportées aux vues des meilleures ventes dans l'API Merchant Reports :

Visibilité par rapport aux concurrents

Voici les modifications apportées aux vues de la visibilité par rapport aux concurrents dans l'API Merchant Reports :