Obter dados de análise

A ação Obter dados de análise executa uma consulta do ShopifyQL e retorna os resultados para uso no fluxo de trabalho. O ShopifyQL é uma linguagem de consulta criada para análises de e-commerce. É possível usá-lo para agregar métricas em períodos, aplicar filtros e agrupar por dimensões, como produto, coleção ou cliente. Os dados retornados por essa ação ficam disponíveis para as condições e ações que seguem a etapa.

Dica

O ShopifyQL também é usado nos relatórios da Shopify e na segmentação de clientes. Saiba mais sobre as consultas e a sintaxe do ShopifyQL.

Acionadores

A ação Obter dados de análise é compatível apenas com o acionador de Horário programado. Os dados de análise não são incluídos por acionadores baseados em eventos.

Configuração

Campos

A ação Obter dados de análise contém o seguinte campo:

Campos usados na ação Obter dados de análise.

Campo	Descrição
Consulta do ShopifyQL	Obrigatório. A consulta do ShopifyQL a ser executada nos dados de análise da loja.

Consulta do ShopifyQL

É possível criar qualquer consulta do ShopifyQL válida usando os esquemas aceitos, como sales, sessions, inventory e payments. Por exemplo, a consulta a seguir retorna o total de vendas e o número de clientes para o dia em que o fluxo de trabalho é executado:

FROM sales
  SHOW total_sales, customers
  SINCE today

Para conferir a referência completa do idioma, incluindo esquemas aceitos, funções e sintaxe, consulte a documentação do ShopifyQL.

O sistema valida a consulta ao salvar o fluxo de trabalho. Não é possível ativar o fluxo de trabalho até que a consulta seja executada com êxito na loja.

Dados retornados

A ação Obter dados de análise retorna as linhas que correspondem à consulta, disponíveis como uma variável denominada getAnalyticsData. As linhas são armazenadas em getAnalyticsData.rows, em que cada linha é um objeto referenciado pelos nomes de coluna na consulta.

É possível usar essa variável tanto nas condições quanto nas ações que seguem a etapa. Por exemplo, para enviar um e-mail interno listando cada linha, você pode usar o Liquid de forma semelhante a esta:

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

Para trabalhar com cada linha individualmente, por exemplo, para aplicar uma ação a cada uma, é possível usar a ação Para cada loop (iterar) com getAnalyticsData.rows. Para agregar valores, como contar linhas ou somar uma coluna, você pode usar as ações Contar e Somar.

Observação

Se uma ação Obter dados for usada diversas vezes em um único fluxo de trabalho, um número será adicionado ao nome da variável. Por exemplo, em um fluxo de trabalho que usa a ação Obter dados do pedido duas vezes, a primeira variável dos dados retornados será getOrderData e a segunda será getOrderData1. Esse nome não pode ser personalizado.

Referência da API

Para ver mais informações sobre a API usada nessa ação, consulte a consulta shopifyqlQuery na GraphQL Admin API.

Complexidade da consulta

Cada consulta do ShopifyQL tem um custo de complexidade calculado a partir dos esquemas, das colunas, dos filtros e do intervalo de tempo usados na consulta. Se uma consulta exceder o limite de complexidade, a ação falhará e não será possível ativar o fluxo de trabalho. Para reduzir o custo de uma consulta, é possível encurtar o intervalo de tempo ou remover as colunas e as junções.

Para obter informações detalhadas sobre como o custo da consulta é calculado e os limites atuais, consulte Limites de taxa na ShopifyQL Admin API.