Criar notebooks
O app ShopifyQL Notebooks permite que você consulte os dados de sua loja, crie visualizações, além de gerar relatórios (chamados notebooks) sobre sua loja combinando diferentes visualizações de dados com blocos de texto. Por exemplo, é possível criar um notebook para descobrir o total de vendas de produtos e outro para ajudar a entender quais produtos estão contribuindo mais para as margens de lucro. Você pode criar quantos notebooks quiser.
Nesta página
Instalar o app ShopifyQL Notebooks
Acesse a página do ShopifyQL Notebooks na Shopify App Store.
Clique em Adicionar app.
Faça login na loja da Shopify na qual você quer instalar o app ShopifyQL Notebooks.
Para concordar em compartilhar os dados necessários com o app ShopifyQL Notebooks, clique em Instalar app.
Depois que o app for instalado na loja, crie um novo notebook.
Criar um novo notebook
Um notebook é um conjunto de blocos de conteúdo que você cria e coloca no pedido que desejar. Há diferentes tipos de blocos que podem ser usados para criar seu notebook:
Use uma combinação de visualizações de dados, como gráficos, tabelas e texto, para contar a história dos dados.
Criar um novo notebook
No admin da Shopify, clique em Configurações > Apps e canais de vendas.
Na página Apps e canais de vendas, clique em ShopifyQL Notebooks.
Clique em Abrir app.
Clique em Criar notebook.
-
O novo notebook tem um único bloco de código por padrão. Siga um destes procedimentos:
- Escolha um modelo para o bloco de código.
- Escreva seu próprio bloco de código.
Opcional: adicione outros blocos de código ou blocos de texto ao seu notebook passando o cursor do mouse onde você desejar adicionar o bloco e selecionando Bloco de texto ou Bloco de código.
Para salvar seu notebook, clique no botão
...e em Nome.Insira um nome para o notebook e clique em Salvar.
Depois de salvar, você poderá exportar ou editar o notebook.
Blocos de texto
Um bloco de texto permite adicionar um texto com estilo ou uma imagem estática ao seu notebook, e pode ser usado para títulos em notebooks, apresentações ou descrições de visualizações de dados.
Blocos de código
Adicione uma consulta ao notebook com blocos de código que use a linguagem de consulta do ShopifyQL para retornar dados sobre a sua loja. No bloco de código, é possível escolher como os dados serão exibidos no notebook. Saiba mais sobre como usar o ShopifyQL para notebooks.
Modelos
Os modelos são consultas do ShopifyQL pré-escritas para usar no formato original ou como um ponto de partida para criar sua própria consulta. Quando você cria um bloco de código, clique em Modelos e selecione um modelo na lista. Eles estão disponíveis para várias visualizações de dados, por exemplo:
- Vendas ao longo do tempo
- Principais produtos convertidos
- Produtos mais vendidos
Preenchimento automático
O ShopifyQL Notebooks fornece automaticamente sugestões para a consulta conforme você escreve o bloco de código. Clique na sugestão para adicioná-la à consulta ou continue digitando seu próprio código.
Exportar um notebook
No admin da Shopify, clique em Configurações > Apps e canais de vendas.
Na página Apps e canais de vendas, clique em ShopifyQL Notebooks.
Clique em Abrir app.
Na seção Notebooks, clique no notebook que você deseja exportar.
Clique no botão
...e em Modo de apresentação.Clique em Exportar.
Receberá seu notebook como um arquivo PNG.
Editar um notebook
No admin da Shopify, clique em Configurações > Apps e canais de vendas.
Na página Apps e canais de vendas, clique em ShopifyQL Notebooks.
Clique em Abrir app.
Na seção Notebooks, clique no notebook.
Edite, adicione ou exclua blocos do seu notebook.
Clique em Salvar para salvar suas alterações.
Usar o Liquid para fazer referência aos dados
É possível criar histórias de dados dinâmicos usando o Liquid, a linguagem de modelos da Shopify, para fazer referência a dados no ShopfyQL Notebooks. Uma referência é um elemento de dados de um bloco de código ShopifyQL e pode ser editada usando o Liquid dentro de um bloco de texto.
Etapas:
No admin da Shopify, clique em Configurações > Apps e canais de vendas.
Na página Apps e canais de vendas, clique em ShopifyQL Notebooks.
Clique em Abrir app.
Na seção Notebooks, clique no notebook.
Encontre o texto em que você deseja criar uma referência.
Clique em Adicionar referência para abrir o editor do Liquid.
Insira o código do Liquid do elemento de dados que você deseja referenciar.
Use as sugestões de preenchimento automático para referências, linhas e colunas disponíveis de modo a garantir a precisão.
Clique em Aplicar para salvar sua referência.
Como executar um Notebook
Ao carregar um ShopifyQL Notebook, você verá blocos de texto e código no estado executado anteriormente. É possível usar essa visualização para entender o trabalho anterior, mas ela pode não mostrar os dados mais recentes. Para os ver, use uma das seguintes opções:
Execute blocos de código individuais de novo: para obter os dados mais recentes, execute outra vez os blocos de código relevantes clicando em Executar para cada bloco.
Execute todos os blocos de código: atualize todos os dados do seu notebook e execute todos os blocos de código clicando em Executar tudo.
Vale lembrar que, ao executar um bloco de código de novo, todas as referências vinculadas a ele são atualizadas automaticamente, assim as histórias dos dados mostrarão as informações mais recentes.