Déclencheurs de métachamps, étape par étape

Les « métachamps » permettent à une boutique de stocker les informations pour lesquelles Shopify ne dispose pas de champ dédié, et Shopify Flow ne peut pas réagir à leur modification. Ces cinq déclencheurs le peuvent, et ils transmettent des données de type previousValue, ce qui permet à un workflow de distinguer une augmentation d'une diminution.

Ils fonctionnent tous par définition : vous choisissez les métachamps à surveiller sur la page « Déclencheurs de métachamps » de l'application. Aucun déclencheur ne s'active pour un métachamp que vous n'avez pas ajouté à cet endroit. Consultez Déclencheurs de métachamps pour connaître la procédure de configuration.

Sur cette page : Mise à jour des métachamps, Mise à jour des métachamps des produits, Mise à jour des métachamps des variantes de produits, Mise à jour des métachamps des commandes, Mise à jour des métachamps des clients

Mise à jour de Métachamp

Se déclenche lorsqu'un métachamp surveillé change, quel que soit le type d'objet concerné : produit, variante, collection, client, commande, commande provisoire, entreprise, site de l'entreprise, blog, article de blog ou page.

Incendies provenant de	Shopify Webhook et détection des modifications. Les métachamps des variantes, des blogs, des articles de blog et des pages sont vérifiés selon un calendrier défini
Autorisation	Accès aux données relatives aux produits, aux variantes et aux collections
Allumé	Selon la définition du métachamp, sur la page « Déclencheurs de métachamps » de l'application

Utilisez-le pour

• Types d'entités ne disposant pas de déclencheur typé : collections, entreprises, pages, articles de blog.
• Un workflow qui surveille plusieurs métachamps et se ramifie en fonction de metafieldKey.

Ce que « Metafield Update » transmet à votre workflow

Variable de Shopify Flow	Type	Ce qu'il contient
metafieldKey	Texte	La clé « namespace.key » du métachamp qui a été mis à jour (pour le filtrage dans Shopify Flow)
resourceType	Texte	Le type de ressource (PRODUIT, VARIANTE DE PRODUIT, COLLECTION, CLIENT, COMMANDE, ENTREPRISE, SITE DE L'ENTREPRISE, ARTICLE, BLOG, PAGE)
resourceId	Texte	Le GID de la ressource qui a été mise à jour
metafield	Objet	Le métachamp qui a été mis à jour
metafield.id	ID	Identifiant global du métachamp
metafield.namespace	Texte	L'espace de noms du métachamp
metafield.key	Texte	La clé du métachamp
metafield.value	Texte	La valeur du métachamp
metafield.previousValue	Texte	Valeur avant cette modification. Nulle lorsque le métachamp vient d'être créé.
metafield.type	Texte	Le type du métachamp
eventId	Texte	L'identifiant de cet événement. Recherchez-le dans l'historique des événements de l'application pour voir exactement ce qui a été envoyé.

Exemple : réagir à la modification d'un métachamp de collection

1. Dans l'application, ouvrez « Metafield Déclencheurs », cliquez sur « Ajouter un déclencheur », sélectionnez le type de propriétaire « Collection » ainsi que la définition, puis enregistrez.
2. Dans Shopify Flow, sélectionnez « Mise à jour du métachamp » comme déclencheur.
3. Ajoutez une condition : metafieldKey est égal à custom.banner_text et resourceType est égal à COLLECTION.
4. Ajoutez l'option « Envoyer un e-mail interne » avec {{metafield.previousValue}} -> {{metafield.value}} et {{resourceId}}.
5. Activez le workflow.

Mise à jour des métachamps des produits

Se déclenche lorsqu'un métachamp d'un produit surveillé change, le produit étant une référence native de Shopify Flow.

Incendies provenant de	Shopify Webhook et détection des modifications
Autorisation	Accès aux données relatives aux produits, aux variantes et aux collections
Allumé	L'activation d'un workflow Shopify Flow qui l'utilise le met en marche. Son propre commutateur se trouve sur la page « Déclencheurs » de l'application.

Utilisez-le pour

• Agissez directement sur le produit : ajoutez-lui une balise, publiez-le, mettez à jour un autre métachamp.
• Seuils applicables aux métachamps numériques : une note, une prévision de stock, un délai de livraison d'un fournisseur.

Ce que la mise à jour du métachamp « Produit » transmet à votre workflow

Variable de Shopify Flow	Type	Ce qu'il contient
product	Produit (Shopify)	Le produit dont le métachamp a été modifié. Il s'agit d'un produit Shopify complet ; tous ses champs ainsi que les actions propres à Shopify Flow sont donc disponibles.
metafieldKey	Texte	Le paramètre « namespace.key » du métachamp qui a été modifié (pour le filtrage dans Shopify Flow)
metafield	Objet	Le métachamp qui a été mis à jour
metafield.id	ID	Identifiant global du métachamp
metafield.namespace	Texte	L'espace de noms du métachamp
metafield.key	Texte	La clé du métachamp
metafield.value	Texte	La valeur du métachamp
metafield.previousValue	Texte	Valeur antérieure à cette modification. Valeur nulle lorsque le métachamp vient d'être créé.
metafield.type	Texte	Le type du métachamp
eventId	Texte	L'identifiant de cet événement. Recherchez-le dans l'historique des événements de l'application pour voir exactement ce qui a été envoyé.

Exemple : baliser les produits dont la note est inférieure à 3

1. Ajoutez le métachamp « produit » sur la page « Déclencheurs de métachamps » de l'application.
2. Sélectionnez « Mise à jour du métachamp du produit » dans Shopify Flow.
3. Ajouter une condition : metafieldKey **est égal à « **reviews.rating ».
4. Ajoutez le code suivant pour comparer les nombres, car les valeurs des métachamps sont fournies sous forme de texte : return dropped: Number(input.metafield.value) < 3 && Number(input.metafield.previousValue) >= 3.
5. Ajoutez une condition sur la sortie dropped du code, puis **ajoutez les balises de produit « **low-rating ».
6. Activez le workflow.

Mise à jour des métachamps des variantes de produit

Se déclenche lorsqu'un métachamp de variante surveillé change. Le produit parent est transmis en tant que référence, et la variante en tant que resourceId.

Incendies provenant de	Vérification effectuée à intervalles réguliers, car Shopify n'envoie pas de webhook à cet effet
Autorisation	Accès aux données relatives aux produits, aux variantes et aux collections
Allumé	L'activation d'un workflow Flow qui l'utilise le met en marche. Son propre bouton de commande se trouve sur la page « Déclencheurs » de l'application.

Utilisez-le pour

• Regroupez les données relatives aux variantes au niveau du produit, par exemple le délai de livraison le plus court parmi toutes les variantes.
• Synchroniser les attributs au niveau des variantes avec un flux.

Ce que la mise à jour du métachamp « Variante de produit » transmet à votre workflow

Variable de Shopify Flow	Type	Ce qu'il contient
product	Produit (Shopify)	Le produit parent de la variante dont le métachamp a été modifié (utilisez-le pour créer des métachamps de produit). Il s'agit d'un produit Shopify complet ; tous ses champs ainsi que les actions propres au produit de Shopify Flow sont donc disponibles.
resourceId	Texte	Le GID de la variante de produit dont le métachamp a été modifié
metafieldKey	Texte	Le paramètre « namespace.key » du métachamp qui a été modifié (pour le filtrage dans Shopify Flow)
metafield	Objet	Le métachamp qui a été mis à jour
metafield.id	ID	Identifiant global du métachamp
metafield.namespace	Texte	L'espace de noms du métachamp
metafield.key	Texte	La clé du métachamp
metafield.value	Texte	La valeur du métachamp
metafield.previousValue	Texte	Valeur antérieure à cette modification. Valeur nulle lorsque le métachamp vient d'être créé.
metafield.type	Texte	Le type du métachamp
eventId	Texte	L'identifiant de cet événement. Recherchez-le dans l'historique des événements de l'application pour voir exactement ce qui a été envoyé.

Exemple : copier un métachamp de variante vers son produit

1. Ajoutez le méta-champ « variante » sur la page « Déclencheurs de métachamps ».
2. Sélectionnez la mise à jour du métachamp « Variante de produit » dans Shopify Flow.
3. Ajoutez le métachamp « Update product » sur product avec la valeur {{metafield.value}}.
4. Activez le workflow.

Mise à jour de la commande du métachamp

Se déclenche lorsqu’un métachamp d’une commande surveillée change, la commande servant de référence native.

Incendies provenant de	Shopify Webhook et détection des modifications
Autorisation	Accès aux données de commande
Allumé	L'activation d'un workflow Shopify Flow qui l'utilise le met en marche. Son propre commutateur se trouve sur la page « Déclencheurs » de l'application.

Utilisez-le pour

• Réagissez aux données que les applications enregistrent dans les commandes : une date de livraison, un score de risque, un numéro ERP.
• Lancez les étapes de traitement de la commande lorsqu'un métachamp d'approbation change d'état.

Qu'est-ce que la mise à jour « Order Metafield » envoie à votre workflow ?

Variable de Shopify Flow	Type	Ce qu'il contient
order	Commande (Shopify)	La commande dont le métachamp a été modifié. Il s'agit d'une commande complète issue de Shopify, ce qui signifie que tous ses champs ainsi que les actions propres à Shopify Flow relatives à cette commande sont disponibles.
metafieldKey	Texte	Le paramètre « namespace.key » du métachamp qui a été modifié (pour le filtrage dans Shopify Flow)
metafield	Objet	Le métachamp qui a été mis à jour
metafield.id	ID	Identifiant global du métachamp
metafield.namespace	Texte	L'espace de noms du métachamp
metafield.key	Texte	La clé du métachamp
metafield.value	Texte	La valeur du métachamp
metafield.previousValue	Texte	Valeur antérieure à cette modification. Valeur nulle lorsque le métachamp vient d'être créé.
metafield.type	Texte	Le type du métachamp
eventId	Texte	L'identifiant de cet événement. Recherchez-le dans l'historique des événements de l'application pour voir exactement ce qui a été envoyé.

Exemple : valider une commande lorsque le métachamp « approbation » prend la valeur « vrai »

1. Ajoutez le méta-champ « commande » sur la page « Déclencheurs de métachamps ».
2. Mise à jour du métachamp « Ordre de prélèvement » dans Shopify Flow.
3. Ajouter une condition : metafieldKey est égal à custom.approved et metafield.value est égal à true.
4. Ajoutez une boucle « For each » sur order.fulfillmentOrders avec la mention « Traitement de la commande : hold ».
5. Activez le workflow.

Mise à jour des métachamps clients

Se déclenche lorsqu’un métachamp client surveillé change, le client servant de référence native.

Incendies provenant de	Shopify Webhook et détection des modifications
Autorisation	Accès aux données clients
Allumé	L'activation d'un workflow Flow qui l'utilise le met en marche. Son propre commutateur se trouve sur la page « Déclencheurs » de l'application.

Utilisez-le pour

• Niveaux de fidélité, limites de crédit ou dates d'anniversaire enregistrés dans des métachamps.
• Synchronisez les attributs clients enregistrés via des formulaires ou des applications vers un CRM.

Ce que la mise à jour du métachamp « Client » transmet à votre workflow

Variable de Shopify Flow	Type	Ce qu'il contient
customer	Client (Shopify)	Le client dont le métachamp a été modifié. Il s'agit d'un client Shopify complet ; par conséquent, tous ses champs ainsi que les actions client propres à Shopify Flow sont disponibles.
metafieldKey	Texte	Le paramètre « namespace.key » du métachamp qui a été modifié (pour le filtrage dans Shopify Flow)
metafield	Objet	Le métachamp qui a été mis à jour
metafield.id	ID	Identifiant global du métachamp
metafield.namespace	Texte	L'espace de noms du métachamp
metafield.key	Texte	La clé du métachamp
metafield.value	Texte	La valeur du métachamp
metafield.previousValue	Texte	Valeur antérieure à cette modification. Valeur nulle lorsque le métachamp vient d'être créé.
metafield.type	Texte	Le type du métachamp
eventId	Texte	L'identifiant de cet événement. Recherchez-le dans l'historique des événements de l'application pour voir exactement ce qui a été envoyé.

Exemple : attribuez une balise aux clients qui atteignent le niveau « Or »

1. Ajoutez le méta-champ « client » sur la page « Déclencheurs de métachamps ».
2. Sélectionnez « Mise à jour du métachamp client » dans Shopify Flow.
3. Ajoutez une condition : metafieldKey est égal à loyalty.tier et metafield.value est égal à gold.
4. Ajoutez les balises client gold et envoyez un e-mail interne à l'équipe VIP.
5. Activez le workflow.

Prochaines étapes

Les déclencheurs typés s'activent en plus du déclencheur générique et partagent son événement ; ainsi, le fait de les activer tous les deux n'est pas comptabilisé deux fois dans votre forfait.

• Référence complète sur les déclencheurs - tous les déclencheurs sur une seule page.
• Choisir le bon déclencheur - celle qui correspond à votre situation.
• Déclencheurs personnalisés - si aucun déclencheur intégré ne convient, créez le vôtre.
• Historique des événements et dépannage - voir ce qui a tiré et ce qu'il transportait.