Obtenir les données des clients

Dans les flux de travail utilisant les données des clients, vous pouvez vous servir de l’action Obtenir les données des clients pour récupérer les données des clients dans votre boutique.

Remarque

Il s’agit d’un type d’action Obtenir des données. Pour comprendre comment utiliser ce type d’action avec le déclencheur Heure planifiée et les boucles Pour chaque, reportez-vous à ce guide.

Configuration

Champs

L’action Get customer data (Obtenir les données des clients) contient les champs suivants, qui sont utilisés pour créer la requête :

Champs utilisés dans les actions « Obtenir des données ».

Champ	Description
Trier les données par	Obligatoire. Paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximum de résultats	Obligatoire. La quantité maximale de résultats qui peut être renvoyée par la requête de recherche que vous sélectionnez. Vous pouvez en retourner jusqu’à 100 à la fois.
Requête	Obligatoire. Choisissez parmi les requêtes courantes ou sélectionnez Avancée pour créer les vôtres.

Chaîne de requête

Il s’agit d’un exemple de requête pour obtenir des clients qui ont été 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 dans la requête des clients et peut être utilisée plusieurs fois ou combinée à d’autres variables. La variable Liquid scheduledAt est disponible dans les flux de travail qui utilisent le déclencheur Date/heure prévues. La balise Liquid date_minus est une balise Flow spéciale, qui vous permet de soustraire du temps d’une date.

Lorsque vous requerrez des données, il est utile de connaître ce qui suit :

• Liste des filtres clients disponibles - Les requêtes doivent suivre une certaine syntaxe
• Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, les valeurs peuvent être trouvées en regardant les documents de l’API. Vous pouvez aussi souvent trouver les valeurs de champ dans les URL de l’interface administrateur lorsque vous filtrez. Par exemple, pour trouver des valeurs de requête de commande, filtrez la page Commandes dans l’interface administrateur, puis vérifiez l’URL.
• Vous pouvez exécuter ou tester une requête dans votre boutique à l’aide de l’application GraphiQL de Shopify.
• Sachez ce qui se produira si votre requête échoue. Souvent, l’API retournera tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste entre 0 et 100 ressource. Selon l’usage que vous en faites, vous voudrez peut-être utiliser ces données de différentes manières :

• Si vous devez gérer chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chacun.
• Si vous devez agréger les données, telles que le nombre de résultats retournés, vous pouvez utiliser les actions Quantité ou Somme.
• Si vous avez besoin d’une liste de sorties, comme 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 selon les étapes qui suivent cette action, utilisez la variable appelée Get customer data (Obtenir les données des clients), qui est une liste de collections. Vous pouvez utiliser cette variable à la fois dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste de collections dans une action Send internal email (Envoyer un e-mail interne) comme celle-ci :

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

Remarque

Si l’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 des commandes, la première variable pour les données renvoyées est getOrderData et la deuxième variable 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 dans le déclencheur Date/heure prévues. Dans un flux de travail utilisant le déclencheur Date/heure prévues, le flux démarre à un moment que vous avez spécifié, plutôt qu’à la suite d’un événement. Étant donné qu’il n’y a pas d’événement spécifique dans votre boutique ou provenant d’une application qui démarre le flux de travail, aucune donnée n’est incluse automatiquement.

Détails de l’API

• Ressource de client
• Filtres de requête de 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 est exécuté toutes les heures et récupère jusqu’à 100 clients qui n’ont pas la balise « traité ». Pour chaque client(e), 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 « traité » pour qu’elle ne soit pas renvoyée 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 dans votre boutique. Afficher le modèle

Supprimer les clients inactifs

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