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 leurs performances pour les produits Shopping.
Les campagnes qui acceptent les produits d'un flux Google Merchant Center disposent des rapports dédiés suivants :
- Vue "Performances Shopping"
- Vue Groupe de produits
- Vue "Groupe de composants" et "Groupe de produits"
- Produit Shopping
- Vue "Ventes avec données du panier" (disponible dans la version 24 et ultérieure)
Vue "Performances Shopping"
La vue "Performances Shopping" fournit des statistiques agrégées sur l'historique des rapports pour les produits, par attributs tels que product_item_id.
Elle 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 "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 sur le 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 ultérieure : le segment
segments.conversion_attribution_event_typeet lesmetrics.all_*métriques sur les données du panier (qui indiquent les données du panier pour toutes les conversions, y compris celles non enchérissables).
Voici un exemple de requête qui récupère les impressions, les clics, les coûts, 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 les coûts, 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
Logique d'attribution pour les rapports sur les produits
Les rapports au niveau des produits 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 pour s'assurer 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 directement sur un produit), 100% des coûts 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 à un 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 ait été 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 qui ont eu lieu sur ce produit spécifique. Dans l'UI Google Ads, le champ metrics.clicks est explicitement libellé Clics sur le produit.
Vue "Groupe de produits"
La vue "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 la vue "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 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
Rapport sur les produits 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. Il est compatible avec les campagnes Shopping, Performance Max, Demand Gen, vidéo et (dans la version 24 et ultérieure) pour applications. 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 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 "Produit Shopping" peut renvoyer une grande quantité 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 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. Ne sélectionnez que 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 générer des problèmes ayant entraîné l'état concerné.
Cas d'utilisation courants du rapport "Produit Shopping"
Le rapport Produit Shopping permet d'accéder de manière flexible aux informations produit 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, ainsi que 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 types 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 en plus les 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 sont 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 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
- Application (disponible dans la version 24 et les versions ultérieures)
Cette requête vous permet de consulter l'état de chaque produit inclus dans une campagne donnée, 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 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é.
Elle est compatible avec les types de campagnes suivants :
- Shopping
- Demand Gen
- Vidéo
- Application (disponible dans la version 24 et ultérieure ; compatible uniquement avec les métriques
impressions,clicksetctr, et non avecstatusniissues)
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>'
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 sont renvoyées pour la période spécifiée, qu'elles soient ou non différentes de zéro.
Vous ne pouvez pas sélectionner segments.date, car cela génère une erreur UNSUPPORTED_DATE_SEGMENTATION.
Cette requête vous permet d'afficher les performances de chaque produit pour un jour donné ou une autre période 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 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 les données du panier dans les 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 version 24 et ultérieures)
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_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 générer des 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 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 données du panier peuvent être utilisées au niveau de la campagne et peuvent être combinées avec d'autres métriques de performance 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