-- cap the number of rows
```
Un exemple minimal — revenu d'upsell quotidien et taux d'acceptation pour les 30 derniers jours :
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
```
Les mots-clés ne sont pas sensibles à la casse (`SELECT` et `select` fonctionnent tous les deux) et les instructions ne se terminent pas par un point-virgule. Les valeurs de type chaîne sont entourées de guillemets doubles ; les nombres et les listes ne le sont pas.
### Choisir quoi mesurer et comment le découper
* **`SELECT`** liste les métriques à mesurer, séparées par des virgules — par exemple `SELECT revenue, impressions, accept_rate`.
* **`GROUP BY`** ventile ces métriques selon une ou plusieurs dimensions, comme `date`, `device`, `surface` ou `funnel`. Sans `GROUP BY`, vous obtenez un total unique pour toute la période.
Pour la liste complète des métriques et dimensions disponibles — et les combinaisons autorisées — consultez [Métriques disponibles](#available-metrics) et [Dimensions disponibles](#available-dimensions) ci-dessus. L'Explorer empêche automatiquement les combinaisons incompatibles de métriques et de dimensions.
#### Filtrer avec `WHERE`
`WHERE` restreint les données avant qu'elles ne soient mesurées. Combinez les conditions avec `AND`.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, impressions, accept_rate, rpv
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```
Les comparaisons prises en charge sont `=`, `!=`, `IN`, `NOT IN`, `>`, `<`, `>=` et `<=`. Utilisez une liste avec `IN` pour correspondre à plusieurs valeurs :
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE experiment IN ["variant_a", "variant_b"]
```
#### Filtrer par plusieurs funnels
Le filtre **funnel** prend en charge des opérateurs de sélection multiple afin que vous puissiez limiter une requête à un sous-ensemble de vos funnels :
* **is one of** — inclut uniquement les funnels sélectionnés (`IN`).
* **is not one of** — exclut les funnels sélectionnés (`NOT IN`).
Lorsque vous choisissez **is one of** ou **is not one of**, le champ de valeur se transforme en une liste défilante de cases à cocher affichant tous les noms de vos funnels. Sélectionnez autant de funnels que nécessaire.
Lorsque vous regroupez les résultats par **Funnel** et appliquez un filtre **is one of**, le graphique en courbes affiche une courbe par funnel sélectionné — même si vous en sélectionnez plus que le nombre de séries par défaut. Aucun funnel sélectionné n'est regroupé dans une catégorie « Other ».
### Plages de temps et comparaisons
Chaque requête a besoin d'une plage de temps, définie avec `SINCE`. Utilisez un préréglage ou une fenêtre personnalisée.
| Forme | Exemple | Signification |
| --------------------- | ----------------------------------- | ------------------------------------------------------- |
| Préréglage | `SINCE last_30d` | Une fenêtre glissante se terminant aujourd'hui. |
| Fenêtre personnalisée | `SINCE 2025-11-28 UNTIL 2025-12-01` | Une plage fixe, utilisant des dates ISO (`YYYY-MM-DD`). |
Préréglages disponibles : `last_1d`, `last_7d`, `last_30d`, `last_90d`, `this_month`, `last_month` et `this_year`.
* **`GRAIN`** définit la taille de l'intervalle pour les séries temporelles — `hour`, `day`, `week` ou `month`.
* **`COMPARE`** superpose une seconde période afin que vous puissiez voir l'évolution d'un coup d'œil. Utilisez `previous_period` (la fenêtre de même durée juste avant) ou `previous_year` (la même fenêtre décalée d'un an en arrière).
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- BFCM 2025 vs BFCM 2024
SELECT revenue, impressions, accept_rate
GROUP BY date
SINCE 2025-11-28 UNTIL 2025-12-01
GRAIN day
COMPARE previous_year
```
### Choisir un graphique et un fuseau horaire
Ces clauses facultatives sont généralement définies pour vous par les contrôles visuels de l'Explorer, mais vous pouvez aussi les écrire directement :
* **`CHART`** définit la manière dont le résultat est affiché : `scorecard`, `line_chart`, `bar_chart`, `area_chart`, `funnel_chart` ou `table`.
* **`TIMEZONE`** définit le fuseau horaire utilisé pour regrouper les dates, sous la forme d'un nom IANA entre guillemets — par exemple `TIMEZONE "America/New_York"`. Par défaut : UTC.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
GROUP BY date
SINCE last_30d
GRAIN day
CHART line_chart
TIMEZONE "America/New_York"
```
Le type `funnel_chart` a des exigences spécifiques :
* **Mode placement** — Regroupez par `placement` et sélectionnez une métrique. Les étapes sont ordonnées selon la séquence canonique des placements (upsell par défaut → downsell → upsells supplémentaires). Seule la première métrique est tracée ; les métriques supplémentaires sélectionnées sont mentionnées dans une note de bas de page.
* **Mode métrique** — Sélectionnez deux métriques ou plus sans `GROUP BY`. Chaque métrique devient une étape du funnel dans l'ordre de la requête (par exemple, `SELECT impressions, conversions` affiche une déperdition impressions → conversions). Toutes les métriques doivent partager la même unité (par exemple, vous ne pouvez pas mélanger des métriques de devise et de pourcentage).
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Placement funnel: conversion drop-off across placements
SELECT impressions
GROUP BY placement
SINCE last_30d
CHART funnel_chart
```
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Metric funnel: impressions to conversions drop-off
SELECT impressions, conversions
SINCE last_30d
CHART funnel_chart
```
### Trier et limiter
* **`ORDER BY`** trie les résultats par une métrique ou une dimension, avec `ASC` ou `DESC`.
* **`LIMIT`** plafonne le nombre de lignes renvoyées — utile pour les questions de type « top N ».
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Top 20 products by upsell revenue this month
SELECT revenue, conversions, avg_conversion_value
GROUP BY product
SINCE this_month
ORDER BY revenue DESC
LIMIT 20
```
### Plus d'exemples
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Daily performance vs the previous period
SELECT revenue, impressions, conversions, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
COMPARE previous_period
```
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Mobile vs desktop accept rate over the last 90 days
SELECT impressions, accept_rate, rpv
GROUP BY device
SINCE last_90d
ORDER BY rpv DESC
```
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Which surface is driving the most revenue?
SELECT revenue, impressions, accept_rate
GROUP BY surface
SINCE last_30d
ORDER BY revenue DESC
```
Une fois que vous avez une requête qui vous convient, enregistrez-la et ajoutez-la à un rapport en tant que widget pour qu'elle continue de se mettre à jour — consultez [Gérer les widgets](/fr/aftersell/reports_widgets). Pour supprimer un widget dont vous n'avez plus besoin, chargez-le dans l'Explorer et cliquez sur **Delete** dans la barre de titre. Supprimer un widget le retire de tous les rapports où il apparaît. Le bouton **Delete** n'est affiché que pour les widgets qui vous appartiennent ; les widgets de modèle globaux sont en lecture seule.
***
## Exporter les résultats
L'Explorer affiche les résultats de votre requête à l'écran sous forme de scorecard, de graphique ou de tableau — il ne télécharge pas de fichier directement depuis la vue de requête.
Pour obtenir les résultats sous forme de fichier, enregistrez la requête et ajoutez-la à un rapport en tant que [widget](/fr/aftersell/reports_widgets). Chaque widget dispose de son propre bouton **Export to CSV** qui télécharge les données du widget dans un fichier `.csv`. Pour les exports standards de la page Analytics (Excel et CSV), consultez [Exporter vos données](/fr/aftersell/analytics_in_aftersell#exporting-your-data).
***
## Prise en charge des fuseaux horaires
Par défaut, les requêtes s'exécutent en UTC. Vous pouvez remplacer le fuseau horaire pour n'importe quelle requête directement dans la barre d'outils de l'Explorer, afin que les résultats regroupés par date (ventilations quotidiennes, hebdomadaires, mensuelles) reflètent votre heure locale plutôt que l'UTC.
Les requêtes qui incluent **Impressions**, **Accept Rate** ou **Revenue Per Visit** regroupent toujours les dates en UTC, quel que soit le fuseau horaire que vous sélectionnez. Ces métriques proviennent d'un agrégat quotidien qui n'est rapporté qu'en jours UTC. Si une requête mélange l'une de ces métriques avec d'autres, l'ensemble du résultat se rabat sur l'UTC afin que les intervalles de dates restent alignés.
### Définir un fuseau horaire pour une requête
1. Ouvrez l'Explorer dans votre interface d'administration Aftersell.
2. Dans la barre d'outils, cliquez sur le sélecteur **Timezone** (à côté de **Compare**).
3. Choisissez l'un des fuseaux horaires disponibles dans la liste, ou sélectionnez **Account default** pour utiliser le fuseau horaire configuré dans vos paramètres d'analytique.
4. Exécutez votre requête. Les résultats sont regroupés en utilisant le fuseau horaire sélectionné.
Le fuseau horaire sélectionné est enregistré avec la requête. Lorsque vous enregistrez et rechargez une requête, le fuseau horaire est restauré automatiquement.
### Fuseau horaire par défaut du compte
Si l'option **Lock reporting timezone** est activée dans vos paramètres d'analytique, sélectionner **Account default** dans la barre d'outils utilise ce fuseau horaire verrouillé pour votre requête. Le libellé de la barre d'outils affiche la zone résolue, par exemple **Timezone: Account default (Paris (CET))**.
Si **Lock reporting timezone** n'est pas activé, **Account default** se rabat sur l'UTC.
### Spécifier un fuseau horaire en AQL
Vous pouvez également spécifier un fuseau horaire directement dans votre requête AQL à l'aide de la clause `TIMEZONE`, qui apparaît entre `CHART` et `ORDER BY` :
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
ORDER BY ...
```
Lorsqu'elle est présente, la clause remplace la sélection de la barre d'outils pour cette requête. Le fuseau horaire est préservé lorsque vous enregistrez et rechargez la requête.
### Fuseaux horaires disponibles
Le sélecteur de fuseau horaire inclut les options suivantes :
| Fuseau horaire | Lieu d'exemple |
| -------------------- | ------------------------- |
| UTC | Temps universel coordonné |
| America/New\_York | New York (ET) |
| America/Chicago | Chicago (CT) |
| America/Denver | Denver (MT) |
| America/Los\_Angeles | Los Angeles (PT) |
| America/Sao\_Paulo | São Paulo (BRT) |
| Europe/London | Londres (GMT/BST) |
| Europe/Paris | Paris (CET/CEST) |
| Asia/Dubai | Dubaï (GST) |
| Asia/Tokyo | Tokyo (JST) |
| Australia/Sydney | Sydney (AEST/AEDT) |
### Comment le fuseau horaire affecte les résultats des requêtes
Lorsqu'un fuseau horaire est défini, le regroupement par date de votre requête utilise l'heure locale au lieu de l'UTC. Par exemple, un événement survenu à `2026-03-29T01:30:00Z` (UTC) tombe le 28 mars à l'heure de New York (ET) mais le 29 mars à l'heure de Paris (CET). Définir le bon fuseau horaire garantit que vos ventilations quotidiennes, hebdomadaires et mensuelles correspondent à vos attentes en matière de reporting métier.
Les requêtes qui n'incluent pas de fuseau horaire — y compris les requêtes précédemment enregistrées — continuent de s'exécuter en UTC, donc les résultats existants ne sont pas affectés.
***
## Besoin d'aide ?
Si vous avez des questions sur l'Explorer ou souhaitez activer l'accès, contactez l'équipe de support Aftersell via le chat intégré à l'application.