Obter dados do checkout abandonado
Em fluxos de trabalho que exigem dados do checkout abandonado, é possível usar a ação Obter dados do checkout abandonado para recuperar informações do checkout abandonado na loja. Os checkouts abandonados representam as sessões de checkout de clientes que foram iniciadas, mas não concluídas.
Configuração
Campos
A ação Obter dados do checkout abandonado contém os seguintes campos:
| Campo | Descrição |
|---|---|
| Classificar dados por | Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são classificados. |
| Número máximo de resultados | Obrigatório. A quantidade máxima de resultados que a consulta de pesquisa selecionada pode retornar. É possível retornar até 100 por vez. |
| Consulta | Obrigatório. Escolha entre consultas comuns ou selecione Avançado para criar as suas. |
String de consulta
Este é um exemplo de consulta para obter checkouts abandonados que foram criados no último dia:
created_at:>'{{ scheduledAt | date_minus: "1 day" }}'A variável created_at é um filtro disponível na consulta de checkouts abandonados que pode ser usado várias vezes ou combinado com outras variáveis. A variável do Liquid scheduledAt está disponível em fluxos de trabalho que usaram o acionador de Horário agendado. A tag do Liquid date_minus é uma tag especial do Shopify Flow que permite subtrair tempo de uma data.
Ao consultar dados, é útil saber:
As consultas devem seguir uma determinada sintaxe
Nem sempre os valores dos campos de consulta são documentados. Em alguns casos, é possível encontrar os valores consultando a documentação da API. Como alternativa, é comum encontrar os valores de campo nos URLs no painel do admin quando se aplica um filtro. Por exemplo, para encontrar alguns valores de consulta de pedidos, filtre a página Pedidos no painel do admin e, em seguida, verifique o URL.
É possível testar ou executar uma consulta na loja usando o app Shopify GraphiQL.
Tenha cuidado com o que acontece se a consulta falhar. Muitas vezes, a API retorna todos os resultados (em vez de nenhum).
Dados retornados
Todas as ações Obter dados retornam uma lista de 0 a 100 recursos. Dependendo do caso de uso, é possível usar esses dados de várias maneiras:
- Se for necessário processar cada item da lista individualmente, como adicionar uma tag a cada um, é possível usar a ação Para cada.
- Se for necessário agregar dados, como contar quantos resultados foram retornados, é possível usar as ações Contar ou Somar.
- Se for necessário gerar a lista, como para enviar um e-mail com todos os itens, é possível usar os dados retornados diretamente nas ações subsequentes.
Para acessar os dados retornados nas etapas seguintes a essa ação, use a variável Obter dados do checkout abandonado, que é uma lista de checkouts abandonados. Você pode usar essa variável tanto em condições quanto em ações. Por exemplo, é possível enviar a lista de checkouts abandonados em uma ação Enviar e-mail interno semelhante a esta:
{% for single_checkout in getAbandonedCheckoutData %}
* {{ single_checkout.email }} - {{ single_checkout.totalPrice }}
{% endfor %}Acionadores
É possível usar essa ação em qualquer fluxo de trabalho, inclusive com o acionador de Horário agendado. Em um fluxo de trabalho que usa o acionador de Horário agendado, o fluxo de trabalho é iniciado em um horário especificado, e não como resultado de um evento. Como não há um evento específico na loja ou originado de um app que inicie o fluxo de trabalho, não há dados incluídos automaticamente.
Referência da API
Para saber mais sobre a API usada nessa ação, consulte a Consulta de checkouts abandonados.