Migrar consultas ShopifyQL para as novas Análises da Shopify

O app ShopifyQL Notebooks será desativado em uma data ainda a ser confirmada. No momento, você não pode mais instalar o app da Shopify App Store e, se desinstalá-lo, não poderá reinstalá-lo depois.

Você pode migrar manualmente suas consultas ShopifyQL para o Shopify Analytics. Esteja ciente de que o novo Shopify Analytics utiliza uma versão atualizada do ShopifyQL, portanto, algumas combinações de conjuntos de dados e dimensões podem precisar ser ajustadas durante o processo de migração para garantir que os dados retornados no Shopify Analytics sejam os mesmos do app ShopifyQL Notebooks.

Para que você não perca dados, também é possível exportar seus conjuntos de dados do app ShopifyQL Notebooks a qualquer momento antes da data de desativação.

Nesta página

Migre suas consultas existentes do ShopifyQL para o novo Shopify Analytics

As novas Análises da Shopify usam uma versão atualizada do ShopifyQL em todos os relatórios padrão e personalizados, que é diferente da versão usada no app ShopifyQL Notebooks.

Você pode migrar manualmente suas consultas existentes do ShopifyQL para a versão atualizada no novo Shopify Analytics, criando uma exploração de dados personalizada baseada na sua consulta. Você pode então salvá-lo como um relatório personalizado e adicionar o relatório personalizado como um cartão ao seu painel de análise Visão geral em seu admin do Shopify.

Não é possível migrar automaticamente as consultas existentes em massa.

Saiba mais sobre como criar explorações de dados personalizadas usando as novas Análises da Shopify.

Etapas:

No admin da Shopify, acesse Configurações > Apps e canais de vendas.
Clique em ShopifyQL Notebooks.
Clique em Abrir app.
Na seção Notebooks, clique no notebook com o conjunto de dados que você deseja migrar.
Copie a consulta do ShopifyQL que você quer migrar.
No admin da Shopify, acesse Análises > Relatórios.
Clique em Nova exploração.
No editor de consultas do ShopifyQL, cole sua consulta existente.
Opcional: personalize sua consulta para garantir que ela seja válida e use os valores atualizados.
Clique em ▹ Executar.
Clique em Salvar.
Na caixa de diálogo Salvar relatório, dê um nome ao relatório personalizado e clique em Salvar.

Diferenças entre ShopifyQL em Notebooks e as novas Análises da Shopify

As novas Análises da Shopify usam uma versão atualizada do ShopifyQL em todos os relatórios padrão e personalizados, que é diferente da versão usada no app ShopifyQL Notebooks.

Algumas combinações de conjuntos de dados de tabela (usados como o valor FROM em uma consulta) e dimensões (usadas como um valor SHOW, GROUP BY, ORDER BY ou WHERE ) foram alteradas na versão atualizada do ShopifyQL e afeta como você pode escrever sua consulta.

Por exemplo, você pode escrever esta consulta do ShopifyQL no app Notebooks para agrupar os preços totais de frete por região e país de faturamento:

FROM orders
  SHOW shipping
  GROUP BY billing_country, billing_region

No entanto, o conjunto de dados pedidos e frete e a combinação de dimensões foram atualizados para vendas e frete nas novas Análises da Shopify. Portanto, para migrar essa consulta para a atualização ShopifyQL usando as novas Análises da Shopify, você deve modificar sua consulta conforme o exemplo a seguir:

FROM sales
  SHOW shipping_charges
  GROUP BY billing_country, billing_region

Atualização dos seus conjuntos de dados

Se você optar por recriar seus conjuntos de dados manualmente usando as novas Análises da Shopify ou se optar por migrar suas consultas existentes do app Notebooks, confira a tabela a seguir que lista as alterações em algumas das combinações de conjuntos de dados e dimensões da versão do Notebooks do ShopifyQL para obter a análise atualizada.

Porém, se elas não estiverem listadas, os valores permanecerão os mesmos em ambas as versões do ShopifyQL e não precisarão ser modificados na sua consulta para retornar os mesmos dados.

A tabela lista o conjunto de dados e as combinações de dimensões dos ShopifyQL Notebooks que foram atualizados nas novas Análises da Shopify.
ShopifyQL no Notebooks (conjunto de dados > dimensão)	ShopifyQL nas novas Análises da Shopify (conjunto de dados > dimensão)
`orders` > `discounts_adjustments`	Não há equivalente. Não existe nas novas Análises da Shopify .
`orders` > `gross_sales_adjustments`	Não há equivalente. Não existe nas novas Análises da Shopify .
`orders` > `net_product_quantity`	`sales` > `net_items_sold`
`orders` > `ordered_product_quantity`	`sales` > `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`	`sales` > `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`

## Exporte seus conjuntos de dados do ShopifyQL Notebooks {#export-datasets}

Depois que o ShopifyQL Notebooks for encerrado, você não poderá acessar o app nem fazer referência aos conjuntos de dados contidos nele. Se quiser salvar os conjuntos de dados existentes do ShopifyQL Notebooks para consulta posterior, exporte-os como arquivo CSV.

Etapas:

No admin da Shopify, acesse Configurações > Apps e canais de vendas.
Clique em ShopifyQL Notebooks.
Clique em Abrir app.
Na seção Notebooks, clique no notebook com o conjunto de dados que você deseja exportar.
No bloco de código com o conjunto de dados que você quer exportar, clique em ... e em ↥ Exportar resultado como arquivo CSV.
Clique em Exportar.