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

L’application ShopifyQL Notebooks s’arrêtera à une date qui reste à confirmer. Actuellement, vous ne pourrez plus installer l’application depuis Shopify App Store et si vous la désinstallez, vous ne pourrez pas la réinstaller ultérieurement.

Vous pouvez migrer vos requêtes ShopifyQL manuellement vers les nouvelles analyses de données Shopify. Veuillez noter que les nouvelles analyses de données Shopify font appel à une version mise à jour de ShopifyQL. Par conséquent, certaines combinaisons d’ensembles de données et de dimensions nécessiteront peut-être des modifications pendant le processus de migration pour retourner les mêmes données dans les nouvelles analyses de données Shopify que dans l’application ShopifyQL Notebooks.

Pour vous assurer de ne pas perdre de données, vous pouvez également exporter vos ensembles de données depuis l’application ShopifyQL Notebooks à tout moment avant la date d’arrêt.

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 vous assurer que la requête est valide et utilise les 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 vos ensembles de données manuellement à l’aide des nouvelles analyses de données Shopify, ou si vous choisissez de migrer vos requêtes ShopifyQL existantes à partir de l’application Notebooks, consultez le tableau suivant qui répertorie les modifications apportées à certaines combinaisons d’ensembles de données et de dimensions de la version Notebooks de ShopifyQL vers la version des analyses de données mise à jour.

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 {#export-datasets}

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.