Rapports sur les produits pour les annonces Shopping

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 qui acceptent les produits d'un flux Google Merchant Center disposent des rapports dédiés suivants :

De plus, à partir de la v26, pour les campagnes Shopping, final_url_expansion_asset_view indique les composants de personnalisation du texte diffusés lorsque AI Max (campaign.ai_max_setting.enable_ai_max = true) et l'extension de l'URL finale (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) sont activés. Pour connaître les exigences concernant les requêtes et voir un exemple, consultez la section Vue des composants d'extension de l'URL finale.

Vue "Performances Shopping"

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

Il est compatible avec tous les types de campagnes qui utilisent des flux de produits Google Merchant Center, y compris les campagnes Shopping, Performance Max, Demand Gen, vidéo, pour applications et display.

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 ont peut-être changé depuis l'enregistrement de la métrique.

shopping_performance_view est également compatible avec les segments et métriques suivants :

  • segments.ad_sub_network_type (également compatible avec product_group_view et asset_group_product_group_view).
  • Métriques segmentées par date de conversion : metrics.conversions_by_conversion_date, metrics.all_conversions_by_conversion_date, metrics.conversions_value_by_conversion_date, metrics.all_conversions_value_by_conversion_date, metrics.value_per_conversions_by_conversion_date et metrics.value_per_all_conversions_by_conversion_date.
  • Métriques de taux d'impressions des concurrents : metrics.search_budget_lost_impression_share, metrics.search_rank_lost_impression_share, metrics.search_budget_lost_absolute_top_impression_share et metrics.search_rank_lost_absolute_top_impression_share.
  • Disponible dans la version 24 et les versions ultérieures : le segment segments.conversion_attribution_event_type et les métriques des données du panier metrics.all_* (qui indiquent les données du panier pour toutes les conversions, y compris les conversions non enchérissables).

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

Logique d'attribution pour les rapports sur les produits

Les rapports au niveau du produit utilisent un framework d'attribution spécifique pour attribuer les performances à des produits individuels lorsque plusieurs produits apparaissent dans une même annonce.

Métriques financières

Les métriques financières, telles que metrics.cost_micros et metrics.conversions, sont calculées de manière à ce que leur somme pour tous les produits ne dépasse pas les rapports au niveau de la campagne.

Interactions directes
Lorsque l'intention utilisateur est claire et liée à un seul produit (par exemple, un clic direct sur un produit), 100 % du coût et du crédit de la conversion associés sont attribués à ce produit spécifique.
Interactions indirectes
Lorsque l'intention utilisateur est dirigée vers l'annonce dans son ensemble (par exemple, si l'utilisateur clique sur un titre, un bouton d'incitation à l'action ou une vidéo), le coût et le crédit de la conversion associés sont répartis de manière uniforme entre tous les produits diffusés dans cette annonce.

Métriques d'interaction

Les métriques d'interaction, telles que metrics.impressions et metrics.clicks, mesurent l'engagement spécifique au produit.

Pour les impressions, le nombre est incrémenté pour chaque produit inclus dans l'annonce lorsque l'événement se produit, que le produit soit visible ou non dans la fenêtre d'affichage de l'utilisateur. Par conséquent, la somme des impressions pour tous les produits d'un rapport peut être nettement supérieure aux totaux correspondants au niveau de la campagne.

À l'inverse, metrics.clicks ne mesure que les clics effectués sur ce produit spécifique. Dans l'UI Google Ads, le champ metrics.clicks est explicitement libellé Clics sur un produit.

Vue du groupe de produits

La vue "Groupe de produits" fournit des statistiques de reporting agrégées pour les groupes de fiches produit Shopping (appelés groupes de produits dans l'interface utilisateur). Consultez le guide sur les rapports Performance Max pour obtenir des exemples de vue des groupes de produits des groupes 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 ayant enregistré 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

Rapport "Produits Shopping"

Le rapport Shopping Product fournit les attributs et les statistiques de reporting pour les produits existant 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. Il est compatible avec les campagnes Shopping, Performance Max, Demand Gen, vidéo et pour applications (dans la version 24 et les versions ultérieures). Vous pouvez également interroger shopping_product.product_image_uri pour récupérer l'URI de l'image du produit fournie par le marchand.

Voici un exemple de requête qui récupère les impressions, les clics, les conversions et toutes les conversions des 30 derniers jours (triés par ordre décroissant de toutes les 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 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. Sélectionnez uniquement les champs et les métriques dont vous avez besoin dans la requête.
  • Les produits présentant un ou plusieurs problèmes renvoient plus de données. Vous pouvez filtrer par shopping_product.status dans la clause WHERE pour identifier les produits susceptibles de renvoyer des problèmes à l'origine de l'état concerné.

Cas d'utilisation courants du rapport sur les produits Shopping

Le rapport Produit Shopping offre un accès flexible aux informations produit 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, ainsi que des informations spécifiques aux annonces, telles que des métriques de performances et les problèmes qui empêchent la diffusion d'annonces pour les produits.

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

Le champ issues pour shopping_product est semblable à ProductStatus dans Merchant API, 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, consultez 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 sont renvoyés au niveau du compte.

Il accepte 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, ainsi qu'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)

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 sont renvoyés.

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

  • Shopping
  • Performance Max
  • Demand Gen
  • Vidéo
  • Appli (disponible dans la v24 et les versions ultérieures)

Cette requête vous permet de voir l'état de chaque produit inclus dans une campagne donnée, y compris les problèmes à 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 dans la clause WHERE, tous les produits inclus dans la campagne sélectionnée sont renvoyés. Les métriques, l'état et les problèmes du produit indiquent s'il est inclus ou exclu du groupe d'annonces sélectionné.

Il est compatible avec les types de campagnes suivants :

  • Shopping
  • Demand Gen
  • Vidéo
  • Application (disponible dans la version 24 et les versions ultérieures ; n'accepte que les métriques impressions, clicks et ctr, et n'accepte pas status ni issues)

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 correctement appliqués 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>'

Métriques sur les produits, filtrées par date (niveau du compte)

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

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

Cette requête vous permet de voir les performances de chaque produit pour un jour donné ou une autre plage de dates compatible, agrégées 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 DURING LAST_30_DAYS

Performances des produits avec les données du panier

Les annonceurs marchands peuvent accéder à des 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 les données du panier dans leurs campagnes Shopping. Elles sont compatibles avec les rapports suivants :

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

Dans la version 24 et les versions ultérieures, les métriques de données du panier suivantes sont également disponibles pour les rapports sur toutes les conversions (y compris les conversions non enchérissables) :

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

Vue des composants avec extension de l'URL finale

À partir de la version 26, vous pouvez utiliser final_url_expansion_asset_view pour mesurer les performances au niveau des composants pour les composants d'adaptation du texte diffusés dans les campagnes Shopping lorsque AI Max (campaign.ai_max_setting.enable_ai_max = true) et l'extension d'URL finale (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) sont activés.

Lorsque vous interrogez final_url_expansion_asset_view, suivez ces règles de filtrage et de sélection de champs :

  • Les requêtes sur final_url_expansion_asset_view doivent filtrer sur au moins l'un des éléments suivants : campaign.advertising_channel_type, campaign (campaign.id, campaign.resource_name ou final_url_expansion_asset_view.campaign) ou ad_group (ad_group.id, ad_group.resource_name ou final_url_expansion_asset_view.ad_group). Si vous omettez tous ces éléments, FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER est renvoyé.
  • Lorsque vous interrogez final_url_expansion_asset_view pour des campagnes Shopping au niveau du compte ou de la campagne, vous devez filtrer par campaign.advertising_channel_type = 'SHOPPING' (ou par un seul groupe d'annonces à l'aide de =). Le filtrage par campagne (campaign.id, campaign.resource_name ou final_url_expansion_asset_view.campaign) nécessite également campaign.advertising_channel_type = 'SHOPPING'. Si vous l'omettez, l'erreur FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER est renvoyée, tandis que le filtrage par un seul ad_group répond à l'exigence de filtre.
  • Les filtres sur campaign.advertising_channel_type, campaign ou ad_group doivent utiliser l'opérateur = sur une seule valeur. L'utilisation de IN ou de plusieurs conditions pour le même type de ressource renvoie FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE.
  • Pour les campagnes Shopping, vous pouvez sélectionner des champs ad_group et filtrer les résultats en fonction de ces champs, mais vous ne pouvez pas sélectionner de champs asset_group. Si vous sélectionnez des champs asset_group dans des campagnes Shopping (ou si vous filtrez par ad_group), vous obtenez FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP (ou CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP si des champs ad_group sont également sélectionnés). Le filtrage par asset_group lors de la sélection des champs ad_group renvoie CANNOT_SELECT_AD_GROUP, et le filtrage par ad_group et asset_group renvoie CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP.

La requête suivante récupère les métriques de performances au niveau des composants pour les campagnes Shopping au cours des 30 derniers jours :

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  final_url_expansion_asset_view.asset,
  final_url_expansion_asset_view.field_type,
  final_url_expansion_asset_view.final_url,
  final_url_expansion_asset_view.status,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions
FROM final_url_expansion_asset_view
WHERE
  campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS