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 afin d'obtenir des données sur les 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 product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

Vous devez spécifier les données que vous souhaitez 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, pour tous ses produits et toutes ses méthodes marketing, entre le 1er décembre 2023 et le 21 décembre 2023.

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

Important :Si vous ne sélectionnez aucun champ de segment dans votre requête, seule une ligne de métriques est renvoyée.

Segments

Vous pouvez utiliser les champs de segments pour la segmentation dans les rapports sur les performances. Par exemple, l'interrogation de marketing_method renvoie 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 segments 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 segments se comportent de la même manière qu'une clause GROUP BY en SQL. Les champs de segments 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 par 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 suivant montre que le marchand a enregistré 1 546 clics pour tous ses produits, pour toutes les méthodes marketing, le 1er décembre 2023 et 829 clics pour tous ses produits, pour toutes les méthodes marketing, le 2 décembre 2023. Le marchand n'a enregistré aucun clic le 3 décembre 2023. Aucun résultat n'est donc 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"
      }
    }
  ]
}

Important :Vous ne pouvez sélectionner des champs de segments spécifiques que si vous sélectionnez également des métriques. Si vous ne sélectionnez aucune métrique dans votre requête, l'API Merchant Reports renvoie une erreur.

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 de 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"
      }
    }
  ]
}

Attention :Étant donné qu'une nouvelle ligne est renvoyée pour chaque combinaison de champs de segments dans votre clause SELECT, le nombre total de lignes de votre réponse augmente de manière exponentielle avec chaque champ de segments supplémentaire.

Catégories et types de produits

Le langage de requête Merchant Center permet de segmenter les 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 classification des produits 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 propre 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 vous sélectionnez chaque niveau de la hiérarchie séparément dans les rapports.

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

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

Les rapports renverront chaque niveau dans son propre champ:

Segment	Valeur
product_type_l1	Home & Garden
product_type_l2	Kitchen & Dining
product_type_l3	Kitchen Appliances
product_type_l4	Refrigerators

Métriques de devises et de prix

Les métriques sur les prix, telles que conversion_value, sont représentées à l'aide du type Price. Si la métrique est disponible dans plusieurs devises, la valeur de chaque devise est renvoyée sur 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 sur les prix et des métriques hors prix dans une requête, les métriques sur les prix sont renvoyées sur des lignes de résultats distinctes des métriques hors prix, une ligne de résultats 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.