Como funcionam os gatilhos

Compreender qual dos quatro mecanismos um gatilho utiliza explica praticamente todas as dúvidas sobre o tempo de acionamento, a configuração e o motivo pelo qual algo disparou ou não.

Os quatro mecanismos

Mecanismo Gatilhos Latência É preciso definir uma linha de base Entrega
Shopify webhook 26 Quase em tempo real Não Garantido
Webhook + detecção de alterações 52 Quase em tempo real Sim Garantido
Pesquisa de opinião 6 Até um intervalo de pesquisa Sim Garantido
Pixel da vitrine 14 Segundos Não Melhor esforço possível

1. Webhook do Shopify

Shopify notifica o aplicativo assim que o evento ocorre, e o aplicativo o encaminha diretamente para Shopify Flow. Os eventos “Desconto criado” e “Localização excluída” funcionam dessa maneira.

Esses gatilhos não exigem nenhuma configuração além da permissão e cada um deles possui seu próprio botão na página “Gatilhos”.

2. Webhook e detecção de alterações

Esse é o maior grupo e é o que torna o aplicativo útil. O webhook products/update do Shopify é acionado sempre que um produto é editado, mas não informa o que foi alterado. Portanto, o aplicativo:

  1. armazena um instantâneo dos campos que são importantes para você,
  2. compara cada webhook recebido com esse instantâneo e
  3. aciona o gatilho específico somente quando esse campo específico for realmente alterado.

É assim que o webhook “Product Title Changed” pode ser acionado quando o título é editado e não ser acionado quando o preço é editado, mesmo que ambos cheguem como o mesmo webhook Shopify.

3. Pesquisa de opinião

Shopify Não publica webhooks para blogs, posts de blog, páginas, status de exibição de pedidos, vencimento de descontos ou configurações fiscais relacionadas à localização da empresa. Para esses seis gatilhos, o aplicativo verifica em intervalos programados e é acionado quando detecta uma diferença.

Os gatilhos de sondagem são ativados na página “Gatilhos”, como qualquer outro. Eles consomem um ciclo de sondagem de latência, em vez de serem acionados instantaneamente.

4. Pixel da vitrine

Shopify não envia webhooks para as ações dos compradores: uma página de produto visualizada, um item adicionado ao carrinho, uma busca que não encontrou nada, um erro exibido na finalização da compra. Para esses 14 gatilhos, o aplicativo instala um pixel da web no site da sua loja, que reporta o evento a partir do navegador do comprador.

Isso leva a três conclusões, que diferenciam esses gatilhos dos outros três mecanismos:

  • Opção de adesão. É necessário que tenham a permissão “Acesso ao comportamento da loja virtual” e que a opção esteja ativada desligado. Ativar um fluxo de trabalho do Flow que utilize esse gatilho faz com que ele seja ativado, assim como acontece com qualquer outro gatilho. O O pixel é ativado quando o primeiro é ligado e não envia nada enquanto nenhum estiver ligado.
  • Condicionado ao consentimento. Um cliente que não tenha dado consentimento para o uso de análises é direcionado para o navegador, e o evento nunca chega até nós, não custa nada e não aciona nenhum fluxo de trabalho.
  • Faremos o possível. Uma aba fechada, uma conexão interrompida ou um bloqueador de anúncios significa que o evento nunca chega, e não há nova tentativa. Use-os para sinais e reações, nunca em situações em que um A omissão do evento seria um problema de exatidão.

Além disso, eles têm um volume muito maior do que os eventos administrativos. Consulte Acionadores de vitrine antes de ativar um deles.

O que chega ao seu fluxo de trabalho

Os gatilhos de nível de campo fornecem o valor antigo e o novo, permitindo que você crie uma ramificação com base na própria alteração, sem a necessidade de uma consulta posterior:

yaml
Old price: 19.99
New price: 24.99
SKU:       WIDGET-BLUE-M
Adicionar um painel de variáveis no Flow exibindo oldPrice, newPrice, delta, percentChange e direction
O que é exibido em Shopify Flow quando há uma alteração de preço: o valor antes e depois, a diferença, a porcentagem e a variação.

As alterações em formato de lista são fornecidas como objetos estruturados, em vez de texto separado por vírgulas, para que você possa iterar e criar ramificações com base nelas no Flow. As alterações em itens de linha de pedido, as alterações de publicação e as isenções fiscais por localização da empresa funcionam dessa maneira.

Pedidos e duplicatas

  • Os eventos são desduplicados com base no ID de evento dShopify, portanto, uma reenvio não aciona seu executar o fluxo de trabalho duas vezes.
  • O aplicativo aplica um limite de taxa por loja, de modo que uma edição em massa de milhares de produtos não sobrecarrega seus fluxos de trabalho. Os eventos são colocados em fila, não descartados.
  • Uma operação em massa que altera 5.000 produtos gera 5.000 eventos e consome 5.000 da sua cota mensal. Consulte Planos e uso.
  • Os eventos do Storefront agrupam as repetições da mesma visualização de página em um curto intervalo de tempo, e Os dois gatilhos de visita agrupam uma visita inteira em um único evento por cliente ou empresa.