Guide de démarrage rapide

Voici un exemple de requête destinée à product_performance_view qui renvoie les performances de votre compte au cours des 30 derniers jours, segmentées par marketing_method et offer_id. Vous pouvez essayer cet exemple simple pour vous familiariser avec l'API Merchant Reports.

Pour récupérer ce rapport, vous devez disposer du rôle Performances et insights. Pour en savoir plus, consultez la section Conditions requises.

Remarque :Ce guide présente la requête HTTP sous-jacente en tant qu'outil d'enseignement, mais nous vous recommandons d'utiliser l'une des bibliothèques clientes pour envoyer vos requêtes.

Pour envoyer la requête, transmettez cette instruction de langage de requête Merchant Center à la méthode accounts.reports.search:

SELECT
  marketing_method,
  offer_id,
  impressions,
  clicks,
  click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

URL de la requête HTTP

La requête consiste en une requête HTTP POST adressée au serveur de l'API Merchant Reports à l'URL suivante:

https://merchantapi.googleapis.com/reports/v1beta/accounts/ACCOUNT_ID/reports:search

Exemple de requête HTTP complète

Voici un exemple complet illustrant la définition de rapport incluse dans une requête HTTP POST:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/ACCOUNT_ID/reports:search HTTP/1.1

Parameters:
{
  "query" : "SELECT
              marketing_method,
              offer_id,
              impressions,
              clicks,
              click_through_rate
            FROM product_performance_view
            WHERE date BETWEEN '2023-11-01' AND '2023-11-30'"
}

Voici un exemple de réponse :

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38",
        "impressions": "1038",
        "clickThroughRate": "0.3661"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "126",
        "impressions": "1126",
        "clickThroughRate": "0.1119"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "26",
        "impressions": "526",
        "clickThroughRate": "0.0494"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "227",
        "impressions": "1227",
        "clickThroughRate": "0.1850"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "12",
        "impressions": "512",
        "clickThroughRate": "0.0234"
      }
    }
  ]
}

Pour en savoir plus sur les champs disponibles pour les requêtes, consultez la section Champs de la table productPerformanceView.