Marktdaten abrufen

In Workflows, die Marktdaten erfordern, kannst du die Aktion Marktdaten abrufen verwenden, um Marktinformationen aus deinem Shopify-Shop abzurufen. Märkte sind Gruppen von Regionen oder Standorten, die du für den Vertrieb anvisierst.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Marktdaten abrufen enthält die folgenden Felder:

In den Aktionen vom Typ „Daten abrufen“ verwendete Felder.
Feld	Beschreibung
Daten sortieren nach	Erforderlich. Die Parameter, nach denen die durch die Suchanfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl an Ergebnissen	Erforderlich. Die maximale Anzahl von Ergebnissen, die von der ausgewählten Suchanfrage zurückgegeben werden können. Du kannst bis zu 100 Ergebnisse auf einmal zurückgeben.
Abfrage	Erforderlich. Wähle aus gängigen Abfragen oder klicke auf Erweitert, um eine eigene Abfrage zu erstellen.

Abfrage-String

Hier ist eine Beispielabfrage zum Abrufen aller aktiven Märkte:

status:ACTIVE

Die Variable status ist ein Filter, der für die Märkte-Abfrage verfügbar ist und mehrfach verwendet oder mit anderen Variablen kombiniert werden kann.

Bei der Datenabfrage ist es hilfreich, Folgendes zu wissen:

Liste der verfügbaren Marktfilter
Abfragen müssen einer bestimmten Syntax folgen
Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in der API-Dokumentation. Alternativ kannst du die Feldwerte beim Filtern oft in den URLs im Adminbereich finden. Um beispielsweise bestimmte Werte für eine Bestellabfrage zu finden, filtere die Seite „Bestellungen“ im Adminbereich und prüfe dann die URL.
Du kannst eine Abfrage in deinem Shop ausführen oder testen, indem du die Shopify GraphiQL-App verwendest.
Beachte, was passiert, wenn deine Abfrage fehlschlägt. Häufig gibt die API alle Ergebnisse zurück (anstatt keine).

Zurückgegebene Daten

Alle Aktionen des Typs Daten abrufen geben eine Liste mit 0 bis 100 Ressourcen zurück. Abhängig von deinem Anwendungsfall möchtest du diese Daten vielleicht auf verschiedene Arten nutzen:

Wenn du jedes Listenelement einzeln verarbeiten musst, z. B. um für jedes ein Tag hinzuzufügen, kannst du die Aktion For each verwenden.
Wenn du Daten aggregieren musst, wie z. B. um die Anzahl der zurückgegebenen Ergebnisse zu zählen, kannst du die Aktionen Zählen (Count) oder Summieren (Sum) verwenden.
Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Elementen zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.

Um in den auf diese Aktion folgenden Schritten auf die zurückgegebenen Daten zuzugreifen, verwende die Variable namens Get market data, die eine Liste von Märkten darstellt. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Beispielsweise kannst du die Liste der Märkte in einer Aktion des Typs Interne E-Mail senden senden, ähnlich wie folgt:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Trigger

Du kannst diese Aktion in jedem Workflow verwenden, einschließlich des Triggers Geplante Zeit. In einem Workflow, der den Trigger Geplante Zeit verwendet, startet der Workflow zu einer von dir festgelegten Zeit und nicht als Ergebnis eines Ereignisses. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, sind keine Daten automatisch enthalten.

API-Referenz

Weitere Informationen über die in dieser Aktion verwendete API findest du in der Märkte-Abfrage.