6 min de leitura

Integração com Wix

Adicione análises focadas em privacidade e sem cookies ao seu site Wix em menos de cinco minutos. O Zenovay funciona nos planos Wix Free, Premium e Business / VIP, com integrações mais profundas disponíveis para desenvolvedores Wix Velo.

O caminho mais rápido é Settings → Custom Code → Head. Você precisa de um plano Wix Premium ou superior para usar o Custom Code.

Início rápido

Etapa	Onde	O que fazer
1	Painel do Zenovay	Copie seu snippet de rastreamento
2	Admin do Wix → Settings → Custom Code	Cole o snippet em um novo elemento de código no Head
3	Publique seu site	Clique em Publish para implantar a alteração
4	Painel do Zenovay	Aguarde 1–2 minutos e verifique os visitantes em tempo real

Método 1: Custom Code (Recomendado)

O Custom Code do Wix permite injetar qualquer snippet HTML no <head> de todas as páginas. É a mesma abordagem que o Wix recomenda para o Google Analytics e o Meta Pixel.

Passo a passo

Abra seu site Wix no editor ou painel.
Vá em Settings (ícone de engrenagem na barra lateral esquerda) → Custom Code.
Clique em + Add Custom Code.
Cole o snippet do Zenovay do seu painel:

<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

Configure o posicionamento:
- Add Code to Pages: All pages → Load code on each new page
- Place Code in: Head
- Name: Zenovay Analytics (para encontrar facilmente depois)
Clique em Apply.
Clique em Publish no topo do editor — o Custom Code só funciona no site publicado, não na visualização prévia.

Verifique a instalação

Abra seu site publicado em uma janela anônima e visualize o código-fonte da página (Cmd/Ctrl+U). Procure pela linha <script defer data-tracking-code=.... Depois abra a visualização em tempo real do Zenovay — sua própria visita deve aparecer em ~30 segundos.

Método 2: Wix Velo (para desenvolvedores)

Se seu site usa Wix Velo (anteriormente Corvid) e você precisa rastrear páginas do roteador, transições dinâmicas de página ou eventos exclusivos de membros, instale o Zenovay via Velo. Isso dá acesso à API de eventos window.zenovay() completa.

Adicione o script via Velo

No Modo Dev do Velo do seu site, abra masterPage.js e adicione:

import wixWindow from 'wix-window';

$w.onReady(() => {
  if (wixWindow.rendering.env !== 'browser') return;

  const s = document.createElement('script');
  s.defer = true;
  s.src = 'https://api.zenovay.com/z.js';
  s.setAttribute('data-tracking-code', 'YOUR_TRACKING_CODE');
  document.head.appendChild(s);
});

Rastreie eventos personalizados

Após o carregamento do script, você pode disparar eventos de qualquer página do Velo:

$w('#submitButton').onClick(() => {
  if (window.zenovay) {
    window.zenovay('track', 'lead_form_submitted', {
      form_id: 'homepage-cta',
      plan_interest: $w('#planDropdown').value,
    });
  }
});

Identifique membros

Se você usa Wix Members, pode vincular um ID de visitante estável:

import { currentMember } from 'wix-members';

currentMember.getMember()
  .then(member => {
    if (member && window.zenovay) {
      window.zenovay('identify', {
        userId: member._id,
        email: member.loginEmail,
        name: member.profile?.nickname,
      });
    }
  });

Rastreamento de eventos específicos do Wix

Recurso do Wix	Como rastrear
Envio de formulário de contato	Configure um evento personalizado via Wix Automations ou o callback `onWixFormSubmit` do Velo
Compra no Wix Stores	Use a API de receita com o webhook de pedido, ou dispare `window.zenovay('track', 'purchase', { revenue, currency })` da página de agradecimento
Agendamento no Wix Bookings	Evento de servidor `wix-bookings-backend` no Velo → chame nossa API de rastreamento server-side
Inscrição em newsletter	`onWixFormSubmit` do Velo no formulário de inscrição, dispare `window.zenovay('track', 'signup', { source: 'newsletter' })`

Requisitos do plano

Wix Free: Custom Code não está disponível. Você deve fazer upgrade para o Premium (a partir de $16/mês) para usar scripts de terceiros.
Wix Premium (Combo, Unlimited, Pro): Custom Code funciona em todas as páginas.
Wix Business / VIP: Custom Code + Wix Velo + hooks server-side disponíveis.
Wix Studio (o editor mais novo): O Custom Code fica em Site Settings → Tracking & Analytics → + New Tool. Escolha Custom e cole o mesmo snippet no slot Head.

Problemas comuns

O snippet só dispara no site publicado. O Custom Code do Wix é intencionalmente removido na visualização prévia/editor. Se você não vê tráfego, certifique-se de ter clicado em Publish e de estar testando a URL ao vivo (não editor.wix.com).

Atraso de cache. O Wix faz cache do HTML publicado de forma agressiva. Após publicar, aguarde 5–10 minutos antes de concluir que a instalação está com problema — e force a atualização com Cmd/Ctrl+Shift+R ao testar.

Wix Studio usa um menu diferente. No Wix Studio (lançado em 2024) o caminho é Settings → Tracking & Analytics, não Custom Code. O snippet em si é idêntico.

A navegação SPA não é rastreada automaticamente em todos os temas. O Wix renderiza a maioria das páginas como templates server-side completos, então o rastreamento de visualização de página padrão funciona. Se você usa um roteador Velo ou um template com estilo SPA, chame window.zenovay('trackPageView') manualmente na mudança de rota.

Não duplique a instalação. Se você colou o snippet anteriormente no tema via um App do Wix e agora está usando Custom Code, cada visita será contada duas vezes. Escolha um método.

Solução de problemas

Sintoma	Causa provável	Correção
Sem dados no painel	Site não publicado	Clique em Publish no editor
Sem dados no painel	Custom Code direcionado apenas para páginas específicas	Verifique Add Code to Pages → All pages
Visualizações de página duplicadas	Snippet colado tanto no Custom Code quanto no tema	Remova um
Dados apenas em algumas páginas	Load on first page only selecionado	Mude para Load code on each new page
Visualização em tempo real vazia mas a aba Network mostra `/event` 200	Bloqueador de anúncios no seu próprio navegador bloqueando a chamada do painel	Teste em modo anônimo com extensões desativadas

Privacidade e conformidade

O rastreador do Zenovay funciona sem cookies. Se você está incorporando em um site regulamentado (UE/Reino Unido/Suíça/Brasil/Califórnia), você pode ativar o modo sem cookies adicionando data-cookieless="true" à tag do script:

<script defer
        data-tracking-code="YOUR_TRACKING_CODE"
        data-cookieless="true"
        src="https://api.zenovay.com/z.js"></script>

Neste modo, nenhum cookie ou entrada de armazenamento local é gravado — os IDs de visitante existem apenas para a aba atual. Consulte o guia de Conformidade de Privacidade para todos os detalhes.

Recursos relacionados

Precisa de ajuda? Entre em contato pelo [email protected] ou visite nossa Central de Ajuda.