Central de ajuda
Tudo para instalar o Owlpfy na sua loja e tirar o máximo do painel.
Onde está o código de instalação
Cada loja tem um código próprio. No painel, abra Configurações → Loja → Instalação e clique em Copiar código. Ele tem esta cara (a sua chave é diferente):
<!-- Owlpfy -->
<script>
(function(w,d,s,u){ ... })(window,document,'script','https://…/t/SUA_CHAVE.js');
</script>
O código precisa estar em todas as páginas da loja, de preferência logo antes de </head>. Ele carrega em segundo plano e não deixa o site mais lento.
Shopify
- No admin da Shopify, abra Loja virtual → Temas.
- No tema publicado, clique em ⋯ → Editar código.
- Abra o arquivo theme.liquid, procure
</head>e cole o código logo antes. - Clique em Salvar.
Na Shopify, produto visto, carrinho (com fotos e valores reais) e início do checkout são detectados sozinhos.
Compras na Shopify: nas lojas com o checkout novo da Shopify, os scripts do tema não rodam na página de obrigado. Depois do primeiro pedido, confira em Vendas se a compra apareceu. Se não aparecer, fale com o suporte.
Nuvemshop
- No painel da Nuvemshop, abra Configurações → Códigos externos.
- Se houver um campo para scripts no
<head>das páginas, cole o código nele e salve. - Se não houver, instale pelo Google Tag Manager.
WordPress e WooCommerce
- Instale o plugin gratuito WPCode (Plugins → Adicionar novo → “WPCode”).
- Abra Code Snippets → Header & Footer.
- Cole o código no campo Header e clique em Salvar.
No WooCommerce, produto visto, adição ao carrinho, checkout e compra (na página de pedido recebido) são detectados sozinhos.
Google Tag Manager
Funciona em qualquer plataforma que já tenha o Tag Manager instalado:
- No Tag Manager, crie uma nova tag do tipo HTML personalizado.
- Cole o código do Owlpfy.
- Em acionamento, escolha All Pages (todas as páginas).
- Salve e clique em Enviar para publicar.
Outras plataformas
VTEX, Yampi, Tray, Loja Integrada, Wix e outras: procure nas configurações da loja uma opção de scripts, códigos personalizados ou código no <head> e cole o código lá. Se a plataforma não tiver essa opção, use o Google Tag Manager.
Conferir se funcionou
- Abra a sua loja em outra aba do navegador.
- No painel, vá em Tempo real: você deve aparecer na maquete em alguns segundos.
- Em Configurações → Loja, a instalação passa a mostrar Recebendo dados.
Não apareceu? Confira se o código está em todas as páginas e se o endereço da loja está nos domínios permitidos.
Vendas e carrinho
O Owlpfy registra as etapas de compra de três jeitos, sem você precisar escolher:
- Automático na Shopify e no WooCommerce.
- Pelos pixels que a loja já tem: os eventos do Pixel da Meta, do Pixel do TikTok e do Google Analytics 4 (produto visto, carrinho, checkout e compra) são lidos pelo Owlpfy.
- Por código, se o seu desenvolvedor preferir enviar direto:
owlpfy('add_to_cart', { items: [{ id: 'SKU-1', name: 'Tênis', price: 349.9, quantity: 1 }] });
owlpfy('purchase', { order_id: 'PED-1001', value: 349.9, currency: 'BRL' });
Eventos aceitos: view_item, add_to_cart, remove_from_cart, begin_checkout, purchase, lead e sign_up.
Páginas de checkout e de obrigado
Se o seu checkout ou a página de obrigado têm um endereço próprio, informe em Configurações → Loja → Avançado. Basta um pedaço do endereço, por exemplo /checkout e /obrigado. Assim essas visitas contam como início de checkout e compra no funil.
Campanhas e UTMs
As visitas são separadas em Meta Ads, Google Ads, TikTok Ads e Orgânico pelas UTMs do link e pelos identificadores de clique dos anúncios. Para ver cada campanha, conjunto e anúncio no painel, use UTMs nos anúncios. No Meta Ads, em “Parâmetros de URL”:
utm_source=facebook&utm_medium=cpc&utm_campaign={{campaign.name}}&utm_content={{ad.name}}&utm_term={{adset.name}}
Domínios permitidos
Por segurança, cada loja só aceita dados do próprio domínio e dos subdomínios dele, para ninguém copiar o seu código em outro site. Se a sua loja também responde em outro endereço (por exemplo sualoja.myshopify.com), o painel mostra um aviso em Configurações → Loja com o botão Permitir. Você também pode editar a lista em Avançado → Domínios permitidos.
Tempo real
A maquete mostra cada pessoa na loja agora, em qual área (entrada, produtos, carrinho, checkout), com o valor do carrinho e a origem. Clique numa pessoa para ver os detalhes. A partir do plano Essencial, use Ver transmissão para assistir à tela dela ao vivo.
Gravações e mapas de calor
- Em Configurações → Loja → Gravações você escolhe a porcentagem de visitas gravadas.
- O que é digitado em formulários fica escondido nas gravações por padrão.
- As gravações são apagadas a cada poucos dias para manter o sistema rápido. Os números de visitas, vendas e funil ficam guardados por 90 dias.
- Os mapas de calor mostram cliques e rolagem de cada página, separados por computador, tablet e celular.
Equipe e atividade
Em Configurações → Equipe você convida pessoas por e-mail ou link, com três níveis: Dono, Administrador (muda lojas e convida) e Somente leitura. Na mesma tela, a Atividade recente mostra quem entrou e o que foi alterado.
Planos e cobrança
- Toda conta nova começa no plano Gratuito, sem cartão. Os planos pagos são liberados assim que o pagamento é aprovado.
- Em Configurações → Plano você vê o uso do mês e muda de plano. O pagamento é mensal, no cartão de crédito, pelo Mercado Pago.
- O uso zera todo dia 1. Em 80% do plano você recebe um aviso; em 100% as gravações novas param; com 10% a mais, as visitas novas deixam de ser registradas até o mês seguinte ou a mudança de plano.
- Você pode cancelar quando quiser e continua com o plano até o fim do mês pago.
Fale com a gente pelo WhatsApp.