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 qui correspond à 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 de l'API Google Ads de demander les champs ad_group_criterion ou campaign_criterion et la ressource *_view dans la même requête à la méthode GoogleAdsService.SearchStream.

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 de mots clés.

Vous pouvez sélectionner des champs à partir de ressources parentes jusqu'à customer dans une vue de critères. Par exemple, lorsque vous sélectionnez FROM 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 attribuées 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 à l'UI

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

Voici quelques exemples de rapports basés sur des critères et leurs emplacements habituels dans l'UI :

• 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.