Como funcionam os gatilhos

Como funcionam os gatilhos

Copiar página

Shopify Flow Explicação sobre gatilhos: webhooks, detecção de alterações e polling, além de como cada um deles afeta a latência e a configuração.

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

Os quatro mecanismos

Mecanismo Gatilhos Latência É necessário estabelecer 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 loja virtual 14 Segundos Não Melhor esforço possível

1. Webhook do Shopify

Shopify notifica o aplicativo no momento em 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 requerem 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

Este é 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 de seu interesse,
  2. compara cada webhook recebido com esse instantâneo e
  3. aciona o gatilho específico somente quando esse campo específico for efetivamente alterado.

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

3. Pesquisa de opinião

Shopify não publica Webhooks para blogs, postagens 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 realiza verificações em intervalos programados e é acionado quando detecta uma diferença.

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

4. Pixel da loja virtual

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

Daí decorrem três coisas, que diferenciam esses gatilhos dos outros três mecanismos:

  • Opção de adesão. É necessário que possuam 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 recurso o aciona, assim como acontece com qualquer gatilho. O O pixel é instalado quando o primeiro é ligado e não transmite nada enquanto nenhum estiver ligado.
  • Sujeito a consentimento. Um consumidor 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.
  • Esforço máximo. 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. Utilize-os para sinais e reações, nunca em situações em que um A omissão do evento constituiria um problema de exatidão.

Além disso, o volume desses eventos é muito maior do que o dos 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ê ramifique 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
Adicione no Shopify Flow um painel de variáveis que mostre oldPrice, newPrice, delta, percentChange e direction
O que é exibido em Shopify Flow em caso de alteração de preço: o valor anterior e o valor posterior, a diferença, a porcentagem e a direçã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 ramificar com base nelas no Shopify Flow. As alterações em itens de linha de pedido, as alterações de publicação e as isenções fiscais por local 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 o 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 da Loja virtual agrupam as repetições da mesma visualização de página em um curto intervalo de tempo, e Os dois gatilhos de visita agrupam todas as visitas em um único evento por cliente ou empresa.