Apenas configuração manual. Zenovay não oferece atualmente um plugin oficial do WordPress ou uma extensão WooCommerce. Você adiciona o rastreador da mesma forma que faria em qualquer site WordPress: uma única tag <script> no arquivo header.php do seu tema, ou um pequeno snippet wp_head em functions.php. Este artigo responde as perguntas que surgem depois disso — onde você vê "o rastreador" abaixo, significa aquela tag de script, não um plugin instalável.
A instalação padrão é uma linha. O guia completo — cabeçalho do tema, functions.php, WooCommerce e snippets de objetivos — vive em visão geral da integração do WordPress. Este FAQ cobre as perguntas que surgem depois.
Onde obtenho meu código de rastreamento?
No painel do Zenovay, abra o painel do seu site a partir de Domínios, depois vá para Configurações → Geral. O código de rastreamento (e o snippet completo que você pode copiar) é mostrado lá. Cole este código no atributo data-tracking-code da tag de script:
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
Se preferir não editar arquivos de tema manualmente, o snippet pode ir em um plugin de "scripts de cabeçalho/rodapé" (por exemplo WPCode ou Insert Headers and Footers) — qualquer coisa que permita adicionar código ao <head> funciona.
Funciona com plugins de cache?
Sim. O rastreador é uma simples tag <script> no HTML da sua página, por isso faz parte da página em cache assim como qualquer outra marcação. WP Super Cache, W3 Total Cache, LiteSpeed Cache e WP Rocket são todos compatíveis.
Algumas armadilhas de cache:
-
Depois de adicionar o snippet pela primeira vez, limpe o cache uma vez para que a tag apareça no HTML em cache.
-
Se você usar um otimizador JS que combina ou adia scripts (WP Rocket, LiteSpeed, Autoptimize), exclua
api.zenovay.comda otimização para que o rastreador não seja reescrito. Para WP Rocket:add_filter('rocket_exclude_js', function ($excluded) { $excluded[] = 'api.zenovay.com'; return $excluded; }); -
Se você colocar o WordPress atrás de uma CDN (Cloudflare, Bunny, etc.), limpe também o cache de borda uma vez após adicionar o snippet.
E com WordPress multisite?
O snippet fica no seu tema, então se aplica a cada site que usa esse tema. Para controlar qual código de rastreamento cada site envia, cole o código correto por site.
Para usar um código de rastreamento em toda a rede, configure-o de um único lugar no seu tema ou um arquivo de funções ativado em nível de rede:
add_filter('zenovay_tracking_code', function () {
return 'YOUR_NETWORK_TRACKING_CODE';
});
Se você quiser que cada site seja reportado separadamente, crie um site separado no seu painel do Zenovay e dê a cada site seu próprio código de rastreamento.
Ele vai entrar em conflito com minhas outras ferramentas de análise?
Não. O snippet apenas adiciona uma tag <script> apontando para api.zenovay.com. Ele não intercepta visualizações de página de outras ferramentas, não sobrescreve dataLayer e não toca em instalações existentes de Google Analytics, Plausible, Fathom ou Matomo. Você pode executar Zenovay ao lado delas.
Se você usar um plugin de Content Security Policy, adicione api.zenovay.com à suas listas permitidas script-src e connect-src para que o script possa carregar e postar eventos.
Ele honra os banners de consentimento de cookies?
O rastreador pode funcionar em modo cookieless — sem cookies, sem localStorage — que é legal antes do consentimento sob a maioria dos regimes de privacidade. Ative-o adicionando data-cookieless="true" ao snippet:
<script
defer
data-tracking-code="YOUR_TRACKING_CODE"
data-cookieless="true"
src="https://api.zenovay.com/z.js">
</script>
Se você preferir carregar Zenovay apenas após um visitante aceitar, controle o snippet com seu plugin de consentimento (Cookiebot, Complianz, Iubenda) para que a tag seja adicionada apenas ao consentimento. Veja O Zenovay usa cookies? para o detalhamento completo de rastreamento cookieless vs. controlado por consentimento.
Como excluo minhas próprias sessões de administrador?
Para que suas próprias visitas conectadas não contem para sua cota de eventos, envolva o snippet em uma verificação de role em functions.php e pule-o para administradores:
add_action('wp_head', function () {
if (current_user_can('manage_options')) {
return; // don't track admins
}
?>
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
<?php
});
Como removo o rastreador com limpeza?
Exclua o snippet em todos os lugares onde o adicionou — a tag de script em header.php, o hook wp_head em functions.php ou a entrada no seu plugin de scripts de cabeçalho/rodapé — depois limpe seu cache. Pronto; não há plugin para desativar.
Remover o snippet apenas para a coleta de novos dados. Os dados existentes na sua conta do Zenovay não são afetados — você apagaria o site do seu painel separadamente se quiser purgá-lo completamente.