Produktvariantendaten abrufen

In Workflows, die Produktvariantendaten verwenden, kannst du die Aktion „Produktvariantendaten abrufen“ verwenden, um Informationen zu Produktvarianten aus deinem Shop abzurufen.

Auf dieser Seite

Konfiguration

Felder

Die Aktion „Produktvariantendaten abrufen“ enthält die folgenden Felder, die zur Erstellung der Abfrage verwendet werden:

In den Aktionen vom Typ „Daten abrufen“ 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 aus allgemeinen Abfragen oder wähle „Erweitert“ aus, um deine eigene zu erstellen.

Abfrage-String

Dies ist eine Beispielabfrage, um Produktvarianten abzurufen, die am letzten Tag aktualisiert wurden:

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

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

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

Liste der verfügbaren Filter für Produktvarianten
Abfragen müssen einer bestimmten Syntax folgen
Die Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in den API-Dokumenten. Alternativ findest du die Feldwerte oft in den URLs im Adminbereich, wenn du filterst. Um beispielsweise einige Werte für Bestellabfragen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
Du kannst eine Abfrage in deinem Shop ausführen oder testen, indem du die Shopify GraphiQL-App verwendest.
Achte darauf, 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 von 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall möchtest du diese Daten möglicherweise auf verschiedene Weisen verwenden:

Wenn du jeden Listenartikel einzeln bearbeiten musst, z. B. um für jeden einen Tag hinzuzufügen, kannst du die Aktion „For each“ verwenden.
Wenn du Daten aggregieren musst, z. B. um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst du die Aktionen „Zählen“ oder „Summieren“ verwenden.
Wenn du die Liste ausgeben möchtest, beispielsweise um eine E-Mail mit allen Artikeln zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.

Um in den Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable mit dem Namen „Produktvariantendaten abrufen“, bei der es sich um eine Liste von Produktvarianten handelt. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Zum Beispiel kannst du die Liste der Bestellungen in einer Aktion „Interne E-Mail senden“ wie folgt senden:

{% for single_variant in GetProductVariantData %}
* {{ single_variant.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 kein bestimmtes Ereignis in deinem Shop oder von einer App den Workflow startet, sind automatisch keine Daten enthalten.

API-Details

Vorlagen

Kostenlosen Artikel (100 % Rabatt) zu neuen Bestellungen hinzufügen

Diese Vorlage fügt neuen Bestellungen einen kostenlosen, rabattierten Artikel hinzu, wenn dieser auf Lager ist. Sie prüft den Lagerbestand, gewährt einen Rabatt von 100 % und aktualisiert die Bestellung, ohne die Kund:innen darüber zu benachrichtigen. Diese Automatisierung ist nützlich, um (1) die Kundenzufriedenheit zu erhöhen, indem ein kostenloser Überraschungsartikel zur Bestellung hinzugefügt wird, (2) neue oder weniger bekannte Produkte zu bewerben, indem sie als kostenlose Proben zu Bestellungen hinzugefügt werden, oder (3) Werbeaktionen zu optimieren, indem das Hinzufügen und die Rabattierung von kostenlosen Artikeln automatisiert wird. Vorlage ansehen

Wöchentliche E-Mail-Übersicht für Varianten mit niedrigem Lagerbestand senden

Dieser Workflow wird nach einem Zeitplan ausgeführt (z. B. einmal pro Woche). Er ruft eine Liste der Produktvarianten mit niedrigem Lagerbestand ab, zählt die Ergebnisse und sendet eine E-Mail-Übersicht mit den Variantentiteln und einem Link zur Admin-Seite für die jeweilige Variante. Vorlage ansehen