Gatilhos da loja virtual, passo a passo

Copiar página

Gatilhos Shopify Flow para visualizações de produto, carrinho, checkout e pesquisa na loja virtual, com exemplos passo a passo.

Estes gatilhos têm origem nas ações dos clientes na sua loja virtual, e não numa alteração no seu painel de administração. A aplicação recolhe-os através de um pixel da web que instala automaticamente quando o primeiro gatilho é ativado.

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

Nesta página: Visualização de produto na loja, Visualização de coleção na loja, Produto adicionado ao carrinho na loja, Produto removido do carrinho na loja, Visualização do carrinho na loja, Início do processo de checkout na loja, Pesquisa na loja, Pesquisa na loja não apresentou resultados, Visualização de variante esgotada, Cliente com sessão iniciada visitou, Comprador B2B visitou, Gatilho personalizado da loja virtual

Onde os pode encontrar: em Shopify Flow, selecione «Selecionar um gatilho», aceda a Workflow Trigger Extensions e procure por «Loja virtual».

Produto visualizado na loja virtual

É acionado quando um cliente abre a página de um produto. Inclui o produto como referência e a variante que foi apresentada, juntamente com o SKU e o preço.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorizaçã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 ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Avalie o interesse num produto para orientar as compras ou a apresentação dos produtos.
Inserir as visualizações numa ferramenta de recomendação ou de análise que não tenha integração com o Shopify.

O que a funcionalidade «Produto visualizado na 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 visualizado. Trata-se de um produto Shopify completo, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas ao produto estão disponíveis.
`viewedVariant`	Objeto	A variante apresentada, com o respetivo SKU e preço
`viewedVariant.variantId`	ID
`viewedVariant.variantTitle`	Texto
`viewedVariant.sku`	Texto
`viewedVariant.price`	Dinheiro (montante, 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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Contar visualizações num metacampo de produto

Selecione «Produto visualizado na loja virtual» como gatilho.
Adicione um código de execução que leia o valor atual do metacampo do produto custom.view_count a partir da referência product e o devolva mais um.
Adicione uma atualização ao metacampo do produto com o número devolvido.
Ative o fluxo de trabalho.

Coleção da loja virtual visualizada

É disparado quando um comprador abre uma página de coleção. Contém o ID e o título da coleção.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorização	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Veja quais são as coleções das campanhas que geram tráfego.
Envie as visualizações da coleção para um ponto de fim de análise externo.

O que a opção «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 da aplicação para ver exatamente o que foi enviado.

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

Selecione «Loja virtual Collection Viewed» como o gatilho.
Adicione uma condição: collection.title é igual a Summer Sale.
Adicione «Enviar pedido HTTP» ao seu ponto final de análise.
Ative o fluxo de trabalho.

Produto da loja virtual adicionado ao carrinho

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


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorizaçã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 este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Detete atempadamente quantidades invulgarmente elevadas, por exemplo, um comprador B2B na loja destinada ao consumidor.
Acompanhar a adição 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, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas 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 (montante, código da moeda)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Alertar o departamento de vendas sobre quantidades em grande volume

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

Produto da loja virtual removido do carrinho

É acionado quando um cliente retira um artigo do carrinho.


Incêndios provocados por	O pixel da loja virtual do aplicativo, no navegador do comprador
Autorizaçã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 ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Identifique os produtos que são adicionados e removidos com uma frequência invulgar: pode tratar-se de um problema relacionado com o preço, os portes de envio ou as variantes.

O que a ação «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 Shopify completo, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas 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 (montante, código da moeda)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Registo das remoções de um produto em teste

Selecione «Produto da loja virtual removido do carrinho» como gatilho.
Adicionar uma condição: product.tags inclui watch.
Adicione a opção «Enviar pedido HTTP» a uma folha de cálculo ou a um ponto final de análise utilizando {{product.title}} e {{cartLineEvent.sku}}.
Ative o fluxo de trabalho.

Cesto de compras visualizado na loja virtual

É disparado quando um cliente acede à página do carrinho (/cart). Contém o ID do carrinho, o número de artigos e o total.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorização	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Preste atenção aos carrinhos de valor elevado.

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 (montante, código da moeda)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Alerta para carrinhos com valor superior a 1 000

Selecione «Página inicial da loja virtual - Carrinho visualizado» como gatilho.
Adicione um código de execução que devolva um valor do tipo big: Number(input.cartSnapshot.total.amount) > 1000, uma vez que os montantes monetários são apresentados como texto.
Adicione uma condição no big e, em seguida, envie um e-mail interno.
Ative o fluxo de trabalho.

Início do processo de checkout na loja virtual

Aciona-se quando um cliente acede ao processo de checkout - no início, e não quando o abandona.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorização	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este fique ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

A medição do processo de checkout da compra tem como base os pedidos.
Repare em checkouts de valor muito elevado à medida que estes ocorrem.

O que o «Storefront Checkout Started» 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 (montante, código da moeda)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Alerta em caso de um checkout de grande valor

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

Pesquisa na loja virtual

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


Incêndios provenientes de	O pixel da loja virtual da aplicação, no navegador do comprador
Autorizaçã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 este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Veja o que os compradores pesquisam e o que lhes é apresentado em primeiro lugar.
Verifique se os termos importantes remetem para o 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 apresentado pela pesquisa, como um produto completo a partir do qual pode criar ramificações. Trata-se de um produto completo do Shopify, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas ao produto 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 que o cliente digitou.
`storefrontSearch.resultCount`	Número	Quantas variantes do produto a pesquisa apresentou.
`storefrontSearch.results`	Lista de objetos	Os resultados, ordenados pelo mais recente em primeiro lugar, 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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Verifique o que aparece em primeiro lugar quando se pesquisa um termo-chave

Selecione «Pesquisa na loja virtual» como gatilho.
Adicionar uma condição: storefrontSearch.query inclui gift card.
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}}.
Ative o fluxo de trabalho.

A pesquisa na loja virtual não apresentou resultados

É apresentado quando uma pesquisa na loja virtual não encontra nada. Trata-se de uma lista de artigos que os clientes esperavam que vendesse, ou de palavras que o seu motor de pesquisa não compreende.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorização	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Recolha os produtos em falta e os sinónimos.
Detete um problema na pesquisa após uma alteração de tema ou de aplicação: um aumento repentino é um indício.

O que a função «Pesquisa na loja virtual não apresentou 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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Recolher pesquisas sem resultados numa folha de cálculo

Selecione «Pesquisa na loja virtual não apresentou resultados» como gatilho.
Adicione a opção «Enviar pedido HTTP» a um webhook do Google Sheets ou do Airtable com o {{searchQuery.query}}.
Analise a ficha semanalmente: adicione sinónimos ou redireções na aplicação «Search & Discovery» dShopify, ou inclua no inventário o que as pessoas solicitam.
Ative o fluxo de trabalho.

Variante esgotada visualizada

É acionado quando um cliente acede a uma página de produto cuja variante apresentada se encontra esgotada em todos os locais. Trata-se de um sinal de procura: alguém pretendia algo que não foi possível vender.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorizaçã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 Shopify Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Dê prioridade às reposições com base na procura real.
Marque os produtos para uma campanha de reposição de stock.

O que a opção «Variante esgotada 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, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas ao produto estão disponíveis.
`outOfStockVariant`	Objeto	A variante e a 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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Identifique os produtos esgotados que os clientes continuam a consultar

Selecionar a variante esgotada como o gatilho.
Adicione tags de produto com restock-demand.
Adicione «Enviar e-mail interno para o departamento de compras: {{product.title}} / {{outOfStockVariant.variantTitle}} ({{outOfStockVariant.sku}}) was viewed while sold out».
Ative o fluxo de trabalho.

É bom saber

Esta funcionalidade baseia-se nas visualizações de produtos; por isso, ao ativá-la, a opção «Visualizações de produtos na loja virtual» também fica ativada, e cada visualização de produto conta para o seu plano.
Apenas a variante apresentada no momento em que a página é carregada é verificada. A seleção posterior de uma variante esgotada não constitui uma nova visualização da página e não é registada.
É necessário ter acesso ao estoque e aos dados dos produtos, para além do acesso ao comportamento da loja virtual.
Recolhidos no navegador do comprador e apenas com consentimento para fins de análise, pelo que, por definição, apresentam valores inferiores aos reais e podem deixar de registar eventos (bloqueadores de anúncios, separadores fechados). Utilize-os como indicadores, mas nunca em situações em que a omissão de um evento possa constituir um problema de exatidão. Consulte Acionadores da loja virtual.

Cliente com sessão iniciada visitou

É acionado quando um cliente com sessão iniciada se encontra na sua loja virtual. As visualizações repetidas de páginas são agrupadas numa única visita por cliente, dentro de um intervalo de tempo à sua escolha, que pode variar entre todas as visitas e uma vez por mês.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorização	Acesso ao comportamento da loja virtual + Acesso aos dados dos clientes
Ligado	Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Informe um gestor de contas de que um cliente importante está de volta.
Inicie um processo de reengajamento para os clientes que regressam após um longo período de ausência.

O que a função «Cliente com sessão iniciada visitou» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente que iniciou sessão, com o seu registo completo para a criação de ramificações. Trata-se de um cliente Shopify completo, pelo 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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Informe o gestor de contas de que um cliente VIP está a navegar no site

Na aplicação, abra o ícone de definições junto a «Cliente registado visitou» e selecione a frequência das visitas, por exemplo, uma vez por dia.
Selecione «Cliente com sessão iniciada que visitou» no Shopify Flow.
Adicionar uma condição: customer.tags inclui vip.
Adicione a opção «Enviar e-mail interno com {{customer.displayName}}».
Ative o fluxo de trabalho.

Visita de um comprador B2B

Apresenta-se quando um comprador B2B com sessão iniciada se encontra na sua loja virtual, indicando a empresa e a localização da empresa para a qual efetua a compra. As visitas são agrupadas por empresa, dentro do período que escolher.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorização	Acesso a dados sobre empresas e locais (B2B) + Acesso a dados sobre o comportamento nas lojas virtuais
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Avisar o representante comercial da empresa quando os seus compradores estiverem ativos.
Avalie a frequência com que as contas grossistas voltam.

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 os quais o comprador efetua a compra
`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 da aplicação para ver exatamente o que foi enviado.

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

Defina o intervalo de visitas através do ícone de definições junto à opção «Comprador B2B visitou» na aplicação.
Selecione «Comprador B2B visitado» em «Shopify Flow».
Adicione «Enviar e-mail interno: A buyer of {{purchasingCompany.companyName}} ({{purchasingCompany.companyLocationName}}) is on the store».
Ative o fluxo de trabalho.

Gatilho personalizado da loja virtual

É acionado quando o seu tema publica um evento que definiu: a abertura da janela do carrinho, a utilização de um guia de tamanhos, a conclusão de um questionário. Cria o gatilho na aplicação, atribui-lhe um nome de evento e publica esse nome a partir do seu tema com uma única linha de JavaScript.


Incêndios provocados por	O pixel da loja virtual da aplicação, no navegador do comprador
Autorização	Acesso ao comportamento da loja virtual
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

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

O que o «Custom Storefront Trigger» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`eventName`	Texto	O nome do evento que publicou, por exemplo, cart_drawer_opened. Aplique um filtro com base nisso para que o evento seja executado apenas para um deles.
`triggerName`	Texto	O nome que atribuiu a este gatilho de loja virtual.
`output`	Objeto	Os dados que publicou juntamente com o evento, após a execução do seu código de transformação.
`output.fields`	Lista de objetos	Cada chave, pela ordem em que foi definida.
`output.fields (each).key`	Texto	A chave, tal como foi publicada ou devolvida pela transformação (por exemplo, «itemCount»).
`output.fields (each).value`	Texto	O valor, convertido em cadeia de caracteres. Os objetos e as matrizes são recebidos como texto JSON.
`output.json`	Texto	A totalidade do payload em formato JSON, para os lojistas que preferem analisá-lo de uma só vez.
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Resposta a um questionário sobre um produto acabado

Na aplicação, abra a secção «Gatilhos», crie um «Gatilho de Loja Virtual personalizado» e atribua-lhe o nome de evento quiz_completed. Copie o trecho de código que é apresentado.
No seu tema, chame o snippet quando o questionário terminar e passe o resultado, por exemplo, { result: "dry-skin" }.
No Shopify Flow, selecione «Gatilho de loja virtual personalizado» e adicione uma condição: eventName igual a quiz_completed.
Leia os seus dados a partir de output.fields (pares de chave e valor) ou analise output.json numa etapa «Executar código».
Ative o fluxo de trabalho.

Próximos passos

Todos eles necessitam de acesso ao comportamento da Loja virtual. Os que apresentam um produto também necessitam de acesso aos dados do produto; o «Cliente com sessão iniciada visitou» também necessita de acesso aos dados do cliente; e o «Comprador B2B visitou» também necessita de acesso aos dados da empresa.

Referência completa sobre os gatilhos - todos os gatilhos numa única página.
Escolher o gatilho certo - qual é o mais adequado ao seu caso.
Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
Histórico de eventos e resolução de problemas - ver o que disparou e o que transportava.