Gatilhos personalizados da loja virtual

Os gatilhos integrados da loja virtual abrangem os eventos relatados em Shopify. Um gatilho personalizado da loja virtual abrange tudo o resto que ocorre na sua loja virtual: basta publicar um evento a partir do seu tema com uma linha de JavaScript, e este torna-se um gatilho que pode utilizar em Shopify Flow.

O exemplo mais claro é a gaveta do carrinho. O evento «view» do carrinho de Shopify é acionado na página /cart, e a maioria dos temas modernos nunca navega até lá - em vez disso, abrem a gaveta através de um efeito deslizante. Shopify não regista nada, pelo que nenhuma aplicação consegue detetá-lo. Publicar o seu próprio evento quando a gaveta se abre colmata essa lacuna.

Outras finalidades para as quais as lojas o utilizam:

• Uma adição à lista de desejos ou um clique na opção «Notificar-me», nenhuma das quais é registada pelo Shopify.
• A consulta de um guia de tamanhos ou de uma política de devoluções, como indicação sobre um produto.
• Uma alteração na variante do seletor, que não constitui uma nova visualização da página (consulte Acionadores da loja virtual).
• Qualquer informação que o seu tema ou uma aplicação de terceiros já conheça e que Shopify não conheça.

Como funciona

1. Crie o gatilho na aplicação e atribua-lhe um nome de evento, por exemplo, cart_drawer_opened. Tal como qualquer gatilho da loja virtual, este necessita do acesso ao «Comportamento da Loja Virtual», que é concedido uma única vez na página «Permissões».
2. Copie o fragmento de código de uma linha que a aplicação lhe mostra e cole-o no seu tema, no local onde essa ação ocorre. Se não tiver a certeza do que deve colar ou onde, o site Gerar código de gatilho com IA gera o fragmento de código para o seu tema a partir de uma descrição em linguagem simples.
3. Escreva uma transformação se pretender filtrar ou alterar o formato do que é enviado, ou deixe em branco para reencaminhar tudo.
4. Ative-o e, em seguida, adicione o «Custom Storefront Trigger» no Shopify Flow e crie uma ramificação com base no nome do evento.

Este fragmento de código representa toda a integração do lado do tema:

Shopify.analytics.publish("cart_drawer_opened", {
  // anything you want the Flow to receive
  itemCount: 3,
  total: "129.90"
});

Atribuição de um nome ao evento

O nome do evento é o que determina a ramificação do seu fluxo de trabalho no Shopify Flow; por isso, escolha algo legível e não o altere depois de os fluxos de trabalho o terem começado a utilizar.

Os nomes podem conter letras, números, sublinhados e hífens, têm de começar por uma letra ou um número e podem ter até 64 caracteres. A aplicação transforma o que digitar em um «slug», pelo que Cart drawer opened passa a ser cart_drawer_opened.

O nome está associado a um espaço de nomes interno, pelo que nunca poderá entrar em conflito com um evento Shopify ou com um gatilho personalizado de webhook com o mesmo nome.

Filtragem e remodelação

Os dados que passar como segundo argumento chegam ao Shopify Flow como o parâmetro output do gatilho. Se isso for tudo o que precisa, está tudo pronto.

Quando pretender disparar o evento apenas em determinados casos, ou enviar campos diferentes dos publicados pelo tema, crie uma transformação - o mesmo módulo JavaScript utilizado por Gatilhos personalizados. Devolva um objeto para disparar o evento; devolva null para ignorá-lo:

export async function transform(payload, topic, shop, ctx) {
  // Anything you published is on `payload`.
  if ((payload.itemCount || 0) < 2) return null;

  return {
    itemCount: payload.itemCount,
    total: payload.total,
    // Present only when the shopper is signed in.
    customerId: payload.customerId,
  };
}

Utilização no site Shopify Flow

Cada «Custom Storefront Trigger» surge no Shopify Flow com o mesmo nome: «Custom Storefront Trigger». Adicione-o a um fluxo de trabalho e, em seguida, adicione uma condição em que «eventName» seja igual ao nome que escolheu.

É isso que permite que um Shopify Flow acione todos os eventos da sua loja virtual. O gatilho inclui também o nome que lhe atribuiu na aplicação e o resultado da sua transformação.

Trata-se de uma funcionalidade deliberadamente distinta do «Gatilho personalizado», que está na base do Gatilhos personalizados baseado em webhooks. As duas diferem de uma forma que vale a pena conhecer: um «Gatilho personalizado» de webhook é executado nos nossos servidores e é fiável, enquanto um evento da loja virtual depende de o navegador do comprador chegar até nós e do seu consentimento para a análise de dados.

O que não deve enviar

O segundo argumento da função publish está inteiramente sob o seu controlo, o que significa que é da sua responsabilidade garantir que não contenha dados pessoais.

Envie identificadores e dados: IDs do produto e da variante, quantidades, preços e a descrição do que aconteceu. O ID do cliente que iniciou sessão é adicionado automaticamente, caso exista, pelo que nunca terá de o indicar manualmente.

Não envie nomes, endereços de e-mail, números de telefone ou endereços postais. O seu fluxo de trabalho pode obter qualquer uma dessas informações a partir do ID do cliente no Shopify Flow; por isso, não há qualquer vantagem em incluí-las num evento da loja virtual, e fazê-lo transforma um evento de análise num evento que envolve dados pessoais.

Próximos passos

• Acionadores da loja virtual - os gatilhos integrados da loja virtual e o funcionamento do pixel.
• Gerar código de gatilho com IA - Deixe que a IA escreva o fragmento do tema ou a transformação por si.
• Gatilhos personalizados - a mesma ideia para eventos de webhook Shopify, com fiabilidade do lado do servidor.
• Planos e utilização - o que se considera um evento.