Gutscheindaten abrufen

In Workflows, die Gutscheindaten erfordern, kannst du die Aktion Gutscheindaten abrufen verwenden, um Gutscheininformationen aus deinem Shop abzurufen.

Wichtig ist, dass dein Shop sowohl Gutscheinprodukte, mit denen Gutscheine generiert werden, als auch die Gutscheine selbst hat, die deine Kundschaft für Käufe verwenden kann. Die Aktion Gutscheindaten abrufen ruft Informationen über die Gutscheine selbst ab. Um Informationen über Gutscheinprodukte zu erhalten, verwende die Aktionen Produktdaten abrufen oder Produktvariantendaten abrufen.

Auf dieser Seite

Konfiguration

Felder

Die Aktion Gutscheindaten abrufen enthält die folgenden Felder, die zum Erstellen der Abfrage verwendet werden:

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

Abfrage-String

Dies ist eine Beispielabfrage zum Abrufen von Gutscheinen, die am letzten Tag aktualisiert wurden:

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Die Variable created_at ist ein Filter, der für die Gutscheinabfrage verfügbar ist und mehrmals verwendet oder mit anderen Variablen kombiniert werden kann. Die Liquid-Variable scheduledAt ist in Workflows verfügbar, die den Trigger „Geplante Zeit“ verwenden. Das date_minus Liquid-Tag ist ein spezielles Flow-Tag, mit dem du Zeit von einem Datum abziehen kannst.

Beim Abfragen von Daten ist es hilfreich, Folgendes zu wissen:

Liste verfügbarer Gutscheinfilter
Abfragen müssen einer bestimmten Syntax folgen.
Die Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen können die Werte in der API-Dokumentation nachgelesen werden. Alternativ findest du die Feldwerte oft in den URLs im Adminbereich, wenn du filterst. Um zum Beispiel einige Abfragewerte für Bestellungen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
Du kannst eine Abfrage in deinem Shop mit der Shopify GraphiQL App ausführen oder testen.
Beachte, was passiert, wenn deine Abfrage fehlschlägt. Oft gibt die API alle Ergebnisse zurück (anstelle von keinen).

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen geben eine Liste mit 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall kannst du diese Daten auf verschiedene Weisen verwenden:

Wenn du jedes Listenelement einzeln verarbeiten musst, z. B. um für jedes einen Tag hinzuzufügen, kannst du die Aktion Für jedes Element verwenden.
Wenn du Daten zusammenfassen musst, z. B. um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst du die Aktionen Zählen oder Summe verwenden.
Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Artikeln zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.

Um in Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable mit dem Namen Gutscheindaten abrufen. Dies ist eine Liste von Gutscheinen. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst die Liste der Gutscheine zum Beispiel in einer Aktion vom Typ Interne E-Mail senden wie folgt senden:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.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.