Plages de dates

Le langage de requête Google Ads vous permet de spécifier la plage de dates de différentes manières :

• Période personnalisée
• Plage de dates prédéfinie
• Période prédéfinie
• Limites de période historique

Période personnalisée

Vous pouvez spécifier des dates au format étendu (YYYY-MM-DD) ou de base (YYYYMMDD) ISO 8601. Le format étendu (YYYY-MM-DD) est recommandé pour une meilleure lisibilité. Utilisez BETWEEN ou des opérateurs de comparaison (=, >, >=, <, <=) avec des chaînes de date personnalisées :

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

Plage de dates prédéfinie

Utilisez l'opérateur DURING avec des littéraux de plage de dates prédéfinis. L'opérateur DURING n'est compatible qu'avec les plages de dates prédéfinies et ne peut pas être utilisé avec des chaînes de date personnalisées.

Voici la liste des périodes prédéfinies valides :

Exemple :

segments.date DURING LAST_30_DAYS

Période prédéfinie

Certains champs de date font référence à une période prédéfinie, à savoir :

• segments.week
• segments.month
• segments.quarter

Lorsque vous filtrez ces segments avec des chaînes de date personnalisées (à l'aide de =, BETWEEN, >=, <=, > ou <), vous devez spécifier une date correspondant au premier jour de la période :

• segments.week : lundi de la semaine (par exemple, '2026-05-04').
• segments.month : premier jour du mois (YYYY-MM-01, par exemple, '2026-05-01').
• segments.quarter : premier jour du trimestre civil (YYYY-01-01, YYYY-04-01, YYYY-07-01 ou YYYY-10-01).

Si vous spécifiez une date qui n'est pas le premier jour de la période, une erreur QueryError.MISALIGNED_DATE_FOR_FILTER est renvoyée. Vous pouvez également filtrer ces segments à l'aide de l'opérateur DURING avec une plage de dates prédéfinie.

Par exemple, pour spécifier le mois de mai 2026, utilisez la condition suivante en indiquant le premier jour de ce mois :

segments.month = '2026-05-01'

Limites de rétrospection historique

La disponibilité des données de rapport historiques dépend de la précision des segments de date sélectionnés ou filtrés :

• Précision quotidienne, hebdomadaire et horaire (segments.date, segments.week et segments.hour) : compatible avec une période d'analyse rétrospective de 37 mois maximum. Les requêtes segmentées par segments.date, segments.week ou segments.hour (ou filtrées sur une période inférieure à un mois) pour des dates au-delà de la période de 37 mois échouent avec DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED dans la version 24 et ultérieures (ou DateRangeError.UNKNOWN dans la version 23).
• Granularité mensuelle, trimestrielle, annuelle ou non segmentée (segments.month, segments.quarter, segments.year ou aucun segment de date) : jusqu'à 11 ans de données historiques. Pour interroger des données historiques au-delà de la période de 37 mois, segmentez-les par segments.month, segments.quarter ou segments.year, ou omettez les segments de date dans SELECT. Assurez-vous également que la plage de dates WHERE commence le premier jour d'un mois et se termine le dernier jour d'un mois (ou filtrez les données par segments.month, segments.quarter ou segments.year).