Metafeld-Trigger - Schritt für Schritt

In Metafelden speichert ein Shop diejenigen Werte, für die Shopify kein Feld vorsieht, und Shopify Flow kann nicht auf Änderungen an diesen Werten reagieren. Diese fünf Trigger können dies jedoch - und sie übertragen den Wert previousValue, sodass ein Workflow einen Anstieg von einem Rückgang unterscheiden kann.

Sie funktionieren alle per Definition: Sie wählen auf der Seite „Metafeld-Trigger“ der App aus, welche Metafelder überwacht werden sollen. Für ein Metafeld, das Sie dort nicht hinzugefügt haben, wird kein Trigger ausgelöst. Informationen zur Einrichtung finden Sie unter Metafeld-Trigger.

Metafeld-Aktualisierung

Wird ausgelöst, wenn sich ein überwachtes Metafeld ändert, unabhängig vom Typ des Eigentümers: Produkt, Variante, Kollektion, Kunde, Bestellung, Bestellentwurf, Unternehmen, Unternehmensstandort, Blog, Blogbeitrag oder Seite.

Brände aus	Shopify Webhook plus Änderungserkennung. Die Metafelder für Varianten, Blogs, Blogbeiträge und Seiten werden nach einem festgelegten Zeitplan überprüft
Genehmigung	Zugriff auf Produkt-, Varianten- und Kollektionsdaten
Eingeschaltet	Pro Metafeld-Definition auf der Seite „Metafeld-Trigger“ der App

Verwenden Sie es für

• Objekttypen ohne typisierten Trigger: Kollektionen, Unternehmen, Seiten, Blogbeiträge.
• Ein Workflow, der mehrere Metafelder überwacht und bei metafieldKey verzweigt.

Was „Metafield Update“ an Ihren Workflow übermittelt

Variable in Shopify Flow	Typ	Was darin enthalten ist
metafieldKey	Text	Der „namespace.key“ des Metafelds, das aktualisiert wurde (zur Filterung in Shopify Flow)
resourceType	Text	Der Ressourcentyp (PRODUCT, PRODUCTVARIANT, Kollektion, Kunde, Bestellung, Unternehmen, COMPANYLOCATION, ARTICLE, BLOG, PAGE)
resourceId	Text	Die GID der Ressource, die aktualisiert wurde
metafield	Objekt	Das Metafeld, das aktualisiert wurde
metafield.id	ID	Globale ID des Metafeldes
metafield.namespace	Text	Der Namensraum des Metafeldes
metafield.key	Text	Der Schlüssel des Metafelds
metafield.value	Text	Der Wert des Metafelds
metafield.previousValue	Text	Der Wert vor dieser Änderung. Null, wenn das Metafeld gerade erst angelegt wurde
metafield.type	Text	Der Typ des Metafelds
eventId	Text	Die ID dieses Ereignisses. Suchen Sie danach im Ereignisverlauf der App, um genau zu sehen, was gesendet wurde.

Beispiel: Auf eine Änderung eines Metafelds einer Kollektion reagieren

1. Öffnen Sie in der App „Metafield Triggers“, klicken Sie auf** „Trigger hinzufügen“**, wählen Sie den Eigentümertyp „Kollektion“ und die entsprechende Definition aus und speichern Sie die Einstellungen.
2. Wählen Sie in „Shopify Flow“ „Metafeld-Aktualisierung“ als Trigger aus.
3. Fügen Sie eine Bedingung hinzu: metafieldKey ist gleich custom.banner_text und resourceType ist gleich COLLECTION.
4. Fügen Sie „Interne E-Mail senden“ mit den Adressen {{metafield.previousValue}} -> {{metafield.value}} und {{resourceId}} hinzu.
5. Aktivieren Sie den Workflow.

Aktualisierung der Produkt-Metafelder

Wird ausgelöst, wenn sich ein überwachtes Produkt-Metafeld ändert, wobei das Produkt als native Shopify Flow-Referenz dient.

Brände aus	Shopify Webhook plus Änderungserkennung
Genehmigung	Zugriff auf Produkt-, Varianten- und Kollektionsdaten
Eingeschaltet	Wenn Sie einen Shopify Flow aktivieren, der diese Funktion nutzt, wird sie dadurch eingeschaltet. Der entsprechende Schalter befindet sich auf der Seite „Trigger“ der App.

Verwenden Sie es für

• Nehmen Sie direkt Änderungen am Produkt vor: Fügen Sie Tags hinzu, veröffentlichen Sie es oder aktualisieren Sie ein weiteres Metafeld.
• Schwellenwerte für numerische Metafelder: eine Bewertung, eine Bestandsprognose, eine Lieferzeit eines Lieferanten.

Welche Daten die Aktualisierung des Produkt-Metafelds an Ihren Workflow übermittelt

Variable in Shopify Flow	Typ	Was darin enthalten ist
product	Produkt (Shopify)	Das Produkt, dessen Metafeld sich geändert hat. Es handelt sich um ein Produkt mit dem Status Shopify, sodass alle seine Felder sowie die produktbezogenen Aktionen von Shopify Flow verfügbar sind.
metafieldKey	Text	Der „namespace.key“ des Metafeldes, das sich geändert hat (zur Filterung in Shopify Flow)
metafield	Objekt	Das Metafeld, das aktualisiert wurde
metafield.id	ID	Globale ID des Metafeldes
metafield.namespace	Text	Der Namensraum des Metafelds
metafield.key	Text	Der Schlüssel des Metafeldes
metafield.value	Text	Der Wert des Metafelds
metafield.previousValue	Text	Der Wert vor dieser Änderung. „Null“, wenn das Metafeld gerade erst angelegt wurde
metafield.type	Text	Der Typ des Metafelds
eventId	Text	Die ID dieses Ereignisses. Suchen Sie danach im Ereignisverlauf der App, um genau zu sehen, was gesendet wurde.

Beispiel: Produkte kennzeichnen, deren Bewertung unter 3 liegt

1. Fügen Sie das Produkt-Metafeld auf der Seite „Metafeld-Trigger“ der App hinzu.
2. Wählen Sie „Produkt-Metafeld-Aktualisierung“ in Shopify Flow aus.
3. Bedingung hinzufügen: metafieldKey ist gleich reviews.rating.
4. Fügen Sie den Code „Run“ hinzu, um Zahlen zu vergleichen, da die Werte der Metafelder als Text übermittelt werden: return dropped: Number(input.metafield.value) < 3 && Number(input.metafield.previousValue) >= 3.
5. Fügen Sie eine Bedingung für die Ausgabe dropped des Codes hinzu und anschließend die Produkt-Tags low-rating.
6. Aktivieren Sie den Workflow.

Aktualisierung des Metafeldes „Produktvariante“

Wird ausgelöst, wenn sich ein überwachtes Varianten-Metafeld ändert. Das übergeordnete Produkt wird als Referenz übergeben, die Variante als resourceId.

Brände aus	Wird nach einem festgelegten Zeitplan überprüft, da Shopify hierfür keinen Webhook sendet
Genehmigung	Zugriff auf Produkt-, Varianten- und Kollektionsdaten
Eingeschaltet	Wenn Sie einen Flow-Workflow aktivieren, der diese Funktion nutzt, wird sie dadurch eingeschaltet. Der entsprechende Schalter befindet sich auf der Seite „Trigger“ der App.

Verwenden Sie es für

• Fassen Sie die Daten der Varianten auf der Produktebene zusammen, beispielsweise die kürzeste Lieferzeit aller Varianten.
• Attribute auf Variantenebene mit einem Feed synchronisieren.

Welche Daten werden bei der Aktualisierung des Metafelds „Produktvariante“ an Ihren Workflow übermittelt?

Variable in Shopify Flow	Typ	Was darin enthalten ist
product	Produkt (Shopify)	Das übergeordnete Produkt der Variante, deren Metafeld geändert wurde (verwenden Sie dies, um Produkt-Metafelder zu schreiben). Ein vollShopify Produkt, sodass alle seine Felder sowie die produktbezogenen Aktionen von Shopify Flow verfügbar sind.
resourceId	Text	Die GID der Produktvariante, deren Metafeld sich geändert hat
metafieldKey	Text	Der „namespace.key“ des Metafeldes, das sich geändert hat (zur Filterung in Shopify Flow)
metafield	Objekt	Das Metafeld, das aktualisiert wurde
metafield.id	ID	Globale ID des Metafeldes
metafield.namespace	Text	Der Namensraum des Metafelds
metafield.key	Text	Der Schlüssel des Metafeldes
metafield.value	Text	Der Wert des Metafelds
metafield.previousValue	Text	Der Wert vor dieser Änderung. Null, wenn das Metafeld gerade erst angelegt wurde
metafield.type	Text	Der Typ des Metafeldes
eventId	Text	Die ID dieses Ereignisses. Suchen Sie danach im Ereignisverlauf der App, um genau zu sehen, was gesendet wurde.

Beispiel: Kopieren eines Varianten-Metafelds bis hin zu seinem Produkt

1. Fügen Sie das Metafeld „Variante“ auf der Seite „Metafeld-Trigger“ hinzu.
2. Wählen Sie „Metafeld-Aktualisierung für Produktvariante“ in Shopify Flow aus.
3. Fügen Sie das Produkt-Metafeld „Update“ unter product mit dem Wert {{metafield.value}} hinzu.
4. Aktivieren Sie den Workflow.

Metafeld-Aktualisierung anweisen

Wird ausgelöst, wenn sich ein Metafeld einer überwachten Bestellung ändert, wobei die Bestellung als native Referenz dient.

Brände aus	Shopify Webhook plus Änderungserkennung
Genehmigung	Zugriff auf Daten der Bestellungen
Eingeschaltet	Wenn Sie einen Flow-Workflow aktivieren, der diese Funktion nutzt, wird sie dadurch eingeschaltet. Der entsprechende Schalter befindet sich auf der Seite „Trigger“ der App.

Verwenden Sie es für

• Reagieren Sie auf Daten, die Apps in Bestellungen eintragen: ein Liefertermin, eine Risikobewertung, eine ERP-Nummer.
• Leiten Sie die Fulfillment-Schritte ein, sobald sich der Status eines Genehmigungs-Metafelds ändert.

Welche Anweisung „Metafeld-Aktualisierung“ an Ihren Workflow sendet

Variable in Shopify Flow	Typ	Was darin enthalten ist
order	Bestellung (Shopify)	Die Bestellung, deren Metafeld geändert wurde. Es handelt sich um eine vollständige Shopify-Bestellung, sodass alle ihre Felder sowie die Shopify Flow-eigenen Bestellaktionen verfügbar sind.
metafieldKey	Text	Der „namespace.key“ des Metafelds, das sich geändert hat (zum Filtern in Shopify Flow)
metafield	Objekt	Das Metafeld, das aktualisiert wurde
metafield.id	ID	Globale ID des Metafeldes
metafield.namespace	Text	Der Namensraum des Metafelds
metafield.key	Text	Der Schlüssel des Metafelds
metafield.value	Text	Der Wert des Metafelds
metafield.previousValue	Text	Der Wert vor dieser Änderung. „Null“, wenn das Metafeld gerade erst angelegt wurde
metafield.type	Text	Der Typ des Metafeldes
eventId	Text	Die ID dieses Ereignisses. Suchen Sie danach im Ereignisverlauf der App, um genau zu sehen, was gesendet wurde.

Beispiel: Eine Bestellung freigeben, sobald das Metafeld „Genehmigung“ den Wert „wahr“ annimmt

1. Fügen Sie das Metafeld „Bestellung“ auf der Seite „Metafeld-Trigger“ hinzu.
2. Aktualisierung des Metafelds „Kommissionsreihenfolge“ in Shopify Flow.
3. Fügen Sie folgende Bedingung hinzu: metafieldKey ist gleich custom.approved und metafield.value ist gleich true.
4. Fügen Sie eine „For each“-Schleife für order.fulfillmentOrders mit der Option „Freigabe der Aussetzung des Fulfillment-Prozesses“ hinzu.
5. Aktivieren Sie den Workflow.

Aktualisierung des Kunden-Metafelds

Wird ausgelöst, wenn sich ein überwachtes Kunden-Metafeld ändert, wobei der Kunde als native Referenz dient.

Brände aus	Shopify Webhook und Änderungserkennung
Genehmigung	Zugriff auf Kundendaten
Eingeschaltet	Wenn Sie einen Flow-Workflow aktivieren, der diese Funktion nutzt, wird sie dadurch eingeschaltet. Der entsprechende Schalter befindet sich auf der Seite „Trigger“ der App.

Verwenden Sie es für

• Treuestufen, Kreditlimits oder Geburtstage, die in Metafelder gespeichert sind.
• Synchronisieren Sie Kundenattribute, die über Formulare oder Apps erfasst wurden, mit einem CRM-System.

Was die Aktualisierung des Kunden-Metafelds an Ihren Workflow übermittelt

Variable in Shopify Flow	Typ	Was darin enthalten ist
customer	Kunde (Shopify)	Der Kunde, dessen Metafeld sich geändert hat. Es handelt sich um einen Shopify-Kunden, sodass alle seine Felder sowie die Shopify Flow-eigenen Aktionen verfügbar sind.
metafieldKey	Text	Der Namespace.Key des Metafelds, das sich geändert hat (zum Filtern in Shopify Flow)
metafield	Objekt	Das Metafeld, das aktualisiert wurde
metafield.id	ID	Globale ID des Metafelds
metafield.namespace	Text	Der Namensraum des Metafelds
metafield.key	Text	Der Schlüssel des Metafelds
metafield.value	Text	Der Wert des Metafeldes
metafield.previousValue	Text	Der Wert vor dieser Änderung. Null, wenn das Metafeld gerade erst angelegt wurde
metafield.type	Text	Der Typ des Metafeldes
eventId	Text	Die ID dieses Ereignisses. Suchen Sie danach im Ereignisverlauf der App, um genau zu sehen, was gesendet wurde.

Beispiel: Kunden, die die Gold-Stufe erreichen, mit einem Tag versehen

1. Fügen Sie das Metafeld „Kunde“ auf der Seite „Metafeld-Trigger“ hinzu.
2. Wählen Sie in Shopify Flow „Aktualisierung des Kunden-Metafelds“ aus.
3. Fügen Sie eine Bedingung hinzu: metafieldKey ist gleich loyalty.tier und metafield.value ist gleich gold.
4. Fügen Sie die Kunden-Tags gold hinzu und senden Sie eine interne E-Mail an das VIP-Team.
5. Aktivieren Sie den Workflow.

Nächste Schritte

Die typbezogenen Trigger werden zusätzlich zum generischen Trigger ausgelöst und nutzen dessen Ereignis; daher wird das Aktivieren beider Trigger nicht doppelt auf Ihre Pläne angerechnet.

• Vollständige Referenz zu Triggern - alle Trigger auf einer Seite.
• Die Wahl des richtigen Triggers - welche davon auf Ihren Fall zutrifft.
• Benutzerdefinierte Trigger - Wenn kein vorgefertigter Trigger geeignet ist, erstellen Sie einen eigenen.
• Ereignisverlauf und Fehlerbehebung - Sehen Sie nach, was abgefeuert wurde und was es transportiert hat.