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 Merchant API, MerchantPerformanceView est désormais product_performance_view.
• Filtrer vos produits selon des champs spécifiques : Avec l'API Merchant, vous pouvez filtrer tous les champs disponibles, à l'exception de item_issues.
• Améliorez la tarification de vos produits : Avec Merchant API, les champs de montant en micros et de devise sont fusionnés en un seul champ de type Price.
• Comprendre le marché : avec Merchant API, 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.
• Explorez 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 l'API 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 méthode ReportService.Search.

Vues

Dans l'API Merchant, les noms de table sont passés de CamelCase à snake_case.

MerchantPerformanceView est désormais product_performance_view.

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

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 du champ, offer_id.

Voici un exemple de comparaison de 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 tous deux acceptés dans la requête Merchant API.

Performances

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

Nouvelles valeurs de méthode de marketing

Voici la correspondance entre les valeurs segments.program et marketing_method :

Produit

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

Tendances des prix

Voici ce qui a changé pour 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 ce qui a changé pour les vues des meilleures ventes dans l'API Merchant Reports :

Visibilité par rapport aux concurrents

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