Récupérer les données client

Dans les flux de travail qui utilisent des données client, vous pouvez utiliser l’action Récupérer les données client pour récupérer les informations sur les clients de votre boutique.

Remarque

Il s’agit d’un type d’action Récupérer des données. Pour comprendre comment utiliser ce type d’action avec le déclencheur Heure programmée et les boucles Pour chaque, reportez-vous à Programmation, récupération de données et boucles de flux de travail dans Shopify Flow.

Configuration

Champs

L’action Récupérer les données client contient les champs suivants, qui sont utilisés pour créer la requête :

Champs utilisés dans les actions Récupérer des données.

Champ	Description
Trier les données par	Requis. Les paramètres selon lesquels les données retournées par la requête de recherche sont triées.
Nombre maximum de résultats	Requis. 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ête	Requis. 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 clients mis à jour au cours du dernier jour :

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variable updated_at est un filtre disponible sur la requête Clients et peut être utilisée plusieurs fois ou combinée à d’autres variables. La variable Liquid scheduledAt est disponible sur les flux de travail qui utilisent le déclencheur Heure programmée. La balise Liquid date_minus est une balise Flow spéciale qui vous permet de soustraire du temps à une date.

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

• Liste des filtres de clients 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 les valeurs en consultant la documentation de l’API. Sinon, vous pouvez souvent trouver les valeurs des champs dans les URL de l’interface administrateur lorsque vous appliquez un filtre. Par exemple, pour trouver des 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’application Shopify GraphiQL.
• Tenez compte de 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 Obtenir des données renvoient une liste de 0 à 100 ressources. Selon votre cas d’utilisation, vous pouvez utiliser ces données de différentes manières :

• Si vous devez traiter chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chaque.
• Si vous devez agréger des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez utiliser les actions Compter ou Somme.
• Si vous devez utiliser la liste en sortie, par exemple pour envoyer un e-mail contenant 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 Obtenir les données client, qui est une liste de clients. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des commandes dans une action Envoyer un e-mail interne comme ceci :

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

Remarque

Si une action Obtenir des données est utilisée plusieurs fois dans un même flux de travail, un numéro est ajouté au nom de la variable. Par exemple, dans un flux de travail qui utilise deux fois l’action Obtenir les données de commande, la première variable pour les données renvoyées est getOrderData et la deuxième est getOrderData1. Ce nom ne peut pas être personnalisé.

Déclencheurs

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

Détails de l’API

• Ressource client
• Filtres de requête client

Modèles

Convertir un champ méta de client en balises pour tous les clients

Ce flux de travail complétera les balises de tous vos clients en fonction d’une valeur de champ méta. Il s’exécute toutes les heures et récupère jusqu’à 100 clients qui n’ont pas la balise « processed ». Pour chaque client, il examine la valeur d’un champ méta custom.test et l’ajoute en tant que balise. Le flux de travail ajoute également une balise « processed » afin que le client ne soit pas renvoyé lors de la prochaine exécution programmée du flux de travail. Pour utiliser le flux de travail, vous devrez modifier l’espace de nom et la clé du champ méta pour qu’ils correspondent à un champ méta de votre boutique. Afficher le modèle

Supprimer les clients inactifs

Supprime les clients de plus de 5 ans qui n’ont jamais passé de commande. Afficher le modèle