Métriques des 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. Cela permet aux clients de l'API Google Ads de demander ad_group_criterion ou campaign_criterion champs et la ressource *_view dans la même requête à la GoogleAdsService.SearchStream méthode.

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 certains champs metrics dans la clause SELECT pour récupérer les métriques de mots clés.

Vous pouvez sélectionner des champs à partir des ressources parentes jusqu'à customer à partir d'une vue de critères. Par exemple, lorsque vous sélectionnez FROM la 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 qui peuvent être demandées de cette manière pour une ressource donnée, consultez la ligne Ressources d'attribut de sa page de référence. Par exemple, pour keyword_view, vous pouvez trouver ses ressources sur sa page de référence.

Mappage avec l'interface utilisateur

Chaque rapport sur les critères correspond à une vue spécifique dans l'interface utilisateur Google Ads. Le mappage de ces éléments peut vous aider à rapprocher les données de l'API de ce que vous voyez dans l'interface. Pour obtenir une liste plus complète des mappages, consultez Rapports dans l'interface utilisateur.

Voici quelques rapports courants basés sur des critères et leurs emplacements habituels 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.