Solução de problemas com formulários de inscrição
O senhor aprenderá
Aprenda dicas de solução de problemas para quando um formulário de inscrição na sua conta Klaviyo não estiver funcionando como esperado, analisando problemas comuns e soluções para esses problemas.
Consulte nosso guia sobre como gerenciar seus formulários de inscrição para saber mais sobre como editar o funcionamento dos formulários.
Como testar seus formulários
Depois de publicar um formulário de inscrição, é importante testar se ele tem a aparência e o comportamento desejados. Testar o formulário também pode ajudar a reduzir o problema para que o senhor saiba como solucioná-lo.
Ao testar um formulário de registro, use um endereço de e-mail exclusivo (ou seja, um endereço que não tenha sido usado anteriormente para esse formulário) para obter melhores resultados.
Solução de problemas com os formulários de inscrição do Klaviyo
Observe que os formulários de inscrição não serão renderizados para navegadores que usam o Internet Explorer. Os formulários de inscrição personalizados continuarão a ser renderizados para aqueles que usam qualquer tipo de navegador da Web.
Se a inscrição no Klaviyo não estiver funcionando corretamente, talvez seja necessário seguir várias etapas de solução de problemas. Veja abaixo os problemas comuns que podem surgir quando o senhor publica um formulário de inscrição no editor de formulários do Klaviyo. Clique no menu suspenso para ver as soluções para cada problema.
O formulário de inscrição não está aparecendo no site
Se o formulário estiver publicado no Klaviyo, mas não estiver sendo exibido:
- Verifique se o formulário está ativo. Na guia Sign-up forms (Formulários de inscrição), o senhor deverá ver "Live" com uma seta verde sob a coluna Status (Status ) do formulário.
- Conforme mencionado acima, os formulários de inscrição do Klaviyo não serão exibidos no Internet Explorer.
- Verifique se o senhor seguiu todas as instruções para instalar e ativar o snippet de código do Klaviyo.js no local (também conhecido como "Active on Site" tracking).
- Se estiver usando um formulário incorporado, verifique se o código incorporado correto está instalado no código do site exatamente como aparece no modelo de instalação.
- Analise a seção Targeting & Behaviors no editor do formulário de inscrição:
- Em Targeting (Direcionamento), verifique se o formulário está configurado para ser exibido no URL que o senhor está visualizando ou se está usando um endereço de e-mail exclusivo (conforme descrito na dica de teste acima).
- Em Display Timing (Tempo de exibição), verifique se as configurações de tempo de exibição não são muito restritivas. Se o formulário for definido como Show based on rules (Mostrar com base em regras), todos os critérios deverão ser atendidos para que o formulário seja exibido. Por exemplo, se "Show when the visitor is exiting the page" e "Show after scrolling 60% of the page" forem ambos selecionados, o visitante deverá percorrer 60% da página e mostrar intenção de saída para que o formulário seja exibido.
- Execute novamente o teste no modo de navegação anônima/privada em uma nova janela. Talvez o senhor já tenha fechado o pop-up e, por isso, ele não está sendo exibido novamente. Nós armazenamos cookies nos navegadores por um ano, portanto, quando 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 estiver usando um formulário incorporado, confirme se o código incorporado do formulário foi adicionado exatamente como aparece no modal de instalação e se foi colado corretamente no código do seu site.
- Confirme se apenas uma conta Klaviyo está integrada ao seu site. Se o senhor tiver várias contas do Klaviyo para uma loja, desmarque a opção Adicionar automaticamente o javascript do site do Klaviyo em todas as contas, exceto em uma. Se o senhor instalou manualmente o .js do Klaviyo, certifique-se de que o senhor só instalou o snippet de uma conta.
- Para lojas do Shopify: Com base em suas configurações de Privacidade do Cliente no Shopify, a Klaviyo pode não rastrear eventos no local (e, portanto, não aplicar certos tipos de segmentação de formulário) para visitantes de sua loja do Shopify na UE, EEE, Reino Unido e Suíça, a menos que eles tenham fornecido consentimento.
- Em geral, se um visitante não consentiu e, de outra forma, teria sido incluído de acordo com os requisitos de direcionamento, ele não verá o formulário porque não será identificado. A segmentação para esses visitantes será aplicada da seguinte forma:
- Se o senhor selecionar "Don't show to existing Klaviyo profiles", o visitante ainda verá o formulário porque não será identificado como um perfil existente.
- Se o senhor selecionar "Target visitors in a list or segment", o visitante não verá o formulário (mesmo que esteja na lista ou no segmento) porque não será identificado. Se o senhor selecionar "Show to all visitors", o visitante o verá.
- Se o senhor selecionar "Show to existing profile," " Show to email subscribers only," ou "Show to SMS subscribers only," o visitante não verá o formulário porque será identificado apenas como um perfil existente, e-mail ou assinante de SMS.
- Determinados acionadores 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, celular) não é afetada.
O formulário de inscrição não é enviado com sucesso
Se o formulário não estiver sendo enviado quando o usuário 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 e não um botão Fechar. Clique no botão na visualização do editor de formulários para ver isso.
- Verifique se há um e-mail de confirmação em sua caixa de entrada. Se sua lista estiver configurada para double opt-in, o senhor não será adicionado a ela até que confirme sua assinatura.
O formulário de inscrição parece diferente em meu site
Os formulários de inscrição da Klaviyo devem ser renderizados em seu site conforme foram criados no editor de formulários da Klaviyo. Se a aparência for diferente, o CSS do seu site está substituindo o estilo do formulário. Para solucionar o problema:
- Procure por tags !important em seu CSS e remova-as, se possível.
- Seu desenvolvedor também pode usar as ferramentas de desenvolvimento do navegador para inspecionar o código do site e identificar o CSS problemático. Se o senhor ainda estiver com problemas, procure ajuda aqui.
O formulário de inscrição não está adicionando pessoas à lista
Lembre-se de que todos os formulários do site Klaviyo que coletam e-mail, consentimento para SMS ou têm um recurso de cupom têm proteções de bots implementadas por padrão. Se a Klaviyo detectar um comportamento suspeito ou uma atividade anterior de bot do endereço IP de um visitante do site, ele será solicitado a resolver um CAPTCHA antes de enviar o formulário.
Se as pessoas estão preenchendo o formulário, mas o senhor não as vê sendo adicionadas à lista à qual o formulário está conectado:
- Clique no botão na visualização do editor de formulários e certifique-se de que o senhor selecionou uma lista para enviar.
- Verifique as configurações de opt-in de sua lista. Se a lista estiver configurada para double opt-in (recomendado), é provável que os assinantes ausentes não tenham concluído a etapa de confirmação.
Se o número de envios de formulários não corresponder ao número de pessoas em sua lista, o senhor poderá ter uma resposta:
- Os assinantes podem não ter concluído a etapa de confirmação (se sua lista estiver configurada para double opt-in).
- Isso também pode refletir entradas duplicadas. Se um assinante preencher um formulário repetidamente, cada entrada contará como um "envio" em sua análise de formulário, mas ele só aparecerá em sua lista uma vez.
- Também é possível que alguns envios tenham sido feitos por bots ou bombardeiros de listas. A Klaviyo tem uma lista de proteções de bombardeio para proteger o senhor contra esses ataques cibernéticos.
Não foi possível detectar a instalação
O senhor pode receber a mensagem de erro "Unable to detect that sign-up forms are successfully installed on your site. Consulte a documentação de instalação." mas adicionou corretamente o snippet de instalação ao seu site (ou está usando uma integração pré-construída que faz isso automaticamente). Isso pode aparecer se o senhor estiver usando uma plataforma de gerenciamento de tags (por exemplo, o Google Tag Manager) ou algum outro método para fornecer o snippet ao seu site quando a página for carregada.
Essa mensagem não o impedirá de publicar um formulário, portanto, se o snippet estiver instalado corretamente no site, não haverá problema em ignorá-la. Se o senhor ainda estiver tendo problemas com isso, entre em contato conosco.
Leitores de tela não detectam formulários de inscrição (JAWS)
Observe que o JAWS, um programa de leitura de tela do computador para Microsoft Windows, pode não estar detectando formulários de inscrição no seu site que foram criados no Klaviyo. Para garantir que os visitantes do site que usam o JAWS ainda possam interagir com os formulários de inscrição em seu site, sugerimos adicionar um trecho extra de código ao seu site que o torne mais acessível ao JAWS.
Copie o seguinte trecho de código e cole-o no arquivo de tema principal do seu site para que o JAWS detecte e leia os formulários de inscrição do Klaviyo:
{
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
- Como gerenciar seus formulários de inscrição
Aprenda dicas para gerenciar seus formulários de inscrição existentes para garantir que eles sejam esteticamente agradáveis e funcionais para os clientes interessados em se envolver com sua marca.
- Introdução aos formulários de registro
Saiba como criar e personalizar formulários de registro na Klaviyo para interagir com compradores, coletar e-mails e números de telefone e criar relacionamentos duradouros.
- Compreensão das configurações de segmentação e comportamento para formulários de inscrição
Saiba mais sobre a seção Targeting & behavior do editor de formulários de inscrição, onde é possível controlar e alterar quando um formulário aparece no seu site e quem o vê. Abra o editor de formulários para um formulário de inscrição existente e selecione Targeting & behavior para ajustar as configurações de exibição e direcionamento abordadas neste guia.
- Certificação de praticante da Klaviyo