Skip to main content
Jede Abfrage, die du im Explorer erstellst, ist eine AftersellQL (AQL)-Anweisung. Meistens erstellst du Abfragen visuell und schreibst AQL nie von Hand; diese Seite ist die Referenz für die Kennzahlen und Dimensionen, die du auswählen kannst, die AQL-Textform und die Zeitzonenregeln.

Verfügbare Kennzahlen

Dies sind die Kennzahlen, die du auswählen kannst, gruppiert wie in der Kennzahlenauswahl.

Umsatz & Gewinn

Conversions

Engagement

Shop-Performance

Rokt-Netzwerk

Dimensionen

Dimensionen schlüsseln eine Kennzahl nach einem Attribut auf. Nicht alle Dimensionen sind mit jeder Kennzahl kompatibel; der Explorer verhindert inkompatible Kombinationen automatisch (zum Beispiel können Decline rate und Show rate nicht nach Currency aufgeschlüsselt werden).

Verfügbare Dimensionen

Nicht verfügbare Dimensionen

Die folgenden Dimensionen sind noch in Arbeit. Sie erscheinen in der Auswahl, werden aber bis zu ihrer Implementierung für jede Kennzahl als ‘Not compatible’ angezeigt.

Syntax von AQL-Anweisungen

Eine AQL-Anweisung ist eine einzelne Frage, die aus Klauseln besteht. Nur SELECT und ein Zeitraum (SINCE) sind erforderlich; alles andere ist optional. Wenn du optionale Klauseln verwendest, müssen sie in dieser Reihenfolge stehen:
Ein minimales Beispiel, täglicher Upsell-Umsatz und Accept Rate der letzten 30 Tage:
Schlüsselwörter unterscheiden nicht zwischen Groß- und Kleinschreibung (SELECT und select funktionieren beide), und Anweisungen enden nicht mit einem Semikolon. String-Werte werden in doppelte Anführungszeichen gesetzt; Zahlen und Listen nicht.

SELECT und GROUP BY

  • SELECT listet die zu messenden Kennzahlen durch Kommas getrennt auf, zum Beispiel SELECT revenue, impressions, accept_rate.
  • GROUP BY schlüsselt diese Kennzahlen nach einer oder mehreren Dimensionen auf, etwa date, device, surface oder funnel. Ohne GROUP BY erhältst du eine einzige Summe für den gesamten Zeitraum.

Filtern mit WHERE

WHERE grenzt die Daten ein, bevor sie gemessen werden. Kombiniere Bedingungen mit AND.
impressions, accept_rate und rpv können nicht nach Gerät, Funnel, Platzierung oder Produkt gefiltert oder gruppiert werden; ihr Quell-Rollup hat keine solche Spalte. Wenn du WHERE device = "mobile" zu einer Abfrage hinzufügst, die eine dieser Kennzahlen auswählt, wird sie mit metric "impressions" cannot be filtered by "device" abgelehnt.
Unterstützte Vergleiche sind =, !=, IN, NOT IN, >, <, >= und <=. Verwende eine Liste mit IN, um mehrere Werte abzugleichen:
experiment ist kein filterbares Feld; es hat keine Rollup-Quelle, daher wird WHERE experiment IN [...] mit filters on "experiment" are not supported. abgelehnt. Der Funnel-Filter unterstützt Mehrfachauswahl: is one of (IN) schließt nur die ausgewählten Funnels ein, is not one of (NOT IN) schließt sie aus. Wenn du nach Funnel gruppierst und einen is one of-Filter anwendest, zeigt das Diagramm eine Linie pro ausgewähltem Funnel, ohne Zusammenfassung unter “Other”.

Zeiträume und Vergleiche

Jede Abfrage benötigt einen Zeitraum, der mit SINCE festgelegt wird: Verfügbare Voreinstellungen: last_1d, last_7d, last_30d, last_90d, this_month, last_month und this_year.
  • GRAIN legt die Intervallgröße für Zeitreihen fest: day, week oder month. (hour wird geparst, aber kein Rollup liefert stündliche Daten, daher wird eine solche Abfrage mit group_by / time_grain combination is not supported. abgelehnt.)
  • COMPARE legt einen zweiten Zeitraum darüber. Verwende previous_period, das gleich lange Fenster unmittelbar davor. previous_year ist in der Compare-Auswahl ausgeblendet, da das Warehouse keine Daten vor Februar 2026 enthält; es kann in AQL nur noch eingegeben werden, damit zuvor gespeicherte Abfragen weiterhin geparst werden.
Reporting-Daten beginnen im Februar 2026, daher liefert ein früheres Fenster für beide Zeiträume leere Ergebnisse.

Ein Diagramm auswählen

  • CHART legt fest, wie das Ergebnis angezeigt wird: scorecard, line_chart, bar_chart, area_chart, funnel_chart oder table.
  • TIMEZONE legt die Zeitzone fest, die für die Datumsintervalle verwendet wird, als IANA-Name in Anführungszeichen, zum Beispiel TIMEZONE "America/New_York". Standard ist UTC (siehe Zeitzonen).
Der Typ funnel_chart hat spezielle Anforderungen:
  • Platzierungsmodus. Gruppiere nach placement und wähle eine Kennzahl aus. Die Stufen werden nach der kanonischen Platzierungsreihenfolge sortiert (Standard-Upsell, dann Downsell, dann zusätzliche Upsells). Nur die erste Kennzahl wird dargestellt; weitere Kennzahlen werden in einer Fußnote vermerkt.
  • Kennzahlenmodus. Wähle zwei oder mehr Kennzahlen ohne GROUP BY. Jede Kennzahl wird in der Reihenfolge der Abfrage zu einer Funnel-Stufe (zum Beispiel zeigt SELECT impressions, conversions den Rückgang von Impressionen zu Conversions). Alle Kennzahlen müssen dieselbe Einheit haben.
Der Platzierungsmodus benötigt eine Kennzahl, die nach Platzierung aufgeschlüsselt werden kann. impressions, accept_rate und rpv können das nicht; das Funnel-Diagramm zeigt für diese “These metrics can’t be grouped by placement” an.

Sortieren und Begrenzen

  • ORDER BY sortiert Ergebnisse nach einer Kennzahl oder Dimension, mit ASC oder DESC.
  • LIMIT begrenzt die Anzahl der zurückgegebenen Zeilen, nützlich für “Top N”-Fragen.

Weitere Beispiele

impressions, accept_rate und rpv können nicht nach Gerät aufgeschlüsselt werden; ihr Rollup ist Shop × Oberfläche × Tag, ohne Gerätespalte. Verwende revenue (oder eine andere aus Conversions stammende Kennzahl) für Gerätevergleiche.

Zeitzonen

Standardmäßig laufen Abfragen in UTC. Du kannst die Zeitzone überschreiben, damit nach Datum gruppierte Ergebnisse die Ortszeit widerspiegeln (siehe Eine Zeitzone festlegen für die Schritte in der Symbolleiste).
Abfragen, die Impressions, Accept Rate oder Revenue Per Visit enthalten, gruppieren Datumsangaben immer in UTC, unabhängig von der gewählten Zeitzone, da diese aus einem täglichen Rollup stammen, das in UTC-Tagen berichtet wird. Wenn eine Abfrage eine dieser Kennzahlen mit anderen Kennzahlen kombiniert, fällt die gesamte Ergebnismenge auf UTC zurück, damit die Datumsintervalle übereinstimmen.

Die TIMEZONE-Klausel

Gib eine Zeitzone direkt in AQL mit der TIMEZONE-Klausel an, die zwischen CHART und ORDER BY steht:
Wenn die Klausel vorhanden ist, überschreibt sie für diese Abfrage die Auswahl in der Symbolleiste und bleibt beim Speichern und erneuten Laden erhalten.

Verfügbare Zeitzonen

Die Auswahl (und die TIMEZONE-Klausel) akzeptiert eine feste Menge von zehn Zeitzonen. Jede andere IANA-Zeitzone wird als nicht unterstützt abgelehnt.

Kontostandard und wie die Zeitzone Ergebnisse beeinflusst

Wenn Lock reporting timezone in deinen Analytics-Einstellungen aktiviert ist, verwendet die Auswahl von Account default diese gesperrte Zeitzone (die Symbolleiste zeigt die aufgelöste Zone an, zum Beispiel Timezone: Account default (Paris (CET))). Die Seite mit den Analytics-Einstellungen akzeptiert die vollständige IANA-Liste, Reports berücksichtigt jedoch nur die zehn oben genannten Zonen; wenn deine gesperrte Zone nicht dazugehört, wird Account default stillschweigend zu UTC aufgelöst. Wenn Lock reporting timezone nicht aktiviert ist, fällt Account default auf UTC zurück. Wenn eine Zeitzone festgelegt ist, verwendet die Datumsgruppierung die Ortszeit statt UTC. Zum Beispiel fällt ein Ereignis um 2026-03-29T01:30:00Z in New York (ET) auf den 28. März, in Paris (CET) jedoch auf den 29. März. Abfragen ohne Zeitzone, einschließlich zuvor gespeicherter, laufen weiterhin in UTC.