Solução de problemas de um fluxo acionado por métrica

Siga estas etapas para confirmar se o seu fluxo é acionado por métricas:

1. Clique no acionador do fluxo no construtor de fluxo.
2. Visualize a seção superior da barra lateral para ver se o fluxo é acionado por uma métrica e o nome da métrica. Para métricas acionadas por uma integração, o ícone da integração aparecerá ao lado do nome da métrica.
   
3. Clique no nome da métrica para visualizá-la na guia Analytics .

Fluxos comuns acionados por métricas:

• Checkout abandonado
• Abandono da navegação
• Retorno do cliente
• Confirmação do pedido
• Confirmação de envio
• Winback

Para evitar problemas com tipos de fluxo comuns, recomendamos que o senhor crie seus primeiros fluxos usando os modelos predefinidos de nossa biblioteca de fluxos e ajustando o conteúdo para que corresponda à sua marca.

Certifique-se de que suas mensagens estejam definidas com o status Live para começar a enviá-las aos clientes. Se suas mensagens estiverem definidas como Rascunho, elas não serão enviadas nem colocarão os perfis em uma lista de espera. Se estiverem definidas com o status Manual, as mensagens entrarão na fila de perfis, mas não serão enviadas até que o senhor as envie manualmente.

Se suas mensagens estiverem definidas atualmente ou anteriormente com o status Manual, siga estas etapas para enviar mensagens manualmente:

1. Na seção Performance da barra lateral de detalhes, clique em View details (Exibir detalhes).
2. Navegue até a atividade do destinatário > Needs Review.
3. Isso o levará a uma lista de perfis que alcançaram a mensagem no fluxo quando ela foi definida com o status Manual. 
1. O senhor pode visualizar, enviar e/ou cancelar individualmente cada e-mail e SMS que requer sua revisão. 
2. Se houver muitos destinatários que precisam ser revisados, o senhor pode enviar e cancelar mensagens em massa com os botões Send All e Cancel All, respectivamente. Se o senhor enviar um e-mail ou SMS para um contato que está em Needs Review e não atende mais aos filtros do fluxo, ele será ignorado e não receberá a mensagem.
   
3. Para enviar a mensagem automaticamente, defina-a para o status Live clicando no menu suspenso de status da mensagem no criador de fluxos.
   

Quando um evento ocorre em outra plataforma (por exemplo, Shopify, Magento, uma integração personalizada, etc.), ele é marcado com um registro de data e hora que é enviado para a Klaviyo. A métrica relacionada na Klaviyo terá um registro de data e hora separado marcando quando a Klaviyo recebeu a informação. Em muitos casos, esses eventos são enviados entre as plataformas em tempo real, mas algumas integrações sincronizam os dados por meio de sincronizações periódicas a cada 30 minutos ou 1 hora. Saiba com que frequência integrações específicas sincronizam dados.

Se houver um atraso de 4 horas ou mais entre o registro de data e hora do evento e o registro de data e hora do Klaviyo, o evento não acionará um fluxo acionado por métricas.

Para verificar se há um atraso, siga estas etapas:

1. Se o senhor estiver tendo problemas com um fluxo específico, como um fluxo de carrinho abandonado, visualize a página Flows (Fluxos ) para determinar qual métrica aciona o fluxo, como Placed Order (Pedido feito).
   
2. Se o senhor souber de um perfil específico que está sendo afetado, navegue até a página de perfil desse perfil pesquisando seu nome ou endereço de e-mail na barra de pesquisa superior esquerda da interface principal do Klaviyo. Caso contrário, se esse for um problema generalizado, visualize a página de perfil de qualquer perfil que tenha acionado a métrica afetada.
3. No registro de atividades do perfil, clique no botão de ação (3 pontos) e em Detalhes da atividade à direita da métrica afetada.
   
4. No modal Activity Details , compare os dois registros de data e hora listados no formato UTC (AAAA-MM-DDThh:mmTZD). Se houver uma diferença de 4 horas ou mais entre os registros de data e hora, isso indica que há um problema de sincronização entre a Klaviyo e a plataforma externa.
   

Na maioria dos casos, esses tipos de atrasos se devem a um problema na plataforma externa. 

Para lojas hospedadas em plataformas pagas (Shopify, BigCommerce, Prestashop, etc.)

Verifique sua página de status disponível publicamente para obter informações sobre interrupções e tempo de inatividade do servidor. As páginas de status geralmente consistem no URL principal do serviço com o subdomínio de status adicionado ao início, como nos exemplos abaixo:

• https:// status.shopify.com 
• https:// status.bigcommerce.com 
• http://status.prestashop.com

Para integrações auto-hospedadas, como (Magento, WooCommerce, integrações personalizadas, etc.)

Se o senhor ativou um firewall ou medidas de segurança como Sucuri, Cloudflare ou algo semelhante, isso pode inadvertidamente impedir que a Klaviyo se comunique com sua loja ou limitar a velocidade e a quantidade de dados que podem ser sincronizados.

Como a Klaviyo usa IPs dinâmicos, não há um intervalo de IPs disponíveis para a lista de permissões. Em vez disso, coloque na lista branca o agente de usuário do Klaviyo, que é: Klaviyo/1.0

Se não tiver certeza de como colocar o Klaviyo na lista de permissões, consulte a documentação do seu software de segurança para saber como colocar um agente de usuário na lista de permissões.

Se estiver usando uma integração personalizada, entre em contato com a equipe de desenvolvimento da sua integração para obter mais assistência.

Se o seu fluxo estava funcionando anteriormente, mas o senhor notou recentemente alterações no comportamento, deve primeiro examinar o registro de alterações do fluxo. Isso é especialmente importante para fluxos mais antigos e contas com vários usuários. Se o senhor perceber que o comportamento de um fluxo foi alterado após uma determinada data e hora, o changelog poderá lhe dizer o seguinte:

• O que mudou
• Quem fez a mudança 
• Quando a alteração ocorreu (data e hora no fuso horário de sua conta)

Se as mudanças coincidirem com o momento em que o senhor começou a ter problemas com seu fluxo, é provável que a mudança seja a origem do problema. 

Siga estas etapas para visualizar o histórico de um fluxo:

1. No menu suspenso, clique em View Flow History (Exibir histórico de fluxo).
   
2. A seleção de View Flow History abrirá o painel Flow History no lado direito da tela.
   

Saiba mais sobre o painel Flow History em nosso artigo sobre como revisar o registro de alterações de um fluxo.

O senhor pode perceber que as mensagens em seus fluxos de abandono estão mostrando muitos perfis ignorados. Isso é normal (e correto) para fluxos de abandono.

O funcionamento de um fluxo de abandono é que todos que acionarem a métrica de acionamento do fluxo entrarão no fluxo, e os filtros do fluxo ignorarão as pessoas que não abandonaram mais a navegação ou o carrinho. Veja as explicações abaixo:

• Abandono de navegação
  Acionado pelo evento Viewed Product (Produto visualizado) e ignorará as pessoas que acionaram oStarted Checkout (Checkout iniciado)

• Carrinho abandonado (padrão)
  Acionado pelo evento Started Checkout e ignorará as pessoas que acionarem Placed Order

• Carrinho abandonado (alternativo)
  Acionado pelo evento Added to Cart (Adicionado ao carrinho ) e ignorará as pessoas que acionarem Placed Order (Pedido feito)

Se o senhor ainda achar que há um problema com os perfis ignorados, verifique o seguinte:

Confirme se os saltos são causados pelos filtros corretos.

1. No criador de fluxos, clique em uma mensagem no fluxo.
2. Na barra lateral, clique em View details (Exibir detalhes ) na seção Performance (Desempenho ) da barra lateral.
   
3. Clique na guia Atividade do destinatário.
4. Clique na guia Skipped (Ignorado ).
   
5. Se a maioria dos perfis ignorados for ignorada devido a falhas nos filtros de fluxo, isso é normal. Se o senhor estiver preocupado com outros motivos ignorados, saiba mais sobre os outros motivos ignorados em nosso artigo sobre como entender o motivo ignorado de uma mensagem de fluxo.
6. O senhor pode clicar em Skipped: Fails Flow Filters para ver os perfis que estão sendo ignorados.

Verifique se os filtros estão configurados corretamente

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em Flow Filters (Filtros de fluxo ) na barra lateral.
3. Certifique-se de que os filtros de fluxo correspondam à configuração abaixo:
   Abandono de carrinho
   
   Carrinho abandonado
   
   
4. Altere os filtros de fluxo para que correspondam aos exemplos acima, se necessário, e remova todos os filtros de fluxo contraditórios.
5. Se o senhor tiver filtros adicionais, como aqueles que impedem que alguém entre no fluxo novamente dentro de um determinado período de tempo, certifique-se de que eles estejam configurados da maneira que o senhor pretende.
   

O fluxo de abandono de navegação é acionado com base na métrica do evento Viewed Product (Produto visualizado ) e tem filtros para remover alguém do fluxo se ele iniciar o checkout ou fizer um pedido. Se o senhor perceber que esse fluxo não está sendo enviado, verifique o seguinte:

Verifique se a métricaViewed Product está sendo registrada.

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em View (Exibir ) na seção Metric (Métrica ) da barra lateral.
   
3. Isso o levará à página de análise da métrica de evento Viewed Product . O senhor pode passar o mouse sobre o gráfico de atividade ou clicar na tag Activity Feed para ver a última vez que a métrica foi acionada.
   
4. Se a métrica Viewed Product não estiver sendo registrada em sua conta, consulte nosso guia sobre solução de problemas de rastreamento de Viewed Product. Se a métrica estiver sendo registrada, passe para a próxima etapa.

Verifique se os filtros de fluxo estão configurados como o senhor pretendia.

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em Flow Filters (Filtros de fluxo ) na barra lateral.
3. Certifique-se de que os filtros de fluxo correspondam à configuração abaixo:
   
4. Altere os filtros de fluxo para que correspondam aos exemplos acima, se necessário, e remova todos os filtros de fluxo contraditórios.
5. Se o senhor tiver filtros adicionais, como aqueles que impedem que alguém entre no fluxo novamente dentro de um determinado período de tempo, certifique-se de que eles estejam configurados da maneira que o senhor pretende.
   

Os filtros de um fluxo de abandono de carrinho são projetados para remover alguém do fluxo se ele fizer um pedido, pois isso significa que ele converteu e, portanto, não abandonou o carrinho ou a navegação. Se os seus clientes não estiverem sendo removidos corretamente após a realização de um pedido, verifique o seguinte:

Verifique se os eventos depedidos feitos estão sendo registrados pela sua conta.

1. Vá para a guia Metrics (Métricas ) no Klaviyo.
2. Clique em Placed Order (Pedido feito).
3. Passe o mouse sobre o gráfico de atividades ou clique na tag Activity Feed para ver a última vez que a métrica foi acionada.
   

Se a métrica Placed Order não estiver sendo registrada em sua conta, consulte nosso guia sobre solução de problemas de rastreamento de Placed Order.

Se a métrica Placed Order estiver sendo registrada, verifique se há um atraso entre o momento em que o evento foi acionado pela sua plataforma de comércio eletrônico e o momento em que foi registrado pela Klaviyo. Se o evento Started Checkout for acionado, mas o evento Placed Order for atrasado, alguém poderá receber e-mails do fluxo de carrinho abandonado. O senhor pode verificar isso fazendo o seguinte:

1. Navegue até a página de perfil de uma pessoa afetada, alguém que o senhor sabe que recebeu um e-mail de carrinho abandonado, apesar de ter feito um pedido antes do intervalo de tempo configurado em seu fluxo.
2. Clique no registro de data e hora do evento Placed Order (Pedido feito ) no feed de atividades.
3. No modal Activity Details (Detalhes da atividade ), veja os dois registros de data e hora listados na parte superior.

Verifique os filtros de fluxo

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em Flow Filters (Filtros de fluxo ) na barra lateral.
3. Certifique-se de que os filtros de fluxo correspondam à configuração abaixo:
   
4. Se o senhor tiver filtros adicionais, como aqueles que impedem que alguém entre no fluxo novamente dentro de um determinado período de tempo, certifique-se de que eles estejam configurados da maneira que o senhor pretende.

Se o senhor estiver usando rascunhos de pedidos do Shopify, adicione um filtro de acionamento.
Os rascunhos de pedido do Shopify acionam um evento de Checkout iniciado, mas não acionam um evento de Pedido feito, portanto, o senhor precisará adicionar um filtro de acionamento para evitar que esses tipos de pedidos acionem seu fluxo de carrinho abandonado. Os rascunhos de ordens não contêm uma lista normal de itens, mas, em vez disso, contêm um único item denominado "Valor a pagar pela ordem" seguido de um número de ordem.

Para excluir esses pedidos do fluxo de carrinho abandonado, siga estas etapas:

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em Trigger Filters (Filtros de acionamento ) na barra lateral.
3. Clique em Add a Trigger Filter para criar um novo filtro, se não houver nenhum. Caso contrário, clique em AND para adicionar um filtro adicional.
4. Defina o Type (Tipo ) do filtro como "Text" (Texto)
5. Ajuste o filtro de acionamento de modo que ele corresponda à configuração abaixo:
   

Se o fluxo estiver configurado para ser acionado no evento Placed Order (Pedido feito) ou Fulfilled Order (Pedido atendido ), mas não estiver sendo enviado, verifique o seguinte:

Entender a diferença entre pedido feito e pedido atendido.
Dependendo do fato de um fluxo ser acionado por um pedido colocado ou cumprido, há diferentes problemas e correções possíveis, por isso é importante entender a diferença. Embora existam diferenças entre as várias integrações de comércio eletrônico, em geral elas funcionam da seguinte forma:

• A métrica Pedido feito é acionada depois que um pedido é criado em sua loja de comércio eletrônico.
• A métrica de pedido atendido é acionada depois que um pedido tem um status equivalente a "enviado" para pedidos físicos ou "concluído" para pedidos digitais em sua plataforma de comércio eletrônico.

Certifique-se de que a métricaPedido feito ou Pedido atendido esteja sendo registrada corretamente.

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em View (Exibir ) na seção Metric (Métrica ) da barra lateral.
   
3. Passe o mouse sobre o gráfico de atividades ou clique na tag Activity Feed para ver a última vez que a métrica foi acionada.
   
4. 
5. Se a métrica Placed Order não estiver sendo registrada em sua conta, consulte nosso guia sobre solução de problemas de rastreamento de Placed Order. Se a métrica estiver sendo registrada, passe para a próxima etapa.

Se o senhor tiver alterado as integrações de comércio eletrônico, certifique-se de ter alterado o acionador de fluxo.
Ao migrar plataformas de comércio eletrônico, certifique-se de mudar as métricas usadas para seus fluxos e análises para as métricas de sua nova plataforma de comércio eletrônico. Por exemplo, se o senhor mudar do BigCommerce para o Shopify, as análises e os fluxos da sua conta ainda poderão ser configurados para usar a métrica de pedidos feitos do BigCommerce em vez da métrica de pedidos feitos do Shopify. Consulte nosso guia sobre como alterar um acionador de fluxo.

Se o senhor estiver usando filtros de fluxo para excluir perfis específicos do acionamento de um fluxo pós-compra, mas esses perfis ainda estiverem passando pelo fluxo, verifique o seguinte:

Visualize o acionador para ver por que os perfis estão passando pelo filtro.

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em Preview Trigger Setup (Visualizar configuração do acionador ) na barra lateral.
   
3. A visualização do acionador mostrará se os perfis recentes estão ou não passando pelos filtros de fluxo e por quê.
   
4. Se os perfis estiverem passando pelos filtros quando não deveriam, essa visualização mostrará ao senhor quais filtros estão passando.

Verifique se os filtros estão configurados como o senhor pretendia.

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em Flow Filters (Filtros de fluxo ) na barra lateral.
3. Verifique se a configuração de cada filtro corresponde ao que o senhor pretendia. Por exemplo, se o senhor quiser excluir perfis do fluxo se eles corresponderem a uma condição específica, use filtros com termos como "doesn't equal" (não é igual), "doesn't contain" (não contém) ou "zero times" (zero vezes).

Verifique os conectores entre os filtros.
Se estiver tentando excluir determinadas pessoas (por exemplo, "não contém"), o senhor deve usar conectores AND. Com um conector AND, alguém deve combinar os dois filtros. Se o senhor usar conectores OR, um perfil só precisará corresponder a um ou outro filtro.

Veja o exemplo abaixo:

Se o país registrado de uma pessoa for os Estados Unidos, ela falhará no primeiro filtro. Mas se as Tags do Shopify não contiverem "US", elas passarão pela segunda parte do filtro e entrarão no fluxo. Para cobrir ambos os cenários, o senhor precisa conectá-los com AND.

1. Exclua o segundo filtro clicando no botão da lixeira no canto inferior direito.
2. Clique em AND para adicionar um conector AND e um novo filtro.
3. Recrie seu filtro anterior.
   

Consulte este guia da nossa Central de Ajuda para obter uma explicação mais detalhada: Guia AND vs. OR

Se o senhor estiver usando filtros de acionamento para excluir eventos com itens específicos do acionamento de um fluxo pós-compra, mas esses filtros não estiverem excluindo eventos corretamente, verifique o seguinte:

Visualize o acionador para ver por que os perfis estão passando pelo filtro.

1. Clique no acionador do fluxo no construtor de fluxo.
2. Clique em Preview Trigger Setup (Visualizar configuração do acionador ) na barra lateral.
3. 
4. A visualização do acionador mostrará se os perfis recentes estão ou não passando pelos filtros de fluxo e por quê.
   
5. Se os perfis estiverem passando pelos filtros quando não deveriam, essa visualização mostrará ao senhor quais filtros estão passando.

Verifique se o nome do item ou da coleção está atualizado.
Se o senhor tiver alterado o nome do item ou da coleção (chamado de "categoria" por algumas integrações), precisará atualizar o nome na configuração do filtro. Para verificar se o nome do item foi alterado, siga estas etapas:

1. Na barra lateral principal do Klaviyo, clique em Products (Produtos ) para visualizar o catálogo de produtos.
2. Procure o nome do item que o senhor deseja excluir por seu nome ou ID.
3. Clique no nome do item para visualizar sua coleção ou categoria.
4. Depois de confirmar o nome do item ou da coleção, navegue de volta para o fluxo no criador de fluxos.
5. Clique no acionador do fluxo no construtor de fluxo.
6. Clique em Trigger Filters (Filtros de acionamento ) na barra lateral.
7. Ajuste o item ou coleção usado na barra lateral para corresponder ao novo nome do item ou coleção.

Verifique o tipo de filtro.
Os pedidos podem conter vários itens e coleções. Os filtros devem usar o tipo "List" para verificar se há uma entrada específica na lista de itens ou coleções.

Verifique se os filtros estão usando o tipo "List" (Lista) e a configuração "contains" (contém) ou "doesn't contain" (não contém) para incluir ou excluir itens ou coleções específicos.

No exemplo acima, se o senhor usar a configuração "doesn't equal" (não é igual), o filtro excluirá apenas os pedidos em que "New Items" (Novos itens) for a única coleção. Como os pedidos podem conter várias coleções, o senhor precisa usar "doesn't contain" para excluir corretamente os pedidos que contêm "New Items" juntamente com outras coleções.

Verifique os conectores entre os filtros.
Se o senhor estiver tentando excluir determinadas pessoas (por exemplo, "não contém"), use conectores AND. Se o senhor usar conectores OR, um perfil só precisará corresponder a um ou outro filtro. Em outras palavras, o perfil pode não corresponder ao primeiro filtro "doesn't contain", mas corresponde ao restante e, portanto, acionará o fluxo. Se o senhor usar um conector AND, o evento precisará corresponder a ambos os filtros.

Veja o exemplo abaixo:

Digamos que o senhor estabeleça condições como no exemplo abaixo. Se o pedido de uma pessoa contiver a coleção "New Items", ela será reprovada no primeiro filtro, mas se a lista de itens também não contiver "T-Shirt,", ela será aprovada na segunda parte do filtro e entrará no fluxo. Para cobrir ambos os cenários, o senhor precisa conectá-los com AND.

Para corrigir isso: 

1. Exclua o segundo filtro clicando no botão da lixeira no canto inferior direito.
2. Clique em AND para adicionar um conector AND e um novo filtro.
3. Recrie seu filtro anterior.
   

Consulte este guia da nossa Central de Ajuda para obter uma explicação mais detalhada: Guia AND vs. OR