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 que vous souhaitez obtenir. Vous devez ajouter un filtre sur la plage de dates pour interroger les rapports pour 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é un total de 4 440 de clics, pour tous les produits et 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 le MCQL pour interroger des champs de segments. Les champs "Segments" peuvent être attributs de produit (par exemple, offerId, brand et category) ou événement (par exemple, date et marketingMethod).

Les champs de segments se comportent de la même manière que GROUP BY en SQL. Les champs "Segments" divisent les les métriques sélectionnées, en regroupant les données par chaque segment dans la clause SELECT.

Voici un exemple de requête qui renvoie le nombre de clics par jour, dans l'ordre décroissant clicks, dans la condition ajoutée d'une plage de dates. Uniquement les lignes dont 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 sur tous les produits, quelle que soit la méthode marketing, le 1er décembre 2020 et 829 de clics sur tous les produits et toutes les méthodes marketing, le 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"
      }
    }
  ]
}