Se o popup tá Ativo na Kovyo mas nunca dispara no storefront, passa por essas checagens em ordem. As três primeiras pegam a maioria dos casos.

1. App embeds ativos?

Causa #1 disparada.

  1. Admin Shopify → Loja Online → Temas → Customizar no tema ativo.
  2. Click no ícone Incorporações de app (quebra-cabeça) no menu esquerdo.
  3. Kovyo Popup precisa estar ligado. Se também usa tracker, Kovyo Tracker ligado também.
  4. Click em Salvar no topo direito.

App embeds são por tema — se você troca de tema, precisa ligar de novo no novo tema.

2. Popup status = Ativo?

Na Kovyo: lista Popups. O badge ao lado do nome deve dizer Ativo. Drafts e popups pausados não renderizam mesmo com app embed ligado.

3. Navegando como visitante recorrente?

Cada popup tem regra de frequência. Por default não mostramos o mesmo popup pro mesmo visitante mais de uma vez por sessão. Pra forçar:

  1. Abre o storefront em janela anônima.
  2. Ou limpa kovyo.session no localStorage do navegador.

4. Filtro de páginas

Nas configs do popup, Exibir nas páginas restringe quais páginas disparam. Se setou “Páginas de produto” e tá testando na home, não vai disparar.

5. Condições de trigger

Confirma:

  • Tempo 5s — espera 5s na página.
  • Scroll 50% — rola até a metade de uma página alta o suficiente.
  • Exit intent — move o cursor pro topo-esquerdo da janela.

6. Erros de console

Abra DevTools (F12) → Console. Se algo começa com [kovyo-popup], é o runtime te dizendo o problema — copia/cola pro suporte.

7. Limites do plano

Plano Free tem um popup ativo. Se você tem dois e um não aparece, só um tá sendo servido de fato.

Continua sem resolver?

Email help@kovyo.co com:

  • URL do storefront
  • Nome do popup
  • Print da aba de App embeds
  • Eventuais erros do console