Les dimensions ventilent une métrique selon un attribut. Toutes les dimensions ne sont pas compatibles avec toutes les métriques ; l’Explorer empêche automatiquement les combinaisons incompatibles (par exemple, Decline rate et Show rate ne peuvent pas être ventilés par Currency).
Les dimensions suivantes sont en cours de développement. Elles apparaissent dans le sélecteur mais s’affichent comme « Not compatible » pour toutes les métriques jusqu’à leur implémentation.
Une instruction AQL est une question unique composée de clauses. Seuls
SELECT et une plage de dates (SINCE) sont obligatoires ; tout le reste est facultatif. Lorsque vous incluez des clauses facultatives, elles doivent apparaître dans cet ordre :
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.SELECTliste les métriques à mesurer, séparées par des virgules, par exempleSELECT revenue, impressions, accept_rate.GROUP BYventile ces métriques selon une ou plusieurs dimensions, commedate,device,surfaceoufunnel. SansGROUP BY, vous obtenez un total unique pour toute la période.
WHERE restreint les données avant qu’elles ne soient mesurées. Combinez les conditions avec AND.
=, !=, IN, NOT IN, >, <, >= et <=. Utilisez une liste avec IN pour faire correspondre plusieurs valeurs :
experiment n’est pas un champ filtrable ; il n’a pas d’agrégat source, donc WHERE experiment IN [...] est rejeté avec filters on "experiment" are not supported.
Le filtre funnel prend en charge la sélection multiple : is one of (IN) inclut uniquement les funnels sélectionnés, is not one of (NOT IN) les exclut. Lorsque vous regroupez par Funnel et appliquez un filtre is one of, le graphique affiche une ligne par funnel sélectionné, sans regroupement « Other ».
Chaque requête nécessite une plage de dates, définie avec SINCE :
Préréglages disponibles :
last_1d, last_7d, last_30d, last_90d, this_month, last_month et this_year.
GRAINdéfinit la taille des intervalles pour les séries temporelles :day,weekoumonth. (hourest accepté syntaxiquement mais aucun agrégat ne fournit de données horaires, une telle requête est donc rejetée avecgroup_by / time_grain combination is not supported.)COMPAREsuperpose une seconde période. Utilisezprevious_period, la fenêtre de même durée immédiatement antérieure.previous_yearest masqué du sélecteur Compare car l’entrepôt de données ne contient aucune donnée antérieure à février 2026 ; il reste saisissable en AQL uniquement pour que les requêtes enregistrées auparavant continuent d’être analysées.
Les données de reporting commencent en février 2026 ; une fenêtre antérieure renvoie donc un résultat vide pour les deux périodes.
CHARTdéfinit comment le résultat est affiché :scorecard,line_chart,bar_chart,area_chart,funnel_chartoutable.TIMEZONEdéfinit le fuseau horaire utilisé pour regrouper les dates, sous la forme d’un nom IANA entre guillemets, par exempleTIMEZONE "America/New_York". Par défaut, UTC (voir Fuseaux horaires).
funnel_chart a des exigences spécifiques :
- Mode emplacement. Regroupez par
placementet sélectionnez une métrique. Les étapes sont ordonnées selon la séquence canonique des emplacements (upsell par défaut, puis downsell, puis upsells supplémentaires). Seule la première métrique est tracée ; les métriques supplémentaires 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, conversionsaffiche la déperdition des impressions vers les conversions). Toutes les métriques doivent partager la même unité.
ORDER BYtrie les résultats selon une métrique ou une dimension, avecASCouDESC.LIMITplafonne le nombre de lignes renvoyées, utile pour les questions de type « top N ».
impressions, accept_rate et rpv ne peuvent pas être ventilés par appareil ; leur agrégat est boutique × surface × jour, sans colonne d’appareil. Utilisez revenue (ou une autre métrique issue des conversions) pour les comparaisons par appareil.Les requêtes qui incluent Impressions, Accept Rate ou Revenue Per Visit regroupent toujours les dates en UTC, quel que soit le fuseau horaire sélectionné, car ces métriques proviennent d’un agrégat quotidien établi en jours UTC. Si une requête mélange l’une d’elles avec d’autres métriques, l’ensemble des résultats repasse en UTC afin que les intervalles de dates restent alignés.
TIMEZONE, qui se place entre CHART et ORDER BY :
TIMEZONE) accepte un ensemble fermé de dix fuseaux. Tout autre fuseau horaire IANA est rejeté comme non pris en charge.
Si Lock reporting timezone est activé dans vos paramètres d’analytics, sélectionner Account default utilise ce fuseau horaire verrouillé (la barre d’outils affiche le fuseau résolu, par exemple Timezone: Account default (Paris (CET))). La page des paramètres d’analytics accepte la liste IANA complète, mais Reports ne prend en compte que les dix fuseaux ci-dessus ; si votre fuseau verrouillé n’en fait pas partie, Account default se résout silencieusement en UTC. Si Lock reporting timezone n’est pas activé, Account default revient à UTC.
Lorsqu’un fuseau horaire est défini, le regroupement par date utilise l’heure locale au lieu de l’UTC. Par exemple, un événement à
2026-03-29T01:30:00Z tombe le 28 mars à New York (ET) mais le 29 mars à Paris (CET). Les requêtes sans fuseau horaire, y compris celles enregistrées auparavant, continuent de s’exécuter en UTC.