Performance reports

L'API Merchant Center propose des rapports sur les performances, par exemple ProductPerformanceView. Cette page explique la structure des rapports sur les performances.

Métriques

Vous pouvez interroger les métriques (par exemple, clicks et impressions) que vous souhaitez obtenir. Vous devez ajouter un filtre sur la plage de dates pour interroger le service Reports sur les données de performances.

Voici un exemple de requête qui renvoie une seule ligne, avec le nombre total de clics au cours de la période spécifiée:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

Vous devez spécifier les données à renvoyer. Les caractères génériques (par exemple, SELECT *) renvoient une erreur.

L'exemple de réponse suivant montre que le marchand a enregistré 4 440 clics au total, tous produits confondus, avec toutes les méthodes marketing, entre le 1er décembre 2020 et le 21 décembre 2020.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Segments

Vous pouvez utiliser la MCQL pour rechercher des champs de segments. Les champs de segments peuvent être des attributs de produit (par exemple, offerId, brand et category) ou des attributs d'événement (par exemple, date et marketingMethod).

Les champs de segments se comportent de la même manière qu'une GROUP BY en SQL. Les champs de segments répartissent les métriques sélectionnées en les regroupant par segment dans la clause SELECT.

Voici un exemple de requête qui renvoie les clics par jour, par ordre décroissant de clicks, dans la condition ajoutée d'une plage de dates. Seules les lignes dans lesquelles au moins une métrique demandée n'est pas nulle sont renvoyées.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

L'exemple de réponse suivant montre que le marchand a enregistré 1 546 clics pour tous les produits et toutes méthodes marketing le 1er décembre 2020, et 829 clics pour tous les produits et toutes méthodes marketing au 2 décembre 2020. Le marchand n'a enregistré aucun clic le 3 décembre 2020. Aucun résultat n'est donc renvoyé pour cette date.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}