Metaveld-triggers, stap voor stap

Metavelden zijn de plaatsen waar een winkel gegevens opslaat waarvoor Shopify geen veld heeft, en Shopify Flow kan niet reageren op wijzigingen daarin. Deze vijf triggers kunnen dat wel - en ze bevatten previousValue, zodat een workflow een stijging van een daling kan onderscheiden.

Ze werken allemaal per definitie: u kiest zelf welke metavelden u wilt volgen op de pagina ‘Metafield Triggers’ van de app. Er wordt geen actie geactiveerd voor een metaveld dat u daar niet hebt toegevoegd. Zie Metaveld-triggers voor de instellingen.

Op deze pagina: Update van metavelden, Update van productmetavelden, Update van productvariantmetavelden, Update van ordermetavelden, Update van klantmetavelden

Metaveld-update

Wordt geactiveerd wanneer een bewaakt metaveld verandert, ongeacht het type eigenaar: product, variant, collectie, klant, bestelling, conceptbestelling, bedrijf, bedrijfslocatie, blog, blogbericht of pagina.

Branden als gevolg van	Shopify Webhook plus wijzigingsdetectie. De metavelden van varianten, blogs, blogberichten en pagina’s worden volgens een vast schema gecontroleerd
Toestemming	Toegang tot product-, variant- en collectiegegevens
Ingeschakeld	Per metaveld-definitie, op de pagina ‘Metaveld-triggers’ van de app

Gebruik het voor

• Typen van eigenaren die geen getypeerde trigger hebben: collecties, bedrijven, pagina’s, blogberichten.
• Een workflow die verschillende metavelden in de gaten houdt en op basis van metafieldKey vertakt.

Wat Metaveld Update naar uw workflow verzendt

Variabele in Shopify Flow	Type	Wat erin staat
metafieldKey	Tekst	De waarde van namespace.key van het metaveld dat is bijgewerkt (voor het filteren in Shopify Flow)
resourceType	Tekst	Het type resource (PRODUCT, PRODUCTVARIANT, Collectie, Klant, Bestelling, Bedrijf, COMPANYLOCATION, ARTICLE, BLOG, PAGE)
resourceId	Tekst	De GID van de bron die is bijgewerkt
metafield	Doel	Het metaveld dat is bijgewerkt
metafield.id	ID	Globale ID van het metaveld
metafield.namespace	Tekst	De naamruimte van het metaveld
metafield.key	Tekst	De sleutel van het metaveld
metafield.value	Tekst	De waarde van het metaveld
metafield.previousValue	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
metafield.type	Tekst	Het type van het metaveld
eventId	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om precies te zien wat er is verzonden.

Voorbeeld: Reageren op een gewijzigd metaveld in een collectie

1. Open in de app ‘Metafield Triggers’, klik op ‘Trigger toevoegen’, kies het eigenaartype ‘Collectie’ en de definitie, en sla deze op.
2. Kies in Shopify Flow ‘Metaveld Update’ als trigger.
3. Voeg een voorwaarde toe: metafieldKey is gelijk aan custom.banner_text en resourceType is gelijk aan COLLECTION.
4. Voeg de optie ‘Interne e-mail verzenden’ toe met {{metafield.previousValue}} -> {{metafield.value}} en {{resourceId}}.
5. Schakel de workflow in.

Update van productmetavelden

Wordt geactiveerd wanneer een metaveld van een in de gaten gehouden product verandert, waarbij het product als native Shopify Flow-referentie fungeert.

Branden als gevolg van	Shopify Webhook plus wijzigingsdetectie
Toestemming	Toegang tot product-, variant- en collectiegegevens
Ingeschakeld	Als u een Flow-workflow inschakelt waarin deze functie wordt gebruikt, wordt deze geactiveerd. De bijbehorende schakelaar bevindt zich op de pagina ‘Triggers’ van de app

Gebruik het voor

• Voer de handeling direct op het product uit: voorzie het van een tag, publiceer het, werk een ander metaveld bij.
• Drempelwaarden voor numerieke metavelden: een beoordeling, een voorraadprognose, een levertijd van een leverancier.

Wat de update van het productmetaveld naar uw workflow verzendt

Variabele in Shopify Flow	Type	Wat erin staat
product	Product (Shopify)	Het product waarvan het metaveld is gewijzigd. Een volledig Shopify-product, waardoor alle velden ervan en de eigen productacties van Shopify Flow beschikbaar zijn.
metafieldKey	Tekst	De namespace.key van het metaveld dat is gewijzigd (voor het filteren in Shopify Flow)
metafield	Doel	Het metaveld dat is bijgewerkt
metafield.id	ID	Globale ID van het metaveld
metafield.namespace	Tekst	De naamruimte van het metaveld
metafield.key	Tekst	De sleutel van het metaveld
metafield.value	Tekst	De waarde van het metaveld
metafield.previousValue	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
metafield.type	Tekst	Het type van het metaveld
eventId	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om precies te zien wat er is verzonden.

Voorbeeld: Producten taggen waarvan de beoordeling onder de 3 ligt

1. Voeg het productmetaveld toe op de pagina ‘Metaveld-triggers’ van de app.
2. Selecteer ‘Productmetaveld bijwerken’ in Shopify Flow.
3. Voeg een voorwaarde toe: metafieldKey is gelijk aan reviews.rating.
4. Voeg de volgende code toe om getallen te vergelijken, aangezien de waarden van metavelden als tekst worden weergegeven: return dropped: Number(input.metafield.value) < 3 && Number(input.metafield.previousValue) >= 3.
5. Voeg een voorwaarde toe aan de uitvoer van de code dropped en voeg vervolgens producttags toe low-rating.
6. Schakel de workflow in.

Update van het metaveld voor productvarianten

Wordt geactiveerd wanneer een gevolgd variant-metaveld verandert. Het bovenliggende product wordt als referentie doorgegeven, de variant als resourceId.

Branden als gevolg van	Wordt volgens een schema gecontroleerd, omdat Shopify hiervoor geen webhook verstuurt
Toestemming	Toegang tot product-, variant- en collectiegegevens
Ingeschakeld	Als u een Flow-workflow activeert waarin deze functie wordt gebruikt, wordt deze ingeschakeld. De bijbehorende schakelaar bevindt zich op de pagina ‘Triggers’ van de app.

Gebruik het voor

• Voer de gegevens van de varianten samen op productniveau, bijvoorbeeld de kortste levertijd van alle varianten.
• Synchroniseer kenmerken op variantniveau met een feed.

Welke gegevens worden door de update van het metaveld ‘Productvariant’ naar uw workflow verzonden

Variabele in Shopify Flow	Type	Wat erin staat
product	Product (Shopify)	Het bovenliggende product van de variant waarvan het metaveld is gewijzigd (gebruik dit om productmetavelden te schrijven). Een volledig Shopify-product, zodat alle velden ervan en de eigen productacties van Shopify Flow beschikbaar zijn.
resourceId	Tekst	De GID van de productvariant waarvan het metaveld is gewijzigd
metafieldKey	Tekst	De namespace.key van het metaveld dat is gewijzigd (voor filtering in Shopify Flow)
metafield	Doel	Het metaveld dat is bijgewerkt
metafield.id	ID	Globale ID van het metaveld
metafield.namespace	Tekst	De naamruimte van het metaveld
metafield.key	Tekst	De sleutel van het metaveld
metafield.value	Tekst	De waarde van het metaveld
metafield.previousValue	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
metafield.type	Tekst	Het type van het metaveld
eventId	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om precies te zien wat er is verzonden.

Voorbeeld: Een variantmetaveld kopiëren naar het bijbehorende product

1. Voeg het metaveld ‘variant’ toe op de pagina ‘Metaveldtriggers’.
2. Selecteer ‘Productvariant-metaveld bijwerken’ in Shopify Flow.
3. Voeg het metaveld „Update product“ toe op product met de waarde {{metafield.value}}.
4. Schakel de workflow in.

Bestelling voor bijwerking van metavelden

Wordt geactiveerd wanneer een metaveld van een in de gaten gehouden bestelling verandert, waarbij de bestelling als native-referentie fungeert.

Branden als gevolg van	Shopify Webhook plus wijzigingsdetectie
Toestemming	Toegang tot gegevens over bestellingen
Ingeschakeld	Als u een Flow-workflow inschakelt waarin deze functie wordt gebruikt, wordt deze geactiveerd. De bijbehorende schakelaar bevindt zich op de pagina ‘Triggers’ van de app

Gebruik het voor

• Reageer op gegevens die apps in bestellingen vastleggen: een leverdatum, een risicoscore, een ERP-nummer.
• Start de afhandelingstappen zodra een goedkeuringsmetaveld van status verandert.

Welke bestelling 'Metaveld Update' naar uw workflow verzendt

Variabele in Shopify Flow	Type	Wat erin staat
order	Bestelling (Shopify)	De bestelling waarvan het metaveld is gewijzigd. Een volledige Shopify-bestelling, zodat alle velden ervan en de eigen bestellingsacties van Shopify Flow beschikbaar zijn.
metafieldKey	Tekst	De namespace.key van het metaveld dat is gewijzigd (voor het filteren in Shopify Flow)
metafield	Doel	Het metaveld dat is bijgewerkt
metafield.id	ID	Globale ID van het metaveld
metafield.namespace	Tekst	De naamruimte van het metaveld
metafield.key	Tekst	De sleutel van het metaveld
metafield.value	Tekst	De waarde van het metaveld
metafield.previousValue	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
metafield.type	Tekst	Het type van het metaveld
eventId	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om precies te zien wat er is verzonden.

Voorbeeld: Een bestelling vrijgeven wanneer het metaveld ‘goedkeuring’ de waarde ‘waar’ krijgt

1. Voeg het metaveld ‘bestelling’ toe op de pagina ‘Metaveld Triggers’.
2. Update van het metaveld ‘Pick Order’ in Shopify Flow.
3. Voeg een voorwaarde toe: metafieldKey is gelijk aan custom.approved en metafield.value is gelijk aan true.
4. Voeg een „For each“-lus toe voor order.fulfillmentOrders met de optie „Release afhandeling hold“.
5. Schakel de workflow in.

Update van het metaveld ‘Klant’

Wordt geactiveerd wanneer een gevolgd metaveld van een klant verandert, waarbij de klant als native referentie fungeert.

Branden als gevolg van	Shopify Webhook plus wijzigingsdetectie
Toestemming	Toegang tot klantgegevens
Ingeschakeld	Als u een Flow-workflow inschakelt waarin deze functie wordt gebruikt, wordt deze geactiveerd. De bijbehorende schakelaar bevindt zich op de pagina ‘Triggers’ van de app

Gebruik het voor

• Loyaliteitsniveaus, kredietlimieten of verjaardagen die in metavelden worden opgeslagen.
• Synchroniseer klantkenmerken die via formulieren of apps zijn ingevoerd met een CRM-systeem.

Wat de update van het metaveld ‘Klant’ naar uw workflow verzendt

Variabele in Shopify Flow	Type	Wat erin staat
customer	Klant (Shopify)	De klant waarvan het metaveld is gewijzigd. Het betreft een klant met een Shopify-abonnement, waardoor alle velden en de eigen klantacties van Shopify Flow beschikbaar zijn.
metafieldKey	Tekst	De namespace.key van het metaveld dat is gewijzigd (voor het filteren in Shopify Flow)
metafield	Doel	Het metaveld dat is bijgewerkt
metafield.id	ID	Globale ID van het metaveld
metafield.namespace	Tekst	De naamruimte van het metaveld
metafield.key	Tekst	De sleutel van het metaveld
metafield.value	Tekst	De waarde van het metaveld
metafield.previousValue	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
metafield.type	Tekst	Het type van het metaveld
eventId	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om precies te zien wat er is verzonden.

Voorbeeld: Klanten die het gouden niveau bereiken, van een tag voorzien

1. Voeg het metaveld ‘klant’ toe op de pagina ‘Metaveldtriggers’.
2. Selecteer ‘Update van het metaveld van de klant’ in Shopify Flow.
3. Voeg een voorwaarde toe: metafieldKey is gelijk aan loyalty.tier en metafield.value is gelijk aan gold.
4. Voeg de klanttags gold toe en stuur een interne e-mail naar het VIP-team.
5. Schakel de workflow in.

Volgende stappen

De getypeerde triggers worden naast de algemene trigger geactiveerd en delen dezelfde gebeurtenis; het inschakelen van beide telt dus niet dubbel mee voor uw abonnement.

• Volledig overzicht van de triggers - alle triggers op één pagina.
• De juiste trigger kiezen - welke optie in uw geval van toepassing is.
• Aangepaste triggers - als er geen ingebouwde trigger geschikt is, schrijf dan uw eigen trigger.
• Gebeurtenisgeschiedenis en probleemoplossing - nagaan wat er is afgevuurd en wat het vervoerde.