Dans l'API Google Ads, chaque rapport sur les critères est représenté par une ressource distincte.
Sauf si cela est nécessaire, 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 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 de performances (métriques) pour 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.
Dans une vue de critères, vous pouvez sélectionner des champs à partir de ressources parentes jusqu'à customer
. Par exemple, lorsque vous sélectionnez FROM
, vous pouvez demander des champs à partir de toutes les ressources suivantes :keyword_view
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'attributs de sa page de référence. Par exemple, pour keyword_view
, vous pouvez trouver ses ressources sur sa page de référence.