Como funcionam os gatilhos

Compreender qual dos quatro mecanismos um gatilho utiliza explica quase todas as questões relacionadas com o tempo, a configuração e o motivo pelo qual algo disparou ou não.

Os quatro mecanismos

Mecanismo	Desencadeadores	Latência	É necessário definir um valor de referência	Entrega
Shopify webhook	26	Quase em tempo real	Não	Garantido
Webhook + deteção de alterações	52	Quase em tempo real	Sim	Garantido
Sondagem	6	Até um intervalo de sondagem	Sim	Garantido
Pixel da montra	14	Segundos	Não	Melhor esforço possível

1. Webhook Shopify

Shopify notifica a aplicação assim que o evento ocorre, e a aplicação reencaminha-o diretamente para Shopify Flow. As funcionalidades «Desconto criado» e «Localização eliminada» funcionam desta forma.

Estes gatilhos não requerem qualquer configuração além da autorização e cada um deles tem o seu próprio botão na página «Gatilhos».

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

Este é o grupo mais vasto e é o que torna a aplicação útil. O webhook products/update da Shopify é acionado sempre que um produto é editado, mas não indica o que foi alterado. Por isso, a aplicação:

1. armazena um instantâneo dos campos que lhe interessam,
2. compara cada webhook recebido com esse instantâneo e
3. aciona o gatilho específico apenas quando esse campo específico for efetivamente alterado.

É assim que o webhook «Product Title Changed» pode ser acionado quando se edita um título e não ser acionado quando se edita um preço, apesar de ambos serem enviados através do mesmo webhook Shopify.

3. Sondagens

Shopify Não publica webhooks para blogs, publicações de blog, páginas, estado de visualização de encomendas, expiração de descontos ou definições fiscais relacionadas com a localização da empresa. Para estes 6 gatilhos, a aplicação verifica periodicamente e aciona-se quando deteta uma diferença.

Os gatilhos de sondagem são ativados na página «Gatilhos», tal como qualquer outro. Implicam um ciclo de sondagem de latência, em vez de serem acionados instantaneamente.

4. Pixel da montra

Shopify não envia webhooks relativamente às ações dos compradores: uma página de produto visualizada, um artigo adicionado ao carrinho, uma pesquisa sem resultados, um erro apresentado no momento do pagamento. Para estes 14 gatilhos, a aplicação instala um pixel web na sua loja online, que comunica o evento a partir do navegador do comprador.

Daí decorrem três aspetos, que distinguem estes gatilhos dos outros três mecanismos:

• Aderência. É necessário que tenham a permissão «Acesso ao Comportamento da Loja» e que a opção esteja ativada desligado. Ao ativar um fluxo de trabalho do Flow que utiliza esse gatilho, este fica ativado, tal como acontece com qualquer gatilho. O O pixel é instalado quando o primeiro é ligado e não envia nada enquanto nenhum estiver ligado.
• Sujeito a consentimento. Um cliente que não tenha dado o seu consentimento para a análise de dados é colocado na navegador, e o evento nunca chega até nós, não tem qualquer custo e não dá início a nenhum fluxo de trabalho.
• Máximo esforço. Uma aba fechada, uma ligação interrompida ou um bloqueador de anúncios significa que o evento nunca chega ao destino e não há nova tentativa. Utilize-os para sinais e reações, nunca em situações em que um A omissão de um evento constituiria um problema de correção.

Além disso, têm um volume muito superior ao dos eventos administrativos. Consulte Acionadores da loja virtual antes de ativar um.

O que chega ao seu fluxo de trabalho

Os gatilhos ao nível do campo fornecem o valor antigo e o novo, pelo que é possível ramificar com base na própria alteração, sem necessidade de uma pesquisa posterior:

Old price: 19.99
New price: 24.99
SKU:       WIDGET-BLUE-M

As alterações em formato de lista são fornecidas como objetos estruturados, em vez de texto separado por vírgulas, pelo que é possível iterar e criar ramificações com base nelas no Flow. As alterações nas linhas de pedido, as alterações nas publicações e as isenções fiscais por localização da empresa funcionam todas desta forma.

Encomendas e duplicados

• Os eventos são deduplicados com base no ID de evento dShopify, pelo que uma reenvio não aciona o seu executar o fluxo de trabalho duas vezes.
• A aplicação aplica um limite de frequência reduzido por loja, pelo que uma edição em massa de milhares de produtos não sobrecarrega os seus fluxos de trabalho. Os eventos são colocados em fila, não são descartados.
• Uma operação em massa que altera 5 000 produtos gera 5 000 eventos e consome 5 000 da sua quota mensal. Consulte Planos e utilização.
• Os eventos «Storefront» agrupam as repetições da mesma visualização de página num curto intervalo de tempo, e Os dois gatilhos de visita agrupam uma visita completa num único evento por cliente ou empresa.