O que você vai aprender

Saiba dicas de solução de problemas quando um formulário de registro na sua conta da Klaviyo não estiver funcionando como esperado, revisando problemas comuns e soluções para esses problemas.

Confira nosso guia sobre como gerenciar seus formulários de registro para saber mais sobre como editar o funcionamento dos seus formulários.

Como testar seus formulários

Depois de publicar um formulário de registro, é importante testar se ele tem a aparência e o comportamento que você espera. Testar seu formulário também pode ajudar você a delimitar o problema, para saber como solucionar.

Ao testar um formulário de registro, use um endereço de e-mail exclusivo (ou seja, um que você ainda não tenha usado nesse formulário) para obter os melhores resultados.

Como resolver problemas de formulários de registro da Klaviyo

Observe que os formulários de registro não serão renderizados em navegadores que usam o Internet Explorer. Os formulários de registro personalizados continuarão sendo renderizados para quem usa qualquer tipo de navegador da web.

Se você tiver um formulário de registro da Klaviyo que não está funcionando corretamente, talvez seja necessário seguir etapas de solução de problemas diferentes. Abaixo estão problemas comuns que podem ocorrer quando você publica um formulário de registro no editor de formulários da Klaviyo. Clique no menu suspenso para ver as soluções de cada problema.

O formulário de registro não está aparecendo no site

Se o seu formulário estiver publicado no Klaviyo, mas não estiver sendo exibido:

  • Verifique se seu formulário está ativo. Na aba Formulários de registro, você deve ver "Ativo" com uma seta verde na coluna Status do seu formulário.
    • Como mencionado acima, os formulários de registro da Klaviyo não aparecerão no Internet Explorer.
  • Verifique se você seguiu todas as instruções para instalar e ativar o snippet de código do Klaviyo.js no site (também conhecido como rastreamento "com atividade no site").
  • Se você estiver usando um formulário incorporado, verifique se você instalou o código de incorporação correto no código do seu site, exatamente como ele aparece no modelo de instalação.
  • Revise a seção Segmentação e comportamentos no editor de formulário de registro:
    • Em Segmentação, garanta que o formulário esteja configurado para ser exibido no URL que você está visualizando ou que você esteja usando um endereço de e-mail exclusivo (conforme descrito na dica de teste acima).
    • Em Momento de exibição, verifique se as configurações de momento de exibição não estão restritivas demais. Se o formulário estiver configurado como Exibir com base em regras, todos os critérios precisarão ser atendidos para que o formulário apareça. Por exemplo, se "Exibir quando o visitante estiver saindo da página" e "Exibir após rolar 60% da página" estiverem selecionados, o visitante precisará rolar 60% da página e demonstrar intenção de saída para que o formulário apareça.
  • Execute novamente o teste no modo anônimo/privado em uma nova janela. Talvez você já tenha fechado o pop-up, e é por isso que ele não está sendo exibido novamente. Colocamos cookies nos navegadores por 1 ano; assim, depois que alguém fecha um pop-up, não verá o mesmo pop-up novamente por mais um ano (a menos que limpe os cookies).
  • Se você estiver usando um formulário incorporado, confirme se o código de incorporação do formulário foi adicionado exatamente como aparece no modal de instalação e se ele foi colado corretamente no código do seu site.
  • Confirme se apenas uma conta Klaviyo está integrada ao seu site. Se você tiver várias contas do Klaviyo para 1 loja, desmarque a opção Adicionar automaticamente o JavaScript onsite do Klaviyo em todas as contas, exceto em 1. Se você instalou manualmente o .js do Klaviyo, Certifique-se de que você instalou o snippet de apenas 1 conta.
  • Para lojas Shopify: com base nas suas configurações de privacidade do cliente na Shopify, a Klaviyo pode não rastrear eventos no site (e, assim, não aplicar certos tipos de segmentação de formulário) para visitantes da sua loja Shopify na UE, no EEE, no Reino Unido e na Suíça, a menos que eles tenham fornecido consentimento.
  • Em geral, se um visitante não consentiu (de outra forma ele seria incluído segundo os requisitos de segmentação) o formulário não aparecerá porque ele não será identificado. A segmentação para esses visitantes será aplicado da seguinte forma:
    • Se você selecionar “Não mostrar para perfis existentes da Klaviyo”, o visitante ainda verá o formulário, já que não será identificado como um perfil existente.
    • Se selecionar “Segmentar visitantes em uma lista ou segmento”, o visitante não verá o formulário, mesmo que esteja na lista ou no segmento, pois não será identificado. Se selecionar “Mostrar a todos os visitantes”, o visitante verá o formulário.
    • Se você selecionar "Mostrar para perfil existente", "Mostrar apenas para assinantes de e-mail" ou "Mostrar apenas para assinantes de SMS", o visitante não verá o formulário porque só será identificado como um perfil existente ou como assinante de e-mail ou de SMS.
    • Determinados disparadores personalizados baseados em informações de cookies e propriedades do usuário não serão acionados devido à falta de identificação.
    • A segmentação por local não é afetada.
    • A segmentação para exibição no tipo de dispositivo (desktop ou celular) não é afetada.
O formulário de registro não é enviado com sucesso

Se o seu formulário não estiver sendo enviado quando você clicar no botão Enviar:

  • Verifique se a lista à qual o formulário está conectado não foi excluída.
  • Verifique se o botão é um botão Enviar, não um botão Fechar. Clique no botão na visualização do editor de formulários para ver isso.
  • Verifique sua caixa de entrada para encontrar um e-mail de confirmação. Se a sua lista estiver configurada como inscrição em duas etapas, você só será adicionado a ela depois de confirmar sua inscrição.
O formulário de registro parece diferente no meu site

Os formulários de registro do Klaviyo devem ser exibidos no seu site conforme foram projetados no editor de formulários do Klaviyo. Se ele parecer diferente, o CSS do seu site está substituindo o estilo do formulário. Para solucionar isso:

  • Procure tags !important no seu CSS e remova-as, se possível.
  • Seu desenvolvedor também pode usar as ferramentas de desenvolvedor do navegador para inspecionar o código do site e identificar o CSS com problema. Se você ainda estiver com problemas, encontre ajuda aqui.
O formulário de registro não está adicionando pessoas à lista

Lembre-se de que todos os formulários da Klaviyo que coletam consentimento de e-mail, consentimento de SMS ou têm um cupom em destaque têm proteções contra bots por padrão. Se a Klaviyo detectar comportamento suspeito ou atividade de bot anterior a partir do endereço IP de um visitante do site, ele verá uma solicitação para resolver um CAPTCHA antes de enviar o formulário.

Se as pessoas estiverem preenchendo seu formulário, mas você não as vir sendo adicionadas à lista à qual seu formulário está conectado:

  • Clique no botão na prévia do editor de formulários e confirme se você selecionou uma lista para enviar.
  • Verifique as configurações de inscrição da sua lista. Se a lista estiver configurada com inscrição em duas etapas (recomendado), é provável que os assinantes ausentes não tenham concluído a etapa de confirmação.

Se o número de envios do formulário não corresponder ao número de pessoas na sua lista:

  • Os assinantes talvez não tenham concluído a etapa de confirmação (se a sua lista estiver configurada como inscrição em duas etapas).
  • Isso também pode indicar entradas duplicadas. Se um assinante preencher um formulário repetidamente, cada entrada contará como uma "envio" na análise do formulário, mas ele só aparecerá na sua lista 1 vez.
  • Também é possível que alguns envios tenham vindo de bots ou de list bombers. O Klaviyo tem proteções contra list bombing para proteger você desses ataques cibernéticos.
Não foi possível detectar a instalação

Você pode receber a mensagem de erro "Não foi possível detectar se os formulários de registro estão instalados com sucesso no seu site. Consulte a documentação de instalação." mesmo tendo adicionado corretamente o snippet de instalação ao seu site (ou usando uma integração predefinida que faz isso automaticamente). Isso pode aparecer se você estiver usando uma plataforma de gerenciamento de tags (ex.: Google Tag Manager) ou algum outro método para disponibilizar o snippet no seu site quando a página for carregada.

Esta mensagem não impedirá você de publicar um formulário, então, se o snippet estiver instalado corretamente no site, tudo bem ignorá-la. Se você ainda estiver com problemas, entre em contato conosco.

Leitores de tela não detectam formulário de registro (JAWS)

Vale observar que o JAWS, um programa leitor de tela para computador do Microsoft Windows, pode não estar detectando formulários de registro no seu site que foram criados no Klaviyo. Para garantir que visitantes do site que usam o JAWS ainda possam interagir com formulários de registro no seu site, sugerimos adicionar um snippet extra de código ao seu site, que o torna mais acessível ao JAWS.

Copie o snippet de código a seguir e cole-o no arquivo de tema principal do seu site para que o JAWS detecte e leia seus formulário de registro da Klaviyo:

text

 {
  const ariaHiddenValue = $el ? $el.getAttribute('aria-hidden') : null;
  return ariaHiddenValue === 'true';
};

const isHTMLElement = (node) => {
  return node.nodeType === Node.ELEMENT_NODE;
};

const isModal = (node) => {
  if (node.children.length !== 1) return false;
  const modalContainer = Array.from(node.children[0].classList).some((cls) => cls.startsWith('kl-private-reset'));

  return modalContainer;
};

const getTopLevelDomElements = () => {
  const body = document.body;

  // Use the children property to get all top-level elements
  const topLevelNodes = Array.from(body.children).filter((node) => {
    if (isHTMLElement(node)) {
      const tagName = node.tagName.toLowerCase();

      console.log('isModal: ', isModal);

      // Filter out specific tags
      return (
        tagName !== 'script' &&
        tagName !== 'link' &&
        tagName !== 'iframe' &&
        tagName !== 'style' &&
        !isModal(node)
      );
    }
    return false;
  });

  return topLevelNodes;
};

const a11yHideTopLevelElements = () => {
  const $elements = getTopLevelDomElements();

  $elements.forEach(($el) => {
    if (!isAriaHiddenTrue($el)) {
      $el.setAttribute('kl-aria-hidden', 'true');
      $el.setAttribute('aria-hidden', 'true');
    }
  });
};

const a11yShowTopLevelElements = () => {
  const $elements = getTopLevelDomElements();

  $elements.forEach(($el) => {
    if ($el.hasAttribute('kl-aria-hidden')) {
      $el.removeAttribute('kl-aria-hidden');
      $el.removeAttribute('aria-hidden');
      

Recursos adicionais

  • How to manage your sign-up forms

    Learn tips for managing your existing sign-up forms so you can ensure they are aesthetically pleasing and functional for customers interested in engaging with your brand.

  • Getting started with sign-up forms

    Learn how to create and customize sign-up forms in Klaviyo to publish on your website so you can engage shoppers, collect emails and phone numbers, and build long-lasting customer relationships.

  • Understanding targeting and behavior settings for sign-up forms

    Learn about the Targeting & behavior section of the sign-up form editor, where you can control and change when a form appears on your site, and who sees it. Open the form editor for an existing sign-up form, then select Targeting & behavior to adjust the display and targeting settings covered in this guide.

  • Klaviyo practitioner certificate
Esse artigo foi útil?
Use esse formulário somente para dar feedback sobre os artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Community
Conecte-se com colegas, parceiros e especialistas da Klaviyo para ter ideias, compartilhar insights e tirar dúvidas.
Parceiros
Contrate um especialista certificado pela Klaviyo para ajudá-lo com uma tarefa específica ou para gerenciamento contínuo de marketing.
Suporte

Acesse o suporte na sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano