Segmentation

La segmentation, disponible dans les rapports personnalisés de Merchant Center, peut être implémentée dans l'API Reporting en ajoutant le champ approprié à une requête. Par exemple, l'interrogation de segments.program génère un rapport comportant une ligne pour chaque programme (annonces Shopping, fiches produit sans frais, etc.). Celle-ci inclut les métriques (impressions, clics, etc.) pour ce programme, comme spécifié 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 Reporting.

L'exemple de requête suivant récupère les clics de tous les produits de votre compte sur une période de 30 jours, segmentés par program et offer_id:

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Exécution

Cliquez sur Run (Exécuter) pour essayer l'exemple dans API Explorer. Après avoir cliqué sur Run (Exécuter), remplacez l'espace réservé de l'ID du marchand par votre propre ID dans l'URL de la requête. Vous pouvez modifier la requête. La requête complète doit rester sur une seule ligne pour fonctionner avec l'explorateur d'API.

L'envoi de cette requête à reports.search génère une ligne spécifiant les clics pour chaque combinaison de offer_id et program, comme dans cet exemple de chaîne JSON:

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

Catégories et types de produits

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 (segments.category_l1, segments.category_l2, etc.)
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 (segments.product_type_l1, segments.product_type_l2, etc.)
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, comme ceci:

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

Métriques de devises et de prix

Le champ segments.currency_code d'une ligne de rapport ReportRow indique la devise dans laquelle les métriques de prix telles que metrics.conversion_value_micros sont renvoyées. La ReportRow renvoyée inclut automatiquement segments.currency_code lorsque vous sélectionnez l'une des métriques de prix ci-dessous, car c'est important pour les interpréter correctement.

  • metrics.conversion_value_micros
  • metrics.aov_micros
  • metrics.ordered_item_sales_micros
  • metrics.returns_micros
  • metrics.shipped_item_sales_micros

Métriques Acheter sur Google

Le langage de requête Merchant Center accepte deux catégories de métriques pour les commandes Acheter sur Google: les métriques au niveau des articles et les métriques au niveau des commandes.

métriques au niveau des articles

Métriques calculées sur la base des articles inclus dans les commandes et associées aux dimensions des articles de chaque commande.

  • metrics.item_days_to_ship
  • metrics.item_fill_rate
  • metrics.ordered_items
  • metrics.ordered_item_sales_micros
  • metrics.rejected_items
  • metrics.returned_items
  • metrics.return_rate
  • metrics.returns_micros
  • metrics.shipped_items
  • metrics.shipped_item_sales_micros
  • metrics.unshipped_items
métriques au niveau des commandes

Métriques calculées sur la base des commandes.

  • metrics.aos
  • metrics.aov_micros
  • metrics.days_to_ship
  • metrics.orders
  • metrics.shipped_orders
  • metrics.unshipped_orders

Les métriques au niveau des commandes ne sont pas associées aux dimensions des articles de chaque commande.

Vous pouvez sélectionner des métriques au niveau des articles en combinaison avec n'importe quel segment disponible. Toutefois, vous ne pouvez pas sélectionner des métriques au niveau des commandes en combinaison avec les segments de dimensions de produit suivants:

  • segments.brand
  • segments.category_l1, segments.category_l2, segments.category_l3, segments.category_l4, segments.category_l5
  • segments.custom_label1, segments.custom_label2, segments.custom_label3, segments.custom_label4, segments.custom_label5
  • segments.offer_id
  • segments.product_type_l1, segments.product_type_l2, segments.product_type_l3, segments.product_type_l4, segments.product_type_l5
  • segments.title

En savoir plus

Pour obtenir la liste complète des segments, consultez la documentation.