Obtenir des données d’analyse

L’action Obtenir des données d’analyse exécute une requête ShopifyQL et renvoie les résultats pour les utiliser dans votre flux de travail. ShopifyQL est un langage de requête conçu pour l’analyse du commerce. Vous pouvez l’utiliser pour agréger des indicateurs sur différentes périodes, appliquer des filtres et les regrouper par dimensions telles que le produit, la collection ou le client. Les données renvoyées par cette action sont disponibles pour les conditions et les actions qui suivent l’étape.

Astuce

ShopifyQL est également utilisé dans vos rapports Shopify et la segmentation client. Vous pouvez en apprendre davantage sur les requêtes et la syntaxe ShopifyQL.

Déclencheurs

L’action Obtenir des données d’analyse est uniquement compatible avec le déclencheur Heure prévue. Les données d’analyse ne sont pas incluses par les déclencheurs basés sur des événements.

Configuration

Champs

L’action Obtenir des données d’analyse contient le champ suivant :

Champs utilisés dans l’action Obtenir des données d’analyse.

Champ	Description
Requête ShopifyQL	Obligatoire. La requête ShopifyQL à exécuter sur les données d’analyse de votre boutique.

Requête ShopifyQL

Vous pouvez écrire toute requête ShopifyQL valide en utilisant les schémas pris en charge, tels que sales, sessions, inventory et payments. Par exemple, la requête suivante renvoie les ventes totales et le nombre de clients pour le jour de l’exécution du flux de travail :

FROM sales
  SHOW total_sales, customers
  SINCE today

Pour consulter la référence complète du langage, y compris les schémas, les fonctions et la syntaxe pris en charge, reportez-vous à la documentation de ShopifyQL.

La requête est validée lorsque vous enregistrez le flux de travail. Le flux de travail ne peut pas être activé tant que la requête n’a pas été exécutée avec succès sur votre boutique.

Données renvoyées

L’action Obtenir des données d’analyse renvoie les lignes qui correspondent à votre requête, disponibles sous forme de variable nommée getAnalyticsData. Les lignes sont stockées dans getAnalyticsData.rows, où chaque ligne est un objet indexé par les noms de colonnes de votre requête.

Vous pouvez utiliser cette variable dans les conditions et les actions qui suivent l’étape. Par exemple, pour envoyer un e-mail interne répertoriant chaque ligne, vous pouvez utiliser un code Liquid semblable à celui-ci :

{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}

Pour travailler avec chaque ligne individuellement, par exemple pour appliquer une action à chaque ligne, vous pouvez utiliser l’action Boucle For each (itérer) avec getAnalyticsData.rows. Pour agréger des valeurs, comme compter des lignes ou additionner une colonne, vous pouvez utiliser les actions Compter et Somme.

Remarque

Si une action Obtenir des données est utilisée plusieurs fois dans un seul flux de travail, un chiffre est ajouté au nom de la variable. Par exemple, dans un flux de travail qui utilise l’action Obtenir les données de la commande à deux reprises, 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é.

Référence de l’API

Pour plus d’informations sur l’API utilisée dans cette action, reportez-vous à la requête shopifyqlQuery de la GraphQL Admin API.

Complexité de la requête

Chaque requête ShopifyQL a un coût de complexité qui est calculé à partir des schémas, des colonnes, des filtres et de la plage de temps que la requête utilise. Si une requête dépasse la limite de complexité, l’action échoue et le flux de travail ne peut pas être activé. Pour réduire le coût d’une requête, vous pouvez raccourcir la plage de temps, supprimer des colonnes ou supprimer des jointures.

Pour plus de détails sur le mode de calcul du coût des requêtes et les limites actuelles, reportez-vous à la Limitation de débit dans l’Admin API ShopifyQL.