Obtenir les données de réduction

Dans les flux de travail qui nécessitent des données de réduction, vous pouvez utiliser l’action Obtenir les données de réduction pour récupérer les informations sur les réductions de votre boutique.

Configuration

Champs

L’action Obtenir les données de réduction contient les champs suivants, qui sont utilisés pour élaborer la requête :

Champs utilisés dans les actions Obtenir des données.
ChampDescription
Trier les données parRequis. Les paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximal de résultatsRequis. Le nombre maximal de résultats que peut renvoyer la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à la fois.
RequêteRequis. Choisissez parmi les requêtes courantes ou sélectionnez Avancé pour créer la vôtre.

Chaîne de requête

Voici un exemple de requête pour obtenir les réductions actives qui utilisent un code :

method:code AND status:active

Les variables method et status sont des filtres disponibles sur la requête de nœud de réduction et peuvent être utilisées plusieurs fois ou combinées à d’autres variables.

Lorsque vous effectuez des requêtes sur des données, il est utile de connaître les points suivants :

  • Liste des filtres de réduction disponibles.
  • Les requêtes doivent respecter une certaine syntaxe
  • Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, vous pouvez trouver ces valeurs en consultant la documentation de l’API. Vous pouvez aussi souvent trouver les valeurs des champs dans les URL de votre interface administrateur lorsque vous appliquez un filtre. Par exemple, pour trouver certaines valeurs de requête de commande, filtrez la page Commandes dans votre interface administrateur, puis vérifiez l’URL.
  • Vous pouvez exécuter ou tester une requête dans votre boutique en utilisant l’appli Shopify GraphiQL.
  • Faites attention à ce qui se passe si votre requête échoue. Souvent, l’API renvoie tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Get data renvoient une liste de 0 à 100 ressources. Selon votre cas d’utilisation, vous pouvez utiliser ces données de plusieurs manières :

  • Si vous devez traiter chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action For each.
  • Si vous devez agréger des données, par exemple compter le nombre de résultats renvoyés, vous pouvez utiliser les actions Count ou Sum.
  • Si vous avez besoin de la liste en sortie, par exemple pour envoyer un e-mail avec tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions suivantes.

Pour accéder aux données renvoyées dans les étapes qui suivent cette action, utilisez la variable nommée Get discount data, qui est une liste de réductions. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des réductions d’applis automatiques dans une action Send internal email comme celle-ci :

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Déclencheurs

Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris avec le déclencheur Scheduled time. Dans un flux de travail qui utilise le déclencheur Scheduled time, le flux de travail démarre à une heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Étant donné qu’aucun événement spécifique dans votre boutique ou provenant d’une appli ne démarre le flux de travail, aucune donnée n’est automatiquement incluse.

Détails de l’API

Modèles

Résumé hebdomadaire par e-mail des réductions actives avec code

Envoie par e-mail un résumé des réductions actives qui utilisent un code. Le flux de travail s’exécute de manière planifiée tous les lundis à 9 h. Le flux de travail peut être personnalisé pour modifier la planification, la manière dont vous recevez le résumé, le type de réductions que vous souhaitez inclure et le mode. Afficher le modèle