Como funcionam os gatilhos

Compreender qual dos quatro mecanismos um gatilho utiliza explica praticamente todas as questões relativas ao momento certo, à configuração e ao motivo pelo qual algo disparou ou não.

Os quatro mecanismos

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

1. Webhook Shopify

Shopify notifica a aplicação no momento em que o evento ocorre, e a aplicação reencaminha-o diretamente para Shopify Flow. Os eventos «Desconto criado» e «Localização eliminada» funcionam desta forma.

Estes gatilhos não requerem qualquer configuração para além da autorização e cada um deles dispõe do 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 pedidos, expiração de descontos ou definições fiscais relativas à localização da empresa. Para estes 6 gatilhos, a aplicação efetua verificações de acordo com um horário definido e é acionada quando deteta uma alteração.

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

4. Pixel da loja virtual

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 checkout. Para estes 14 gatilhos, a aplicação instala um pixel da web na sua loja virtual, 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 voluntária. É necessário que disponham da permissão «Acesso ao Comportamento da Loja virtual» e que a opção «Iniciar» esteja ativada desligado. Ao ativar um fluxo de trabalho do Shopify Flow que utiliza esse gatilho, este fica ativado, tal como acontece com qualquer outro 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 é excluído do navegador, e o evento nunca nos chega, não tem qualquer custo e não dá início a nenhum fluxo de trabalho.
• Esforço máximo. 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 pode ramificar com base na própria alteração, sem necessidade de uma pesquisa de acompanhamento:

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 pode iterar e criar ramificações com base nelas no Shopify Flow. As alterações às itens de linha de pedido, as alterações às publicações e as isenções fiscais por local da empresa funcionam todas desta forma.

Pedidos e duplicados

• Os eventos são deduplicados com base no ID de evento de Shopify, pelo que uma reenvio não aciona o seu executar o fluxo de trabalho duas vezes.
• A aplicação aplica um limite de velocidade 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 cota mensal. Consulte Planos e utilização.
• Os eventos «Loja virtual» agrupam as repetições da mesma visualização de página num curto intervalo de tempo, e Os dois gatilhos de visita agrupam toda uma visita num único evento por cliente ou empresa.