Métriques de critères

Dans l'API Google Ads, chaque rapport sur les critères est représenté par une ressource distincte. Sauf indication contraire, les ressources *_view ne contiennent qu'un champ resource_name.

Les clients de l'API Google Ads doivent spécifier les champs ad_group_criterion ou campaign_criterion correspondants si des données spécifiques aux critères doivent être récupérées. Chaque vue est associée à la ressource de critère correspondant à son niveau de ciblage (par exemple, keyword_view est associé à ad_group_criterion, tandis que location_view est associé à campaign_criterion). Cela permet aux clients API Google Ads de demander des champs ad_group_criterion ou campaign_criterion et la ressource *_view dans la même requête adressée à la méthode GoogleAdsService.SearchStream.

Remarque : Les ressources de critères *_view reflètent les métriques de performances. Les critères n'ayant enregistré aucune impression au cours de la période spécifiée, ainsi que les critères négatifs (comme les mots clés à exclure ou les zones géographiques exclues), ne génèrent pas de métriques et sont exclus de ces vues.

Exemple de requête

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

Pour récupérer les données sur les performances (métriques) d'un type de critère spécifique, spécifiez la ressource de vue correspondante dans la clause FROM. Par exemple, utilisez keyword_view dans la clause FROM et les champs metrics dans la clause SELECT pour récupérer les métriques des mots clés.

Vous pouvez sélectionner des champs de ressources parentes jusqu'à customer à partir d'une vue de critères. Par exemple, lorsque vous sélectionnez FROM comme keyword_view, vous pouvez demander des champs à partir de toutes les ressources suivantes :

• ad_group_criterion
• ad_group
• campaign
• customer

Pour découvrir les ressources pouvant être demandées de cette manière pour une ressource donnée, consultez la ligne Ressources attribuées de sa page de référence. Par exemple, pour keyword_view, vous trouverez ses ressources sur sa page de référence.

Mappage à l'interface utilisateur

Chaque rapport sur les critères correspond à une vue spécifique dans l'interface utilisateur Google Ads. En les mappant, vous pourrez rapprocher les données de l'API de celles que vous voyez dans l'interface. Pour obtenir une liste plus complète des mappages, consultez Rapports dans l'UI.

Voici quelques rapports basés sur des critères courants et leurs emplacements types dans l'interface utilisateur :

• Campagnes > Audiences, mots clés et contenu > Mots clés pour le Réseau de Recherche : renvoie des données équivalentes à keyword_view.
• Campagnes > Audiences, mots clés et contenu > Audiences > Données démographiques : renvoie des données équivalentes à age_range_view et gender_view.
• Campagnes > Zones géographiques : renvoie des données équivalentes à location_view.