Gatilhos da loja virtual, passo a passo

Esses gatilhos são acionados a partir das ações do cliente em sua loja virtual, e não por uma alteração no painel de administração. O aplicativo os coleta por meio de um pixel da web que é instalado automaticamente quando o primeiro gatilho é ativado.

Leia primeiro Acionadores de vitrine: o artigo explica o que é consentimento, o volume de dados e o que o pixel envia e o que não envia. Cada evento conta para o seu plano, e uma loja movimentada gera mais visualizações de produtos em um dia do que atualizações de pedidos em um ano.

Nesta página: Visualização de produto na loja virtual, Visualização de coleção na loja virtual, Produto adicionado ao carrinho na loja virtual, Produto removido do carrinho na loja virtual, Visualização do carrinho na loja virtual, Início do processo de checkout na loja virtual, Pesquisa na loja virtual, Pesquisa na loja virtual não retornou resultados, Visualização de variante fora de estoque, Cliente logado acessou a página, Comprador B2B visitou, Gatilho de loja virtual

Produto visualizado na loja virtual

É acionado quando um cliente abre a página de um produto. Ele inclui o produto como referência e a variante exibida, com o SKU e o preço.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual + acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Avalie o interesse em um produto para orientar as compras ou a exposição de mercadorias.
• Inserir visualizações em uma ferramenta de recomendação ou análise que não possua integração com o Shopify.

O que o evento “Produto visualizado na loja virtual” envia ao seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
product	Produto (Shopify)	O produto que foi visualizado. Trata-se de um produto com acesso total (Shopify), portanto, todos os seus campos e as ações de produto próprias do Shopify Flow estão disponíveis.
viewedVariant	Objeto	A variante apresentada, com seu SKU e preço
viewedVariant.variantId	ID
viewedVariant.variantTitle	Texto
viewedVariant.sku	Texto
viewedVariant.price	Dinheiro (valor, código da moeda)
viewedVariant.vendor	Texto
viewedVariant.productType	Texto
viewedVariant.productUrl	Texto
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Contar visualizações em um metacampo de produto

1. Selecione “Visualização do produto na loja virtual” como gatilho.
2. Adicione um código de execução que leia o valor atual do metacampo do produto custom.view_count da referência product e o retorne somado a um.
3. Adicione uma atualização no metacampo do produto com o número retornado.
4. Ative o fluxo de trabalho.

Visualização da coleção na loja virtual

É disparado quando um cliente abre a página de uma coleção. Ele contém o ID e o título da coleção.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. O botão de ativação específico desse fluxo de trabalho está na página “Gatilhos” do aplicativo

Utilize-o para

• Veja quais coleções de campanhas geram tráfego.
• Encaminhe as visualizações de coleção para um ponto de extremidade de análise externo.

O que a “Loja virtual Collection Viewed” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
collection	Objeto	A coleção que foi visualizada
collection.id	ID
collection.title	Texto
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Visualizações futuras de uma coleção de campanha

1. Selecione “Coleção de Loja Virtual” como o gatilho.
2. Adicione uma condição: collection.title seja igual a Summer Sale.
3. Adicione a opção “Enviar solicitação HTTP” ao seu endpoint de análise.
4. Ative o fluxo de trabalho.

Produto da loja virtual adicionado ao carrinho

É acionado quando um cliente adiciona um item ao carrinho. Ele contém o produto, a variante, a quantidade e o total da linha.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual + acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Identifique com antecedência quantidades excepcionalmente grandes; por exemplo, um comprador B2B na loja voltada para o consumidor.
• Acompanhe as adições ao carrinho dos produtos em teste.

O que o evento “Produto adicionado ao carrinho” da loja virtual envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
product	Produto (Shopify)	O produto que foi adicionado. Trata-se de um produto completo do Shopify, portanto, todos os seus campos e as ações específicas do Shopify Flow relacionadas ao produto estão disponíveis.
cartLineEvent	Objeto	A variante, a quantidade e o total da linha
cartLineEvent.variantId	ID
cartLineEvent.variantTitle	Texto
cartLineEvent.sku	Texto
cartLineEvent.quantity	Número
cartLineEvent.lineTotal	Dinheiro (valor, código da moeda)
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Notificar a equipe de vendas sobre quantidades em grandes lotes

1. Selecione “Produto da loja virtual adicionado ao carrinho” como gatilho.
2. Adicionar uma condição: cartLineEvent.quantity maior que 20.
3. Adicione “Enviar e-mail interno”: {{cartLineEvent.quantity}} x {{product.title}} / {{cartLineEvent.variantTitle}} was added to a cart.
4. Ative o fluxo de trabalho.

Produto da loja virtual removido do carrinho

É acionado quando um cliente retira um item do carrinho.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual + acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Identifique os produtos que são adicionados e removidos com uma frequência incomum: pode ser um problema relacionado ao preço, ao frete ou às variantes.

O que o evento “Produto removido do carrinho” da Loja virtual envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
product	Produto (Shopify)	O produto que foi removido. Trata-se de um produto completo do Shopify, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas ao produto estão disponíveis.
cartLineEvent	Objeto	A variante, a quantidade e o total da linha
cartLineEvent.variantId	ID
cartLineEvent.variantTitle	Texto
cartLineEvent.sku	Texto
cartLineEvent.quantity	Número
cartLineEvent.lineTotal	Dinheiro (valor, código da moeda)
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Registros de remoção de um produto em teste

1. Selecione “Produto da loja virtual removido do carrinho” como gatilho.
2. Adicionar uma condição: product.tags inclui watch.
3. Adicione a função “Enviar solicitação HTTP” a uma planilha ou a um endpoint do Analytics usando {{product.title}} e {{cartLineEvent.sku}}.
4. Ative o fluxo de trabalho.

Carrinho visualizado na loja virtual

É disparado quando um cliente abre a página do carrinho (/cart). Ele contém o ID do carrinho, o número de itens e o total.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação encontra-se na página “Gatilhos” do aplicativo

Utilize-o para

• Fique atento aos carrinhos de alto valor.

O que a “Loja virtual Cart Viewed” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
cartSnapshot	Objeto	O conteúdo do carrinho no momento em que foi visualizado
cartSnapshot.cartId	ID
cartSnapshot.totalQuantity	Número
cartSnapshot.total	Dinheiro (valor, código da moeda)
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Alerta para carrinhos com valor superior a 1.000

1. Selecione “Visualização do carrinho na loja virtual” como gatilho.
2. Adicione um código de execução que retorne um valor do tipo big: Number(input.cartSnapshot.total.amount) > 1000, pois os valores monetários são recebidos como texto.
3. Adicione uma condição em big e, em seguida, envie um e-mail interno.
4. Ative o fluxo de trabalho.

Início do processo de checkout na loja virtual

É acionado quando um cliente inicia o processo de checkout - logo no início, e não quando ele o abandona.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do consumidor
Permissão	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize aciona esse recurso. O botão de ativação específico desse recurso está na página “Gatilhos” do aplicativo

Utilize-o para

• A medição da checkout da compra é feita com base nos pedidos.
• Fique atento a checkouts de valor muito elevado à medida que eles ocorrem.

O que a Loja virtual Checkout envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
checkoutSnapshot	Objeto	O token de checkout, o número de linhas e o total
checkoutSnapshot.checkoutToken	Texto
checkoutSnapshot.lineItemCount	Número
checkoutSnapshot.total	Dinheiro (valor, código da moeda)
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Alerta sobre um checkout de valor elevado

1. Selecione “Início do processo de checkout na loja virtual” como gatilho.
2. Adicionar uma condição: checkoutSnapshot.lineItemCount maior que 15.
3. Adicione a opção “Enviar e-mail interno com {{checkoutSnapshot.total.amount}} {{checkoutSnapshot.total.currencyCode}}”.
4. Ative o fluxo de trabalho.

Pesquisa na loja virtual

É acionado quando uma pesquisa na loja virtual retorna pelo menos um resultado. Ele contém o termo, o número de resultados, até dez ocorrências e a primeira ocorrência como referência de produto.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual + acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Veja o que os compradores pesquisam e o que lhes é exibido em primeiro lugar.
• Verifique se os termos importantes levam ao produto correto.

O que a Loja virtual envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
product	Produto (Shopify)	O primeiro produto exibido pela pesquisa, como um produto completo a partir do qual é possível criar ramificações. Um produto completo do Shopify, de modo que todos os seus campos e as ações próprias do produto no Shopify Flow estão disponíveis.
storefrontSearch	Objeto	O termo de pesquisa, o número de resultados e até 10 resultados, incluindo o primeiro
storefrontSearch.query	Texto	O termo digitado pelo cliente.
storefrontSearch.resultCount	Número	Quantas variantes do produto a pesquisa retornou.
storefrontSearch.results	Lista de objetos	Os resultados, ordenados dos mais recentes aos mais antigos, limitados a 10 para manter o tamanho do payload reduzido.
storefrontSearch.results (each).productId	ID
storefrontSearch.results (each).title	Texto
storefrontSearch.results (each).vendor	Texto
storefrontSearch.results (each).url	Texto
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Verifique o que aparece em primeiro lugar ao pesquisar um termo-chave

1. Selecione “Pesquisa na loja virtual” como gatilho.
2. Adicionar uma condição: storefrontSearch.query inclui gift card.
3. Adicione uma segunda condição: product.title não inclui Gift Card; em seguida, envie um e-mail interno: o primeiro resultado para {{storefrontSearch.query}} foi {{product.title}}.
4. Ative o fluxo de trabalho.

A pesquisa na loja virtual não encontrou resultados

É exibido quando uma pesquisa na loja virtual não encontra nada. Esta é uma lista de itens que os clientes esperavam que o senhor vendesse, ou de palavras que o seu mecanismo de pesquisa não reconhece.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Reúna os produtos que faltam e os sinônimos.
• Identifique uma falha na pesquisa após uma mudança de tema ou de aplicativo: um aumento repentino é um indício disso.

O que o evento “A pesquisa na loja virtual não retornou resultados” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
searchQuery	Objeto	O termo de pesquisa e o número de resultados
searchQuery.query	Texto
searchQuery.resultCount	Número
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Reunir pesquisas sem resultados em uma planilha

1. Selecione “Pesquisa na loja virtual não retornou resultados” como gatilho.
2. Adicione a função “Enviar solicitação HTTP” a um webhook do Google Sheets ou do Airtable usando o {{searchQuery.query}}.
3. Revise a planilha semanalmente: adicione sinônimos ou redirecionamentos no aplicativo “Search & Discovery” dShopify ou inclua em estoque os itens solicitados pelos clientes.
4. Ative o fluxo de trabalho.

Variante fora de estoque visualizada

É acionado quando um cliente acessa uma página de produto cuja variante exibida está esgotada em todos os locais. Trata-se de um sinal de demanda: alguém desejava algo que a empresa não pôde vender.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual + Acesso aos dados de estoque + Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Priorize a reposição de estoque com base na demanda real.
• Marque os produtos para uma campanha de retorno ao estoque.

O que a ação “Variante fora de estoque visualizada” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
product	Produto (Shopify)	O produto ao qual a variante esgotada pertence. Trata-se de um produto Shopify completo; portanto, todos os seus campos e as ações de produto próprias do Shopify Flow estão disponíveis.
outOfStockVariant	Objeto	A variante e sua quantidade disponível
outOfStockVariant.variantId	ID
outOfStockVariant.variantTitle	Texto
outOfStockVariant.sku	Texto
outOfStockVariant.availableQuantity	Número
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Marque os produtos esgotados que os clientes ainda visualizam

1. Selecionar a variante fora de estoque visualizada como o gatilho.
2. Adicione tags de produto com o restock-demand.
3. Adicione “Enviar e-mail interno para o departamento de compras: {{product.title}} / {{outOfStockVariant.variantTitle}} ({{outOfStockVariant.sku}}) was viewed while sold out”.
4. Ative o fluxo de trabalho.

Cliente cadastrado visitou

É acionado quando um cliente conectado acessa a sua loja virtual. As visualizações repetidas de páginas são agrupadas em uma única visita por cliente dentro de um intervalo de tempo de sua escolha, que pode variar de todas as visitas a uma vez por mês.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual + Acesso aos dados dos clientes
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Informe a um gerente de contas que um cliente importante está de volta.
• Inicie uma etapa de reengajamento para os clientes que retornam após um longo período.

O que o evento “Cliente conectado visitou” envia ao seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
customer	Cliente (Shopify)	O cliente que está conectado, com seu registro completo para ramificação. Trata-se de um cliente Shopify completo, de modo que todos os seus campos e as ações próprias do cliente no Shopify Flow estão disponíveis.
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Informe ao gerente de contas que um cliente VIP está navegando no site

1. Na aplicação, abra o ícone de configurações ao lado de “Cliente cadastrado visitou” e selecione a frequência de visitas, por exemplo, uma vez por dia.
2. Selecione “Cliente conectado que visitou” em Shopify Flow.
3. Adicionar uma condição: customer.tags inclui vip.
4. Adicione a opção “Enviar e-mail interno” com o {{customer.displayName}}.
5. Ative o fluxo de trabalho.

Visita de um comprador B2B

Apresenta os dados quando um comprador B2B conectado acessa sua loja virtual, indicando a empresa e a localização da empresa para a qual ele está comprando. As visitas são agrupadas por empresa dentro do período que o senhor escolher.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso a dados sobre empresas e localização das empresas (B2B) + Acesso a dados sobre o comportamento dos clientes nas lojas virtuais
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Notifique o representante de vendas de uma empresa quando seus compradores estiverem ativos.
• Avalie a frequência com que as contas de atacado voltam a fazer negócios.

O que o “B2B Buyer Visited” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
purchasingCompany	Objeto	A empresa e o local para o qual o comprador está adquirindo
purchasingCompany.companyId	ID
purchasingCompany.companyName	Texto
purchasingCompany.companyLocationId	ID
purchasingCompany.companyLocationName	Texto
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Notificar o representante quando o comprador de uma empresa estiver ativo

1. Defina o intervalo de visitas por meio do ícone de configurações ao lado da opção “Comprador B2B visitou” no aplicativo.
2. Selecione “Comprador B2B visitado” em Shopify Flow.
3. Adicione “Enviar e-mail interno: A buyer of {{purchasingCompany.companyName}} ({{purchasingCompany.companyLocationName}}) is on the store”.
4. Ative o fluxo de trabalho.

Gatilho personalizado da loja virtual

É acionado quando o seu tema publica um evento que o senhor definiu: a abertura da janela do carrinho, o uso de um guia de tamanhos, a conclusão de um questionário. O senhor cria o gatilho no aplicativo, atribui um nome ao evento e publica esse nome a partir do seu tema com uma única linha de JavaScript.

Incêndios causados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Permissão	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Tudo o que o Shopify não exibe: menus deslizantes, janelas modais, seletores de variantes, configuradores.
• Envie seus próprios dados e utilize-os no Shopify Flow.

O que o gatilho “Custom Storefront” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
eventName	Texto	O nome do evento que o(a) senhor(a) publicou, por exemplo, cart_drawer_opened. Filtre por esse nome para que o evento seja executado apenas para um deles.
triggerName	Texto	O nome que o(a) senhor(a) atribuiu a este gatilho de loja virtual.
output	Objeto	Os dados que o(a) senhor(a) publicou junto com o evento, após a execução do seu código de transformação.
output.fields	Lista de objetos	Cada chave, na ordem em que foi definida.
output.fields (each).key	Texto	A chave, exatamente como foi publicada ou retornada pela transformação (por exemplo, “itemCount”).
output.fields (each).value	Texto	O valor, convertido em string. Objetos e matrizes são recebidos como texto JSON.
output.json	Texto	A payload completa no formato JSON, para lojistas que preferem analisá-la de uma só vez.
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Responda a um questionário sobre um produto finalizado

1. Na aplicação, abra a seção “Gatilhos”, crie um “Gatilho personalizado para Loja virtual” e atribua a ele o nome de evento quiz_completed. Copie o trecho de código exibido.
2. No seu tema, chame o snippet quando o questionário terminar e passe o resultado, por exemplo, { result: "dry-skin" }.
3. No Shopify Flow, selecione “Custom Storefront Trigger” e adicione uma condição: eventName igual a quiz_completed.
4. Leia seus dados de output.fields (pares de chave e valor) ou analise output.json em uma etapa “Executar código”.
5. Ative o fluxo de trabalho.

Próximos passos

Todos eles precisam de acesso ao comportamento da loja virtual. Aqueles que oferecem um produto também precisam de acesso aos dados do produto; a opção “Cliente conectado visitou” também precisa de acesso aos dados do cliente; e a opção “Comprador B2B visitou” também precisa de acesso aos dados da empresa.

• Referência completa sobre gatilhos - todos os gatilhos em uma única página.
• Escolhendo o gatilho certo - qual delas se aplica ao seu caso.
• Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
• Histórico de eventos e solução de problemas - verificar o que foi disparado e o que estava carregado.