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 regrouper des indicateurs sur différentes périodes, appliquer des filtres et grouper des données 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 programmée. 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. Requête ShopifyQL à exécuter sur les données d’analyse de votre boutique.

Requête ShopifyQL

Vous pouvez écrire n’importe quelle requête ShopifyQL valide à l’aide des 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 obtenir la référence complète du langage, y compris les schémas, fonctions et syntaxes pris en charge, consultez 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’est pas exécutée avec succès dans votre boutique.

Données renvoyées

L’action Obtenir des données d’analyse renvoie les lignes correspondant à votre requête, disponibles sous la forme d'une variable nommée getAnalyticsData. Les lignes sont stockées dans getAnalyticsData.rows, où chaque ligne est un objet dont les clés correspondent aux noms des colonnes dans votre requête.

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

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

Pour travailler sur chaque ligne individuellement (par exemple, pour appliquer une action à chaque ligne), vous pouvez utiliser l’action Boucle For each (itération) avec getAnalyticsData.rows. Pour agréger des valeurs, comme compter le nombre de lignes ou additionner les valeurs d'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 même 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 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 en savoir plus sur l'API utilisée dans cette action, consultez la requête shopifyqlQuery dans 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 temporelle utilisés par la requête. 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 temporelle, supprimer des colonnes ou supprimer des jointures.

Pour plus d'informations sur la façon dont le coût des requêtes est calculé et sur les limites actuelles, consultez la section concernant les limites de débit de la ShopifyQL Admin API.