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_criterionad_groupcampaigncustomer
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_viewetgender_view. - Campagnes > Zones géographiques : renvoie des données équivalentes à
location_view.