Reporting

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

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

Affichage des performances Shopping

La vue des performances Shopping fournit l'historique des statistiques de rapports agrégées pour les produits, en fonction d'attributs tels que product_item_id.

La vue des performances Shopping 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 des produits par product_item_id avec des clics enregistrés au cours des 30 derniers jours (triées par ordre décroissant du nombre total de conversions, puis des conversions, puis des clics, puis du coût, puis des 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 du groupe 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 vue de groupe de produits au niveau des groupes d'assets.

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 ayant enregistré des impressions au cours des 30 derniers jours (triées par ordre décroissant du nombre total de conversions, puis des conversions, puis des clics, puis des 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

Shopping – Produit

Le rapport Produit Shopping fournit les attributs et les statistiques des produits qui existent dans les comptes Google Merchant Center associés au compte Google Ads. Ce rapport peut être utilisé pour examiner les statistiques au niveau d'un client, d'une campagne et d'un groupe d'annonces.

Voici un exemple de requête qui récupère les impressions, les clics, les conversions et toutes les conversions des 30 derniers jours (classées par ordre décroissant en fonction du nombre de conversions, puis des conversions, puis des clics, puis des 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 sont susceptibles de contenir moins de produits et de nécessiter un accès à moins de données.
  • Plus il y a de champs et de métriques dans la clause SELECT, plus le temps de réponse est lent. Nous vous recommandons de ne sélectionner que les champs et les métriques dont vous avez besoin dans la requête.
  • N'oubliez pas 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 renvoyer des problèmes à l'origine de 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 utilisant des flux de produits. Elle peut vous fournir des insights sur l'état des produits dans les comptes Google Merchant Center, mais aussi sur les annonces spécifiques, comme les métriques de performances et les problèmes qui empêchent la diffusion d'annonces pour des produits.

Cette section présente quelques cas d'utilisation types semblables à ceux que vous pouvez trouver 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, à l'exception des problèmes propres à Google Ads. Pour vérifier si le problème doit être résolu dans Google Merchant Center ou Google Ads, consultez d'abord le champ shopping_product.issues.documentation de la réponse. Il contient un article du centre d'aide pour vous aider.

États des produits (au niveau du compte)

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

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 consulter l'état du produit (par exemple, NOT_ELIGIBLE) et la liste des problèmes spécifiques à ce produit:

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 le cadre de la clause WHERE, tous les produits inclus dans la campagne sélectionnée seront renvoyés.

Elle 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 à l'origine de cet état. Par exemple, une campagne mise en veille aura une incidence sur 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, vous obtiendrez 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 consulter 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 correctement appliqués 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>"

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

Si vous spécifiez le rapport avec une date ou une plage de dates dans la clause WHERE, vous obtiendrez des métriques pour tous les produits au niveau du compte qui sont (que les métriques soient différentes de zéro ou non) pour la période spécifiée.

Vous ne pouvez pas sélectionner segments.date. 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. Cela permet de créer un résumé agrégé pour chaque produit renvoyé, sur l'ensemble des 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 du secteur du commerce peuvent accéder à des métriques pertinentes sur les ventes et les bénéfices, telles que le revenu, le bénéfice brut, 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 les données du panier dans leurs campagnes Shopping. Elles sont compatibles avec les rapports suivants.

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

L'exemple suivant montre comment utiliser les métriques des données du panier pour analyser les performances au niveau des produits dans 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 être combinées avec 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