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 Kundschaft zu gruppieren. Die von dieser Aktion zurückgegebenen Daten stehen den Bedingungen und Aktionen zur Verfügung, die auf den Schritt folgen.

Auf dieser Seite

Trigger

Die Aktion Analysedaten abrufen ist nur mit dem Trigger Geplante Zeit kompatibel. Analysedaten werden nicht von ereignisbasierten Triggern eingeschlossen.

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 mithilfe unterstützter Schemata wie sales, sessions, inventory und payments schreiben. 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 unterstützter 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. Diese sind als Variable mit dem Namen getAnalyticsData verfügbar. Die Zeilen werden in getAnalyticsData.rows gespeichert, wobei jede Zeile ein Objekt darstellt, dessen Schlüssel die Spaltennamen in deiner Abfrage sind.

Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden, die auf den Schritt folgen. Um beispielsweise eine interne E-Mail mit einer Auflistung aller Zeilen zu senden, kannst du Liquid wie im folgenden Beispiel verwenden:

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

Um jede Zeile einzeln zu verarbeiten, 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 Summe verwenden.

API-Referenz

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

Abfragekomplexität

Jede ShopifyQL-Abfrage hat Komplexitätskosten, die aus den Schemata, Spalten, Filtern und dem Zeitraum berechnet werden, die von 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 reduzieren, kannst du den Zeitraum verkürzen sowie Spalten oder Joins entfernen.

Weitere Informationen dazu, wie die Abfragekosten berechnet werden, sowie zu den aktuellen Limits findest du unter Ratenbegrenzung in der ShopifyQL Admin API.