Performance reports

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

Métriques

Vous pouvez exécuter une requête pour 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 dans la plage de dates spécifiée :

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

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

L'exemple de réponse ci-dessous montre que le marchand a enregistré 4 440 clics au total, pour tous les produits et toutes les méthodes marketing, entre le 1er décembre 2023 et le 21 décembre 2023.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

Segments

Vous pouvez utiliser des champs de segment pour la segmentation dans les rapports sur les performances. Par exemple, l'interrogation de marketing_method génère un rapport comportant une ligne pour chaque méthode marketing, ainsi que les métriques que vous spécifiez pour cette méthode marketing dans la clause SELECT.

Les champs de segment peuvent être des attributs de produit (par exemple, offer_id, brand et category) ou des attributs d'événement (par exemple, date et marketing_method).

Les champs de segment se comportent de la même manière qu'une clause GROUP BY en SQL. Les champs de segment divisent 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, classés par ordre décroissant de clicks, dans la condition ajoutée d'une plage de dates. Seules les lignes où au moins une métrique demandée n'est pas nulle sont renvoyées.

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

L'exemple de réponse ci-dessous montre que le marchand a enregistré 1 546 clics pour tous les produits et toutes les méthodes marketing le 1er décembre 2023, et 829 clics pour tous les produits et toutes les méthodes marketing le 2 décembre 2023. Le marchand n'a enregistré aucun clic le 3 décembre 2023. Par conséquent, rien n'est renvoyé pour cette date.

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

Comme pour les rapports personnalisés de Merchant Center, vous pouvez spécifier plusieurs segments dans la même requête avec l'API Merchant Reports.

Voici un exemple de requête qui renvoie les clics de tous les produits de votre compte sur une période de 30 jours, segmentés par marketing_method et offer_id :

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

La réponse à cette requête inclut une ligne pour chaque combinaison de offer_id et marketing_method, avec le nombre de clics pour cette combinaison :

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

Catégories et types de produit

Le langage de requête Merchant Center accepte la segmentation des métriques en deux groupes d'attributs que vous pouvez définir pour organiser votre inventaire :

Niveaux de catégorie

Catégories issues de la taxonomie des produits de Google. Google peut attribuer automatiquement une catégorie à votre produit si vous n'en fournissez pas, ou affiner davantage la catégorie fournie.

Niveaux de type de produit

Types de produits que vous attribuez en fonction de votre catégorisation.

Contrairement aux niveaux de catégorie, il n'existe aucun ensemble prédéfini de valeurs acceptées.

Les attributs de catégorie et de type de produit sont organisés selon une hiérarchie à plusieurs niveaux. Les spécifications des données produit séparent chaque niveau par le caractère >, mais, dans les rapports, vous sélectionnez chaque niveau de la hiérarchie séparément.

Prenons l'exemple d'un produit avec les niveaux de type de produit suivants :

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Les rapports renvoient chaque niveau dans son propre champ :

Métriques de devises et de prix

Les métriques de prix, telles que conversion_value, sont représentées à l'aide du Price type. Si la métrique est disponible dans plusieurs devises, la valeur de chaque devise est renvoyée dans une ligne distincte. Par exemple, la requête suivante :

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

renvoie les résultats suivants :

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Si vous demandez à la fois des métriques de prix et des métriques hors prix dans une requête, les métriques de prix sont renvoyées dans des lignes de résultat distinctes des métriques hors prix, une ligne de résultat par code de devise. Par exemple, la requête suivante :

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

renvoie la réponse suivante :

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Tous les champs que vous sélectionnez sont renvoyés dans la réponse, même si leur valeur est toujours la valeur par défaut ou zéro.

Pour en savoir plus sur les champs disponibles pour la requête, consultez Champs du tableau productPerformanceView.