Kundendaten abrufen

In Workflows, die Kundendaten verwenden, kannst du die Aktion „Kundendaten abrufen“ nutzen, um Kundeninformationen aus deinem Shop abzurufen.

Hinweis

Dies ist eine Aktion vom Typ „Daten abrufen“. Wie du diese Art von Aktion mit dem Trigger „Geplante Zeit“ und den „Für jede“-Schleifen verwendest, erfährst du unter Zeitpläne, Datenabruf und sich wiederholende Workflows in Shopify Flow.

Konfiguration

Felder

Die Aktion „Kundendaten abrufen“ enthält die folgenden Felder, die zur Erstellung 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 der Ergebnisse, die von der ausgewählten Suchanfrage zurückgegeben werden können. Es können bis zu 100 Ergebnisse gleichzeitig zurückgegeben werden.
Suchanfrage	Erforderlich. Wähle aus allgemeinen Suchanfragen aus oder wähle Erweitert, um deine eigene zu erstellen.

Abfrage-String

Dies ist eine Beispiel-Suchanfrage, um Kund:innen 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 Kundenabfrage 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. 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 Kundenfilter
• Suchanfragen müssen einer bestimmten Syntax folgen.
• Die Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in der API-Dokumentation. Alternativ findest du die Feldwerte oft in den URLs im Adminbereich, wenn du filterst. Um zum Beispiel einige Werte für Bestellabfragen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
• Du kannst eine Suchanfrage in deinem Shop ausführen oder testen, indem du die Shopify GraphiQL App verwendest.
• Beachte, was passiert, wenn deine Suchanfrage 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 möchtest du diese Daten möglicherweise auf unterschiedliche Weise verwenden:

• Wenn du jedes Listenelement einzeln bearbeiten musst, z. B. um für jedes einen Tag hinzuzufügen, kannst du die Aktion Für jedes Element 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 musst, z. B. eine E-Mail mit allen Artikeln 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 Kundendaten abrufen, bei der es sich um eine Liste von Kund:innen handelt. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst beispielsweise die Liste der Bestellungen in einer Aktion vom Typ Interne E-Mail senden wie folgt senden:

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

Hinweis

Wenn eine Aktion vom Typ Daten abrufen mehrmals in einem einzigen Workflow verwendet wird, wird dem Variablennamen eine Nummer hinzugefügt. In einem Workflow, der beispielsweise die Aktion Bestelldaten abrufen zweimal verwendet, lautet die erste Variable für zurückgegebene Daten getOrderData und die zweite getOrderData1. Dieser Name kann nicht angepasst werden.

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 angegebenen Zeit und nicht als Ergebnis eines Ereignisses. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, werden keine Daten automatisch einbezogen.

API-Details

• Kundenressource
• Filter für Kundenabfragen

Vorlagen

Kunden-Metafeld für alle Kund:innen in Tags umwandeln

Dieser Workflow füllt Tags für alle deine Kund:innen basierend auf einem Metafeldwert auf. Er wird stündlich ausgeführt und ruft bis zu 100 Kund:innen ab, die nicht den Tag „verarbeitet“ haben. Für jede:n Kund:in wird der Wert eines custom.test-Metafelds geprüft und als Tag hinzugefügt. Der Workflow fügt auch den Tag „verarbeitet“ hinzu, damit diese:r Kund:in nicht im nächsten geplanten Durchlauf des Workflows zurückgegeben wird. Um den Workflow zu verwenden, musst du den Namensraum und den Schlüssel des Metafelds ändern, damit sie mit einem Metafeld in deinem Shop übereinstimmen. Vorlage ansehen

Inaktive Kund:innen löschen

Löscht Kund:innen, die älter als 5 Jahre sind und noch nie eine Bestellung aufgegeben haben. Vorlage ansehen