Rapports

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

Les campagnes compatibles avec les produits disposent des rapports dédiés suivants:

• Vue "Performances Shopping"
• Vue par groupe de produits
• Affichage par groupe de produits du groupe de composants
• Produit Shopping

Remarque : "Vue des performances Shopping" et "Produit Shopping" peuvent tous deux renvoyer des métriques au niveau du produit. "Vue des performances Shopping" indique l'état "historique" d'un produit ayant diffusé des annonces, tandis que "Produit Shopping" indique 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 des performances Shopping

La vue des performances Shopping fournit des statistiques agrégées sur l'historique des rapports pour les produits par attributs tels que product_item_id.

La vue "Performances des achats" capture l'état du produit au moment où les métriques pertinentes ont été enregistrées. Cela inclut des segments tels que product_title, qui peuvent avoir changé 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 ayant enregistré des clics au cours des 30 derniers jours (triés par ordre décroissant par toutes les conversions, puis par conversions, puis par clics, puis par coût, puis par 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 du groupe de produits

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

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 des impressions au cours des 30 derniers jours (triés par ordre décroissant par toutes les conversions, puis par conversions, puis par clics, puis par 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 rapport pour les produits figurant dans les comptes Google Merchant Center associés au compte Google Ads. Ce rapport permet d'inspecter 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ées par ordre décroissant par toutes les conversions, puis par conversions, puis par clics, puis par 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 de création de 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 moins d'accès aux 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.
• Notez que les produits présentant un ou plusieurs problèmes génèrent plus de données. Vous pouvez filtrer par shopping_product.status dans WHERE pour identifier les produits susceptibles de renvoyer des problèmes ayant entraîné l'état approprié.

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 fournir des insights sur l'état des produits des 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 la diffusion d'annonces pour les produits.

Cette section présente certains cas d'utilisation courants, semblables à ceux possibles dans la vue Produits de l'interface utilisateur de Google Ads.

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

États des produits (niveau du compte)

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

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 d'afficher l'état du produit, par exemple NOT_ELIGIBLE, et une 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)

Spécifier le rapport avec une ressource de campagne dans la clause WHERE permet de renvoyer tous les produits inclus dans la campagne sélectionnée.

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. Il vous permet de vérifier l'état de chaque produit, y compris les problèmes qui en sont à l'origine. 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)

Spécifier le rapport avec à la fois une ressource de groupe d'annonces et une ressource de campagne dans la clause WHERE permet d'afficher tous les produits inclus dans la campagne sélectionnée. Les métriques, l'état et les problèmes du produit indiquent s'il est inclus ou exclu du groupe d'annonces sélectionné.

Cette requête vous permet de voir 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 vérifier 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 :Vous devez spécifier à la fois la campagne et le groupe d'annonces dans la clause WHERE. Si l'un d'eux n'est pas présent, l'une des erreurs suivantes s'affiche: MISSING_CAMPAIGN_FILTER et MISSING_AD_GROUP_FILTER.

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

Si vous spécifiez 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 (que les métriques 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 ainsi 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 à des métriques de vente et de bénéfice pertinentes, telles que 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 des conversions avec les données du panier dans leurs campagnes Shopping et 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 de données du panier suivantes 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 des données du panier ne sont pas disponibles tant que des conversions n'ont pas été enregistrées pour les produits associés. L'exécution des requêtes sur shopping_performance_view peut prendre plus de temps pour les comptes comportant un grand nombre de produits, même avec des filtres appliqués.

L'exemple suivant montre comment les métriques des données du panier peuvent être utilisées 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 des 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