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 les performances des produits Shopping.
Les campagnes compatibles avec les produits disposent des rapports dédiés suivants :
- Vue des performances Shopping
- Vue des groupes de produits
- Vue des groupes de produits des groupes de composants
- Produit Shopping
Vue des performances Shopping
La vue Performances Shopping fournit
des statistiques agrégées sur les rapports historiques pour les produits par 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 le product_title, qui a peut-être 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 avec des clics au cours des 30 derniers jours (triés par ordre décroissant en fonction de toutes les 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.search_budget_lost_impression_share,
metrics.search_rank_lost_impression_share,
metrics.search_budget_lost_absolute_top_impression_share,
metrics.search_rank_lost_absolute_top_impression_share,
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 des groupes de produits
La vue Groupes de produits fournit des statistiques agrégées sur les groupes de fiches Shopping (appelés groupes de produits dans l'interface utilisateur). Pour obtenir des exemples de vue des groupes de produits des groupes de composants, consultez le guide sur les rapports Performance Max.
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 en fonction de toutes les 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
Produit Shopping
Le rapport sur les produits Shopping fournit les attributs et les statistiques de rapports pour les produits qui existent dans les comptes Google Merchant Center associés au compte Google Ads. Ce rapport peut être utilisé pour 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 au cours des 30 derniers jours (triés par ordre décroissant en fonction 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 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. Nous vous recommandons de ne sélectionner que les champs et les métriques dont vous avez besoin dans la requête. - Tenez compte du fait que les produits présentant un ou plusieurs problèmes renverront plus de données. Vous pouvez filtrer par
shopping_product.statusdans la clauseWHEREpour comprendre quels produits sont susceptibles de renvoyer des problèmes qui ont entraîné l'état concerné.
Cas d'utilisation du rapport sur les produits Shopping
Le rapport sur les produits Shopping offre un accès flexible aux informations produit pour les campagnes qui utilisent des flux de produits. Il peut vous donner 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 sur les performances et les problèmes qui empêchent les produits de diffuser des annonces.
Cette section couvre certains cas d'utilisation typiques semblables à ceux possibles dans la "Produits" vue de l'interface utilisateur Google Ads.
Le champ "issues" (problèmes) pour les produits Shopping est semblable à celui fourni par
productstatuses
dans Content API for Shopping, avec en plus les problèmes spécifiques à
Google Ads. Pour vérifier 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 la campagne ou le groupe d'annonces, tous les produits au niveau du compte seront renvoyés.
Il est compatible avec les métriques, l'état et les problèmes de tous les types de campagnes du compte :
- Shopping
- Performance Max
Cette requête vous permet de voir l'état du produit, par exemple NOT_ELIGIBLE, et une liste de 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 seront renvoyés.
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 voir 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 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)
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 seront 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é.
Cette requête vous permet de voir l'état du produit par rapport à ce groupe d'annonces. Elle vous permet de vérifier que les filtres de groupe 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>"
Métriques sur les produits, filtrées par date (au niveau du compte)
Si vous spécifiez le rapport avec une date ou une période dans la clause WHERE, les métriques de tous les produits au niveau du compte (que les métriques soient différentes de zéro ou non) pour la période spécifiée seront renvoyées.
Vous ne pouvez pas sélectionner segments.date. Cela entraînerait une erreur UNSUPPORTED_DATE_SEGMENTATION.
Cette requête vous permet de voir les performances du produit actuel pour un jour donné ou une autre valeur de date compatible. Vous pouvez l'utiliser pour créer un récapitulatif pour chaque produit renvoyé, agrégé sur 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 du secteur de la vente au détail peuvent accéder aux métriques pertinentes sur les ventes et les bénéfices, telles que les revenus, les bénéfices bruts, la marge brute et les unités vendues. Ces métriques sont disponibles pour tous les annonceurs qui mettent en œuvre les conversions avec les données du panier dans les campagnes Shopping et sont compatibles avec les rapports suivants.
ad_groupad_group_adcampaigncart_data_sales_viewcustomer(agrégé pour toutes les campagnes)product_group_viewshopping_performance_view
Les métriques suivantes sur les données du panier peuvent être utilisées dans les rapports, tels que les
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
L'exemple suivant montre comment les métriques sur les 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 sur les données du panier peuvent être utilisées au niveau de la campagne et peuvent être combinées avec d'autres métriques sur les 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