A Kovyo é instalada pela Shopify App Store. O fluxo todo são dois cliques de consentimento e um toggle único no editor de tema — sem código, sem copy-paste de snippets.
1. Instalar pela App Store
- Abra a página da Kovyo na Shopify App Store.
- Clique em Adicionar app e confirme a instalação.
- A Shopify redireciona pro
app.kovyo.cocom sua loja já conectada. O wizard de onboarding roda automaticamente.
2. Ativar os app embeds no storefront
Os popups e o tracker da Kovyo são entregues via App embeds da Shopify — pequenos blocos de tema que o lojista controla no editor de tema. Pra encontrar pelo caminho manual:
- No admin Shopify: Loja Online → Temas.
- Clique em Customizar no tema ativo.
- No menu da esquerda, ícone de quebra-cabeça → Incorporações de app.
- Ative Kovyo Popup e Kovyo Tracker.
- Clique em Salvar no canto superior direito.
Os dois embeds só rodam após o page load completo, então não afetam o Lighthouse do storefront.
3. Verificar a instalação
Abre o storefront em uma aba anônima. Em até ~5 segundos depois de carregar qualquer página, o popup ativo deve disparar (se você tiver um). O tracker também começa a logar eventos silenciosamente — dá pra checar em Reports no painel da Kovyo.
Se nada disparar, veja o artigo de troubleshooting.
O que é instalado
| O que | Onde |
|---|---|
| Permissões do app | Token OAuth criptografado no nosso DB |
| Runtime do popup no storefront | App embed kovyo-popup, ~6 kB gzipped |
| Tracker de visitantes | App embed kovyo-tracker, ~3 kB gzipped |
| Webhooks GDPR | Auto-registrados na Shopify na instalação |
Nenhum arquivo de tema é modificado. Desinstalar a Kovyo remove
os dois embeds e dispara o webhook shop/redact da Shopify 48h
depois — nesse ponto a gente apaga toda linha vinculada à sua loja.