Rapports

Comme pour les autres types d'annonces, vous pouvez utiliser GoogleAdsService.SearchStream pour récupérer l'état des produits et les données sur les performances des produits Shopping.

Les campagnes qui acceptent les produits disposent des rapports dédiés suivants :

• Vue "Performances Shopping"
• Vue "Groupe de produits"
• Vue "Groupe de composants" du groupe de produits
• Produit Shopping

Remarque : Les vues "Performances Shopping" et "Produit Shopping" peuvent renvoyer des métriques au niveau du produit. La vue "Performances Shopping" fournit l'état "historique" d'un produit ayant diffusé des annonces, tandis que "Produit Shopping" fournit l'état actuel d'un produit, qu'il ait diffusé des annonces ou non. Nous vous recommandons d'utiliser principalement "Produit Shopping" pour évaluer l'état d'un produit et les problèmes qui l'empêchent d'être utilisé par une campagne.

Vue "Performances Shopping"

La vue "Performances Shopping" fournit des statistiques historiques agrégées sur les produits par attributs tels que product_item_id.

La vue "Performances Shopping" capture l'état du produit au moment où les métriques pertinentes ont été enregistrées. Cela inclut les segments tels que product_title, qui ont pu changer depuis l'enregistrement de la métrique.

Voici un exemple de requête qui récupère les impressions, les clics, le coût, les conversions et toutes les conversions pour les produits par product_item_id avec des clics au cours des 30 derniers jours (triés par ordre décroissant selon toutes les conversions, puis les conversions, puis les clics, puis le coût, puis les impressions) :

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM  shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

Vue "Groupe de produits"

La vue "Groupes de produits" fournit des statistiques agrégées pour les groupes de fiches Shopping (appelés groupes de produits dans l'interface utilisateur). Consultez le guide sur les rapports Performance Max pour obtenir des exemples de la vue "Groupe de composants > Groupe de produits".

Voici un exemple de requête qui récupère les impressions, les clics, les conversions et toutes les conversions pour les groupes de fiches Shopping par campagne, avec les impressions des 30 derniers jours (triées par ordre décroissant selon toutes les conversions, puis les conversions, puis les clics, puis les impressions) :

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Produit Shopping

Le rapport Produit Shopping fournit les attributs et les statistiques de reporting pour les produits qui existent dans les comptes Google Merchant Center associés au compte Google Ads. Ce rapport permet d'examiner les statistiques au niveau du client, de la campagne et du groupe d'annonces.

Voici un exemple de requête qui récupère les impressions, les clics, les conversions et toutes les conversions pour les 30 derniers jours (triés par ordre décroissant selon toutes les conversions, puis les conversions, puis les clics, puis les impressions) pour tous les produits Shopping de tous les comptes Google Merchant Center associés :

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Pour en savoir plus sur les requêtes, consultez le guide sur les rapports.

Considérations sur les performances

Le rapport sur les produits Shopping peut renvoyer une quantité importante de données lorsqu'un compte est associé à un grand nombre de produits. Les recommandations suivantes peuvent vous aider à améliorer les performances de vos requêtes GAQL :

• Les requêtes au niveau de la campagne et du groupe d'annonces sont généralement plus rapides que celles au niveau du compte, car elles contiennent probablement moins de produits et nécessitent l'accès à moins de données.
• Plus la clause SELECT contient de champs et de métriques, plus le temps de réponse est long. Nous vous recommandons de ne sélectionner que les champs et les métriques dont vous avez besoin dans la requête.
• Sachez que les produits présentant un ou plusieurs problèmes renverront plus de données. Vous pouvez filtrer par shopping_product.status dans WHERE pour identifier les produits susceptibles de générer des problèmes qui ont entraîné l'état concerné.

Cas d'utilisation du rapport sur les produits Shopping

Le rapport Produit Shopping offre un accès flexible aux informations sur les produits pour les campagnes qui utilisent des flux de produits. Il peut vous donner des informations sur l'état des produits provenant de comptes Google Merchant Center, mais aussi des informations spécifiques aux annonces, telles que les métriques de performances et les problèmes qui empêchent les produits de diffuser des annonces.

Cette section couvre certains cas d'utilisation typiques semblables à ceux possibles dans la vue Produits de l'interface utilisateur Google Ads.

Le champ "Problèmes" pour les produits Shopping est semblable à celui fourni par productstatuses dans Content API for Shopping, avec des problèmes spécifiques à Google Ads. Pour savoir si le problème doit être résolu dans Google Merchant Center ou Google Ads, commencez par consulter le champ shopping_product.issues.documentation de la réponse, qui inclut un article du centre d'aide.

États des produits (au niveau du compte)

Si vous spécifiez le rapport sans filtres pour une campagne ou un groupe d'annonces, tous les produits au niveau du compte seront renvoyés.

Il est compatible avec les métriques, l'état et les problèmes de toutes les campagnes du compte de type :

• Shopping
• Performance Max

Cette requête vous permet de voir l'état du produit (par exemple, NOT_ELIGIBLE) et la liste des problèmes spécifiques au produit qui ont entraîné l'état donné :

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

États des produits (au niveau de la campagne)

Si vous spécifiez le rapport avec une ressource de campagne dans la clause WHERE, tous les produits inclus dans la campagne sélectionnée seront renvoyés.

Il est compatible avec les types de campagnes suivants qui peuvent utiliser des flux de produits :

• Shopping
• Performance Max
• Génération de la demande
• Vidéo

Cette requête vous permet de consulter l'état du produit inclus dans une campagne donnée. Elle vous permet de vérifier l'état de chaque produit, y compris les problèmes qui sont à l'origine de cet état. Par exemple, une campagne mise en veille affecte l'état du produit :

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"

États des produits (au niveau du groupe d'annonces)

Si vous spécifiez le rapport avec à la fois une ressource de groupe d'annonces et une ressource de campagne, et dans la clause WHERE, tous les produits inclus dans la campagne sélectionnée seront renvoyés. Les métriques, l'état et les problèmes du produit reflètent s'il est inclus ou exclu du groupe d'annonces sélectionné.

Cette requête vous permet de connaître l'état du produit par rapport à ce groupe d'annonces. Il vous permet de vérifier que les filtres de groupes de produits (au niveau du groupe d'annonces) sont appliqués correctement et de consulter l'état de chaque produit :

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"
  AND shopping_product.ad_group = "customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>"

Remarque : La campagne et le groupe d'annonces doivent être spécifiés dans la clause WHERE. Si l'un ou l'autre n'est pas présent, l'une des erreurs suivantes se produira : MISSING_CAMPAIGN_FILTER et MISSING_AD_GROUP_FILTER.

Métriques produit, filtrées par date (niveau compte)

Si vous spécifiez le rapport avec une date ou une plage de dates dans la clause WHERE, les métriques de tous les produits au niveau du compte seront renvoyées (qu'elles soient non nulles ou non) pour la période spécifiée.

Vous ne pouvez pas sélectionner segments.date, car cela entraînerait une erreur UNSUPPORTED_DATE_SEGMENTATION.

Cette requête vous permet de consulter les performances du produit actuel pour un jour donné ou une autre valeur de date compatible. Vous pouvez l'utiliser pour créer un récapitulatif pour chaque produit renvoyé, agrégé pour toutes les campagnes :

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date = '2024-01-01'

Performances des produits avec les données du panier

Les annonceurs marchands peuvent accéder aux métriques pertinentes sur les ventes et les bénéfices, comme les revenus, la marge brute, la marge bénéficiaire brute et les unités vendues. Ces métriques sont disponibles pour tous les annonceurs qui implémentent les conversions avec données du panier dans les campagnes Shopping. Elles sont compatibles avec les rapports suivants.

• ad_group
• ad_group_ad
• campaign
• customer (agrégé pour toutes les campagnes)
• product_group_view
• shopping_performance_view

Les métriques suivantes sur les données du panier peuvent être utilisées dans les rapports, comme shopping_performance_view, pour les campagnes Shopping.

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

Remarque : Les métriques sur les données du panier ne sont disponibles qu'une fois les conversions enregistrées pour les produits associés. Les requêtes sur shopping_performance_view peuvent prendre plus de temps à s'exécuter pour les comptes comportant un grand nombre de produits, même si des filtres sont appliqués.

L'exemple suivant montre comment utiliser les métriques de données du panier pour analyser les performances au niveau des produits pour les campagnes Shopping au cours des 30 derniers jours.

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

Performances des campagnes avec les données du panier

Les métriques sur les données du panier peuvent être utilisées au niveau de la campagne et combinées à d'autres métriques de performances telles que les impressions, les clics et le coût.

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC