Migration des requêtes ShopifyQL vers les nouvelles analyses de données Shopify

L’application ShopifyQL Notebooks a cessé de fonctionner le 5 mai 2025. Vous ne pouvez plus l’installer depuis Shopify App Store et, si vous la désinstallez, vous ne pourrez pas la réinstaller ultérieurement.

Vous pouvez migrer manuellement vos requêtes ShopifyQL vers les nouvelles analyses de données Shopify. Ces nouvelles analyses utilisent une version actualisée de ShopifyQL, ce qui pourrait nécessiter l’ajustement de certaines combinaisons d’ensembles de données et de dimensions pendant le processus de migration afin d’obtenir des résultats identiques à ceux que générait l’application ShopifyQL Notebooks.

Pour éviter toute perte de données, nous vous recommandons d’exporter vos ensembles de données depuis l’application ShopifyQL Notebooks avant la date de fermeture définitive.

Sur cette page

Migrer vos requêtes ShopifyQL existantes vers les nouvelles analyses de données Shopify

Les nouvelles analyses de données Shopify utilisent une version mise à jour de ShopifyQL dans tous les rapports par défaut et personnalisés, qui est différente de la version utilisée dans l’application ShopifyQL Notebooks.

Vous pouvez migrer manuellement vos requêtes ShopifyQL existantes vers la version mise à jour de ShopifyQL dans les nouvelles analyses de données Shopify en créant une exploration de données personnalisée à l’aide de votre requête. Vous pouvez ensuite l’enregistrer comme un rapport personnalisé et ajouter le rapport personnalisé en tant que carte à votre tableau de bord des analyses de données dans votre interface administrateur Shopify.

Vous ne pouvez pas migrer automatiquement vos requêtes existantes en bloc.

En savoir plus sur la création d’explorations de données personnalisées à l’aide des nouvelles analyses de données Shopify.

Étapes :

Depuis votre interface administrateur Shopify, cliquez sur Paramètres > Applications et canaux de vente.
Cliquez sur ShopifyQL Notebooks.
Cliquez sur Ouvrir l’application.
Dans la section Carnets, cliquez sur le carnet avec l’ensemble de données que vous souhaitez migrer.
Copiez la requête ShopifyQL que vous souhaitez migrer.
Depuis votre interface administrateur Shopify, allez à Analyses de données > Rapport.
Cliquez sur Nouvelle exploration.
Dans l’éditeur de requête ShopifyQL, collez votre requête existante.
Facultatif : personnalisez votre requête pour garantir sa validité et son utilisation des valeurs mises à jour.
Cliquez sur ▹ Exécuter.
Cliquez sur Enregistrer.
Dans la boîte de dialogue Enregistrer le rapport, nommez votre rapport personnalisé, puis cliquez sur Enregistrer.

Différences entre ShopifyQL dans Notebooks et les nouvelles analyses de données Shopify

Certaines combinaisons d’ensembles de données de table (utilisés comme valeur FROM dans une requête) et de dimensions (utilisées comme valeur SHOW, GROUP BY, ORDER BY ou WHERE) ont été modifiées dans la version mise à jour de ShopifyQL, ce qui affecte la façon dont vous pouvez rédiger votre requête.

Par exemple, vous pouvez rédiger cette requête ShopifyQL dans l’application Notebooks pour regrouper les frais d’expédition totaux par pays et région de facturation :

FROM orders
  SHOW shipping
  GROUP BY billing_country, billing_region

Cependant, la combinaison d’ensemble de données et de dimensions orders et shipping a été mise à jour pour devenir sales et shipping_charges dans les nouvelles analyses de données Shopify. Par conséquent, pour migrer cette requête vers la mise à jour de ShopifyQL à l’aide de la nouvelle analyse de données Shopify, vous devez modifier votre requête selon l’exemple suivant :

FROM sales
  SHOW shipping_charges
  GROUP BY billing_country, billing_region

Mise à jour de vos ensembles de données

Si vous choisissez de recréer manuellement vos ensembles de données à l’aide des nouvelles analyses de données Shopify ou de migrer vos requêtes ShopifyQL existantes depuis l’application Notebooks, consultez le tableau ci-dessous qui répertorie les modifications apportées à certaines combinaisons d’ensembles de données et de dimensions entre la version Notebooks de ShopifyQL et la version mise à jour des analyses de données.

Si une combinaison d’ensembles de données et de dimensions n’est pas indiquée ci-dessous, les valeurs restent les mêmes dans les deux versions de ShopifyQL et ne doivent pas être modifiées dans votre requête pour retourner les mêmes données.

Tableau indiquant les combinaisons d’ensembles de données et de dimensions de ShopifyQL Notebooks qui ont été mises à jour dans les nouvelles analyses de données Shopify.
ShopifyQL dans Notebooks (ensemble de données > dimension)	ShopifyQL dans les nouvelles analyses de données Shopify (ensemble de données > dimension)
`orders` > `discounts_adjustments`	Aucun équivalent. N’existe pas dans les nouvelles analyses de données Shopify.
`orders` > `gross_sales_adjustments`	Aucun équivalent. N’existe pas dans les nouvelles analyses de données Shopify.
`commandes` > `net_product_quantity`	`sales` > `net_items_sold`
`orders` > `ordered_product_quantity`	`ventes` > `quantity_ordered`
`orders` > `returned_product_quantity`	`sales` > `quantity_returned`
`orders` > `shipping`	`sales` > `shipping_charges`
`products` > `cart_sessions`	`sessions` > `sessions_with_cart_additions`
`products` > `checkout_purchase_sessions`	`sales` > `sessions_that_reached_and_completed_checkout`
`products` > `checkout_sessions`	`sessions` > `sessions_that_reached_checkout`
`products` > `checkout_to_purchase_rate`	`sessions` > `checkout_conversion_rate`
`products` > `purchase_sessions`	`sessions` > `sessions_that_completed_checkout`
`products` > `quantity_purchased`	`ventes` > `quantity_ordered`
`products` > `view_cart_checkout_purchase_sessions`	`sessions` > `sessions_that_completed_checkout_closed_funnel`
`products` > `view_cart_checkout_sessions`	`sessions` > `sessions_that_reached_checkout_closed_funnel`
`products` > `view_cart_checkout_to_purchase_rate`	`sessions` > `completed_checkout_rate`
`products` > `view_cart_sessions`	`sessions` > `sessions_with_cart_additions`
`products` > `view_purchase_sessions`	`sessions` > `sessions_that_completed_checkout`
`products` > `view_sessions`	`sessions` > `sessions`
`products` > `view_to_cart_rate`	`sessions` > `added_to_cart_rate`
`products` > `view_to_checkout_rate`	`sessions` > `reached_checkout_rate`
`products` > `view_to_purchase_rate`	`sessions` > `conversion_rate`

Exporter vos ensembles de données ShopifyQL Notebooks

Après la fermeture de ShopifyQL Notebooks, vous ne pourrez pas accéder à l’application ni référencer les ensembles de données qu’elle contient. Si vous souhaitez enregistrer vos ensembles de données ShopifyQL Notebooks existants pour les référencer ultérieurement, exportez-les en tant que fichier CSV.

Étapes :

Depuis votre interface administrateur Shopify, cliquez sur Paramètres > Applications et canaux de vente.
Cliquez sur ShopifyQL Notebooks.
Cliquez sur Ouvrir l’application.
Dans la sections Carnets, cliquez sur le carnet avec l’ensemble de données que vous souhaitez exporter.
Dans le bloc de code contenant l’ensemble de données que vous souhaitez exporter, cliquez sur ..., puis cliquez sur ↥ Exporter le résultat en tant que fichier CSV.
Cliquez sur Exporter.