Aucune métrique

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 des entités. Les raisons peuvent être multiples :

  • Les entités ne sont pas éligibles à l'affichage.
  • 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 ne sont peut-être pas 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 dans le langage de requête Google Ads.

La requête suivante montre comment supprimer explicitement les métriques nulles avec 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 sélectionnées métriques soient nulles (voir Lignes renvoyées avec des métriques nulles).

Pour segmenter un rapport, incluez un champ segments dans la clause SELECT de la requête de recherche (le filtrage 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 réparties sur une ligne pour chaque date. Les dates sans métriques ne sont pas renvoyées dans un tel 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 toutes les métriques sélectionnées sont nulles ne sont pas renvoyées lors de la segmentation. Prenons l'exemple de 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 contient aucune ligne dans laquelle les trois métriques sélectionnées sont nulles, mais il renvoie 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 pas de lignes. Les requêtes concernant des segments de date précis (segments.date, segments.week et segments.hour) couvrant des périodes de plus de 37 mois renvoient DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED dans la version 24 et ultérieure (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, alignées sur le début de la période calendaire complète suivante. Par exemple, si la période de rétrospection de 11 ans s'arrête le 2015-03-22 (ou le 2015-03-01), les données mensuelles sont disponibles à partir du premier mois calendaire complet après la date limite (2015-04-01). Pour en savoir plus, consultez Plages de dates.

Précédent
Segmentation
Suivant
Libellés