Plages de dates

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

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

Période personnalisée

Vous pouvez spécifier des dates au format étendu (YYYY-MM-DD) ou de base (YYYYMMDD) de la norme 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 plages de dates 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 de l'année 2026, utilisez la condition suivante en spécifiant le premier jour de ce mois :

segments.month = '2026-05-01'

Limites de l'historique des données

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

• Granularité quotidienne, hebdomadaire et horaire (segments.date, segments.week et segments.hour) : accepte une période d'analyse allant jusqu'à 37 mois. Les requêtes qui segmentent par segments.date, segments.week ou segments.hour (ou qui filtrent sur une période inférieure à un mois) pour des dates au-delà de la période de 37 mois échouent avec l'erreur DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED dans la v24 et les versions ultérieures (ou DateRangeError.UNKNOWN dans la v23).
• Précision 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 par segments.month, segments.quarter ou segments.year, ou omettez les segments de date dans SELECT, et assurez-vous que la plage de dates WHERE commence le premier jour d'un mois et se termine le dernier jour d'un mois (ou filtrez sur segments.month, segments.quarter ou segments.year).