Obter dados de mercado

Em fluxos de trabalho que exigem dados do mercado, é possível usar a ação Obter dados de mercado para recuperar informações do mercado da loja na Shopify. Os Mercados são grupos de regiões ou locais definidos como meta para as vendas.

Nesta página

Configuração

Campos

A ação Obter dados de mercado contém os seguintes campos:

Campos usados nas ações Obter dados.
Campo	Descrição
Ordenar dados por	Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são ordenados.
Número máximo de resultados	Obrigatório. A quantidade máxima de resultados que podem ser retornados pela consulta de pesquisa selecionada. É possível retornar até 100 por vez.
Consulta	Obrigatório. Escolha entre consultas comuns ou selecione Avançado para criar a sua.

String de consulta

Este é um exemplo de consulta para obter todos os mercados ativos:

status:ACTIVE

A variável status é um filtro disponível na consulta Markets e pode ser usada várias vezes ou combinada a outras variáveis.

Ao consultar dados, é útil saber o seguinte:

Lista de filtros de mercado disponíveis
As consultas precisam seguir uma sintaxe específica
Os valores dos campos de consulta nem sempre são documentados. Em alguns casos, é possível encontrá-los na documentação da API. Outra opção é procurar esses valores nos URLs do admin ao aplicar filtros. Por exemplo, para encontrar alguns valores de consulta de pedidos, filtre a página Pedidos no admin e verifique o URL.
Você pode executar ou testar uma consulta na loja usando o app Shopify GraphiQL.
Tenha atenção ao que acontece se a consulta falhar. Muitas vezes, a API retorna todos os resultados (em vez de nenhum).

Dados retornados

Todas as ações Get data retornam uma lista de 0 a 100 recursos. Dependendo do caso de uso, você pode usar esses dados de várias maneiras:

Se for necessário lidar com cada item da lista individualmente, como adicionar uma tag a cada um, você poderá usar a ação For each.
Se for necessário agregar dados, como contar quantos resultados foram retornados, use as ações Count ou Sum.
Se você precisar gerar a lista, como para enviar um e-mail com todos os itens, os dados retornados poderão ser usados diretamente nas ações subsequentes.

Para acessar os dados retornados em etapas após essa ação, use a variável Get market data, que é uma lista de mercados. Essa variável pode ser usada em condições e ações. Por exemplo, você pode enviar a lista de mercados em uma ação Send internal email parecida com esta:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Acionadores

Você pode usar essa ação em qualquer fluxo de trabalho, incluindo o acionador Scheduled time. Com esse acionador, o fluxo de trabalho inicia em um horário especificado por você, e não como resultado de um evento. Como não há um evento específico na loja ou de um app que inicie o fluxo de trabalho, não há dados incluídos automaticamente.

Referência da API

Para obter mais informações sobre a API usada nessa ação, consulte a consulta Markets.