Ce guide explique pourquoi des lignes avec des métriques nulles apparaissent dans les rapports de l'API Google Ads et comment les exclure ou les gérer dans vos requêtes.
Métriques nulles dans les résultats de recherche
Lorsque vous exécutez une requête, vous pouvez rencontrer des métriques nulles pour les entités. Les raisons peuvent être multiples :
- Les entités ne peuvent pas être affichées.
- Elles ont été mises en veille pendant la période du rapport.
Avec les résultats de requête, vous souhaitez souvent obtenir des informations sur les performances de vos campagnes. Dans ce contexte, les métriques nulles peuvent ne pas être souhaitables. Pour générer un rapport plus utile, vous pouvez exclure explicitement les métriques nulles.
Exclure les métriques nulles avec un prédicat
Un prédicat est une expression qui prend la valeur TRUE, FALSE ou UNKNOWN.
Les prédicats sont utilisés dans la condition de recherche des clauses WHERE du langage de requête Google Ads.
La requête suivante montre comment supprimer explicitement les métriques nulles à l'aide d'un prédicat :
SELECT
campaign.id,
metrics.impressions
FROM campaign
WHERE metrics.impressions > 0
Exclure les métriques nulles en segmentant
Les métriques nulles sont toujours exclues lors de la segmentation d'un rapport, à condition que toutes les métriques sélectionnées soient nulles (voir Lignes renvoyées avec des métriques nulles).
Pour segmenter un rapport, vous devez inclure un champ segments dans la clause SELECT de la requête de recherche (filtrer sur un segment de date principal dans WHERE sans le sélectionner dans SELECT ne segmente pas le rapport). Par exemple, si vous segmentez un rapport par segments.date, les métriques sont ventilées avec une ligne pour chaque date. Les dates sans métriques ne sont pas incluses dans ce type de rapport.
Pour la requête suivante, le rapport n'inclura pas les lignes avec des métriques nulles :
SELECT
campaign.name,
metrics.impressions,
segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Lignes renvoyées avec des métriques nulles
Les lignes dont les métriques sélectionnées sont toutes nulles ne seront pas renvoyées lors de la segmentation. Prenons par exemple la requête suivante qui sélectionne metrics.impressions, metrics.clicks et metrics.conversions :
SELECT
ad_group_criterion.criterion_id,
metrics.impressions,
metrics.clicks,
metrics.conversions,
segments.date
FROM keyword_view
WHERE segments.date BETWEEN '2026-01-01' AND '2026-01-31'
Le rapport obtenu ne contiendra aucune ligne dans laquelle les trois métriques sélectionnées sont nulles, mais il renverra les lignes dans lesquelles au moins l'une des trois métriques sélectionnées est supérieure à zéro.
Lorsque vous interrogez des données historiques au-delà de la période de conservation des données, les données précises datant de plus de 37 mois ne sont pas disponibles et ne renvoient aucune ligne. Les requêtes de segments de date précis (segments.date, segments.week et segments.hour) couvrant des périodes remontant à plus de 37 mois renvoient DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED dans la version 24 et ultérieures (ou DateRangeError.UNKNOWN dans la version 23). Les données agrégées de haut niveau (segments.month, segments.quarter et segments.year) sont conservées pendant 11 ans à compter du début de la prochaine période calendaire complète. Par exemple, si la limite de 11 ans tombe le 2015-03-22 (ou le 2015-03-01), les données mensuelles sont disponibles à partir du premier mois civil complet après la limite (2015-04-01). Pour en savoir plus, consultez Périodes.