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 :
- Vue des performances Shopping
- Vue du groupe de produits
- Vue des groupes de produits d'un groupe de composants
- Produit Shopping
- Vue des ventes avec les données du panier (disponible dans la v24 et les versions ultérieures)
- Vue des composants d'extension d'URL finale (disponible pour les campagnes Shopping dans la version 26 et les versions ultérieures)
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 avecproduct_group_viewetasset_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_dateetmetrics.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_shareetmetrics.search_rank_lost_absolute_top_impression_share. - Disponible dans la version 24 et les versions ultérieures : le segment
segments.conversion_attribution_event_typeet les métriques des données du paniermetrics.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
SELECTcontient 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.statusdans la clauseWHEREpour 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,clicksetctr, et n'accepte passtatusniissues)
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 :
ad_groupad_group_adcampaigncart_data_sales_view(disponible dans la version 24 et les versions ultérieures)customer(agrégé pour toutes les campagnes)product_group_viewshopping_performance_viewshopping_product(pour les métriques de données du paniermetrics.all_*dans la v24 et les versions ultérieures)
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 :
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_marginmetrics.gross_profit_microsmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
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) :
metrics.all_average_cart_sizemetrics.all_average_order_value_microsmetrics.all_cost_of_goods_sold_microsmetrics.all_cross_sell_cost_of_goods_sold_microsmetrics.all_cross_sell_gross_profit_microsmetrics.all_cross_sell_revenue_microsmetrics.all_cross_sell_units_soldmetrics.all_gross_profit_marginmetrics.all_gross_profit_microsmetrics.all_lead_cost_of_goods_sold_microsmetrics.all_lead_gross_profit_microsmetrics.all_lead_revenue_microsmetrics.all_lead_units_soldmetrics.all_ordersmetrics.all_revenue_microsmetrics.all_units_sold
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_viewdoivent filtrer sur au moins l'un des éléments suivants :campaign.advertising_channel_type,campaign(campaign.id,campaign.resource_nameoufinal_url_expansion_asset_view.campaign) ouad_group(ad_group.id,ad_group.resource_nameoufinal_url_expansion_asset_view.ad_group). Si vous omettez tous ces éléments,FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTERest renvoyé. - Lorsque vous interrogez
final_url_expansion_asset_viewpour des campagnes Shopping au niveau du compte ou de la campagne, vous devez filtrer parcampaign.advertising_channel_type = 'SHOPPING'(ou par un seul groupe d'annonces à l'aide de=). Le filtrage par campagne (campaign.id,campaign.resource_nameoufinal_url_expansion_asset_view.campaign) nécessite égalementcampaign.advertising_channel_type = 'SHOPPING'. Si vous l'omettez, l'erreurFinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTERest renvoyée, tandis que le filtrage par un seulad_grouprépond à l'exigence de filtre. - Les filtres sur
campaign.advertising_channel_type,campaignouad_groupdoivent utiliser l'opérateur=sur une seule valeur. L'utilisation deINou de plusieurs conditions pour le même type de ressource renvoieFinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE. - Pour les campagnes Shopping, vous pouvez sélectionner des champs
ad_groupet filtrer les résultats en fonction de ces champs, mais vous ne pouvez pas sélectionner de champsasset_group. Si vous sélectionnez des champsasset_groupdans des campagnes Shopping (ou si vous filtrez parad_group), vous obtenezFinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP(ouCANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUPsi des champsad_groupsont également sélectionnés). Le filtrage parasset_grouplors de la sélection des champsad_grouprenvoieCANNOT_SELECT_AD_GROUP, et le filtrage parad_groupetasset_grouprenvoieCANNOT_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