Segmentation

Vous pouvez utiliser des champs de segmentation pour la segmentation dans les rapports sur les performances. Par exemple, l'interrogation de marketingMethod renvoie un rapport contenant une ligne pour chaque méthode marketing, ainsi que les metrics que vous spécifiez pour cette méthode marketing dans la clause SELECT.

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 pour tous les produits de votre compte sur une période de 30 jours, segmentés par marketingMethod et offerId:

SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

La réponse à cette requête inclut une ligne pour chaque combinaison de offerId et marketingMethod, 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 dans votre réponse augmente de manière exponentielle à chaque champ de segment supplémentaire.

Catégorie et type 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 classification des produits Google. Google peut attribuer automatiquement la catégorie à votre produit si vous n'en fournissez pas, ou affiner 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 pas d'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. La spécification du produit sépare chaque niveau avec 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 renvoient 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 sur les devises et les prix

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

SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-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 d'autres métriques dans une requête, celles-ci sont renvoyées dans des lignes de résultats distinctes de celles qui ne sont pas liées aux prix, à raison d'une ligne de résultat par code de devise. Par exemple, la requête suivante :

SELECT conversions, conversionValue
FROM ProductPerformanceView
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 égale à zéro.