Analysedaten abrufen

Die Aktion Analysedaten abrufen führt eine ShopifyQL-Abfrage aus und gibt die Ergebnisse zur Verwendung in deinem Workflow zurück. ShopifyQL ist eine Abfragesprache, die für Commerce-Analysen entwickelt wurde. Du kannst sie verwenden, um Kennzahlen über bestimmte Zeiträume zu aggregieren, Filter anzuwenden und nach Dimensionen wie Produkt, Kollektion oder Kund:in zu gruppieren. Die von dieser Aktion zurückgegebenen Daten stehen den Bedingungen und Aktionen zur Verfügung, die auf diesen Schritt folgen.

Auf dieser Seite

Trigger

Die Aktion Analysedaten abrufen ist nur mit dem Trigger Geplante Zeit kompatibel. Analysedaten sind in ereignisbasierten Triggern nicht enthalten.

Konfiguration

Felder

Die Aktion Analysedaten abrufen enthält das folgende Feld:

In der Aktion „Analysedaten abrufen“ verwendete Felder.
Feld	Beschreibung
ShopifyQL-Abfrage	Erforderlich. Die ShopifyQL-Abfrage, die für die Analysedaten deines Shops ausgeführt werden soll.

ShopifyQL-Abfrage

Du kannst jede gültige ShopifyQL-Abfrage schreiben, indem du unterstützte Schemata verwendest, wie beispielsweise sales, sessions, inventory und payments. Die folgende Abfrage gibt beispielsweise den Gesamtumsatz und die Anzahl der Kund:innen für den Tag zurück, an dem der Workflow ausgeführt wird:

FROM sales
  SHOW total_sales, customers
  SINCE today

Die vollständige Sprachreferenz, einschließlich der unterstützten Schemata, Funktionen und Syntax, findest du in der ShopifyQL-Dokumentation.

Die Abfrage wird beim Speichern des Workflows validiert. Der Workflow kann erst aktiviert werden, nachdem die Abfrage für deinen Shop erfolgreich ausgeführt wurde.

Zurückgegebene Daten

Die Aktion Analysedaten abrufen gibt die Zeilen zurück, die deiner Abfrage entsprechen. Sie sind als Variable mit dem Namen getAnalyticsData verfügbar. Die Zeilen werden in getAnalyticsData.rows gespeichert, wobei jede Zeile ein Objekt ist, dessen Schlüssel den Spaltennamen in deiner Abfrage entsprechen.

Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden, die auf den Schritt folgen. Um beispielsweise eine interne E-Mail zu senden, in der jede Zeile aufgeführt ist, kannst du Liquid ähnlich wie in diesem Beispiel verwenden:

{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}

Um mit jeder Zeile einzeln zu arbeiten, beispielsweise um eine Aktion auf jede Zeile anzuwenden, kannst du die Aktion For-Each-Schleife (iterieren) mit getAnalyticsData.rows verwenden. Um Werte zu aggregieren, beispielsweise um Zeilen zu zählen oder die Summe einer Spalte zu berechnen, kannst du die Aktionen Zählen und Summieren verwenden.

API-Referenz

Weitere Informationen zu der in dieser Aktion verwendeten API findest du in der shopifyqlQuery-Abfrage in der GraphQL Admin API.

Abfragekomplexität

Jede ShopifyQL-Abfrage verursacht Komplexitätskosten, die anhand der Schemata, Spalten, Filter und des Zeitraums berechnet werden, die in der Abfrage verwendet werden. Wenn eine Abfrage das Komplexitätslimit überschreitet, schlägt die Aktion fehl und der Workflow kann nicht aktiviert werden. Um die Kosten einer Abfrage zu senken, kannst du den Zeitraum verkürzen oder Spalten sowie Joins entfernen.

Details zur Berechnung der Abfragekosten und zu den aktuellen Limits findest du unter Ratenbegrenzung in der ShopifyQL Admin API.