Documentação

Como funciona o ZigTracker

Da instalação ao primeiro relatório. A configuração completa leva cerca de 15 minutos e não depende de desenvolvedor — mas se você tiver um, este guia foi escrito para os dois lerem.

O que a plataforma faz

O Pixel da Meta roda dentro do navegador do visitante. Bloqueador de anúncio, o ITP do Safari e o iOS derrubam parte das chamadas antes de saírem do aparelho — e a compra por Pix ou boleto costuma ser confirmada horas depois, quando a aba já fechou há muito tempo.

O ZigTracker registra o evento no seu domínio e o reenvia ao servidor da Meta pela Conversions API, carregando o mesmo event_id do pixel. A Meta junta os dois e conta uma vez só. Além disso, lê a sua conta de anúncios pela API oficial — é o que traz investimento, ROAS e custo por compra para a mesma tela do faturamento.

app.zigtracker.com.br/app

Workspace / Visão geral

09/08 a 22/08

HojeOntem7 dias14 dias

Compras

ROAS

4,12x

Custo por compra

R$ 41,90

Investimento

R$ 1.592,20

Visitantes únicos

2.481

Dados da Meta

consultados na Meta agora

Impressões

48.902

Alcance

31.344

Frequência

1,56

CTR

1,84%

A Visão geral. Os números são de exemplo.

Antes de começar

Tenha em mãos:

• Acesso de administrador à sua loja (Shopify, WooCommerce ou site próprio)
• O Pixel ID da Meta
• Um token de acesso da Meta
• O ID da conta de anúncios (começa com act_)

Sobre o token: gere um de usuário do sistema no Gerenciador de Negócios, com as permissões ads_read e ads_management. O token do Gerenciador de Eventos até envia conversão, mas não lê campanha — com ele, investimento, ROAS e CPM ficam vazios no painel.

1. Criar a conexão

Uma conexão representa uma loja. Ela guarda o endereço do site, o Pixel, o token e a moeda — e gera a chave que identifica os eventos daquela loja.

1
Entre no painel e vá em Configurações.
2
Clique em Adicionar conexão e dê um nome que você reconheça depois — o nome da loja resolve.
3
Informe o domínio da loja. Ele passa a valer como trava: eventos vindos de outro endereço são recusados, para ninguém injetar dado falso na sua conta.

2. Pixel e token da Meta

Ainda em Configurações, cole o Pixel ID e o token. Ao salvar, validamos a credencial na hora contra a API da Meta — você descobre que o token está errado ali, e não três dias depois com o relatório vazio.

Escolha também a moeda da loja. Se a sua conta de anúncios cobra em outra moeda, o painel usa a da conta para gasto e ROAS — e mostra qual é, para não haver dúvida na hora de mexer em orçamento.

3. Instalar o script

Em Instalação, copie a linha pronta com a sua chave e cole antes do fechamento do </head>.

app.zigtracker.com.br/app/instalacao

Seu script

<script src="https://app.zigtracker.com.br/zt.js"
        data-site="ZT-bd5102b7ad3c6baa" defer></script>

Último evento recebido há 4 segundos

Na Shopify: Painel → Loja virtual → Temas → ⋯ → Editar código → theme.liquid.

O script identifica sozinho as páginas de produto, carrinho e checkout — não é preciso marcar evento manualmente. Ele também guarda as UTMs e o fbclid em cookie first-party por 90 dias, de forma que uma compra fechada uma semana depois continue creditada ao anúncio que a originou.

Assim que o primeiro evento chegar, a tela de Instalação mostra “último evento recebido há X segundos”. É a confirmação de que está valendo — não precisa esperar até o dia seguinte para saber.

4. Webhook da Shopify

Este passo é o que garante a venda. O webhook sai do servidor da Shopify, então independe do navegador do comprador — e dispara quando o pagamento é confirmado, que é o momento certo para Pix e boleto.

1
Na Shopify: Configurações → Notificações → Webhooks.
2
Crie um webhook do evento Pagamento do pedido (Order payment), formato JSON.
3
Cole a URL que aparece na tela de Instalação do ZigTracker.
4
Copie a chave secreta que a Shopify mostra e cole em Configurações. Ela é o que prova que o pedido veio mesmo da Shopify.

Pedido com pagamento pendente não vira venda. Pix não confirmado e boleto em aberto são ignorados de propósito: contar receita que não entrou infla o ROAS e ainda ensina a Meta a otimizar para o público errado. Quando a Shopify confirmar, o evento sai automaticamente.

5. Conta de anúncios

Sem isso o rastreamento funciona, mas o painel não tem investimento — logo, não tem ROAS nem custo por compra. Em Configurações, cadastre o ID que começa com act_.

Se a conta aparecer como não sincronizada, quase sempre é atribuição de ativo, e não permissão do token. No Gerenciador de Negócios, vá em Usuários do sistema → seu usuário → Adicionar ativos → Contas de anúncio e marque Gerenciar campanhas. Dar acesso ao seu usuário pessoal não transfere nada para o usuário do sistema, que é quem o token representa.

6. Evitar evento duplicado

Se a sua loja já tem o app oficial da Meta na Shopify, existem dois emissores enviando a mesma compra. A Meta só junta os dois quando eles carregam o mesmo identificador — e o identificador do outro emissor não é nosso para escolher.

Para isso existe o modo “somente Purchase” em Configurações: os eventos de navegação continuam sendo registrados para funil, origem e ROAS, mas só a compra é reenviada à Meta. Você não precisa desligar o app da Meta.

Visão geral

Os cinco cartões respondem, nesta ordem: quantas vendas, quanto elas pagaram do investimento, quanto custou cada uma, quanto foi investido e quantas pessoas passaram pela loja.

Abaixo vem o bloco Dados da Meta, com os números do Gerenciador no mesmo período. Ele existe para cruzamento: divergência grande entre as duas colunas de compras é o sinal de que há perda de rastreamento — que é exatamente o problema que a plataforma resolve.

Sobre datas: os atalhos seguem a convenção do Gerenciador — “últimos 7 dias” termina ontem. E o dia é fechado no fuso da sua conta de anúncios, não no seu relógio. Se a conta estiver em outro fuso, o seletor avisa qual dia é “hoje” para ela.

Gráficos

A Visão geral responde “como está agora”. Os Gráficos respondem “o que mudou” — que costuma ser a pergunta mais útil. Um CPA de R$ 40 não diz nada sozinho; um CPA que saiu de R$ 22 para R$ 40 em quatro dias manda olhar o criativo hoje.

app.zigtracker.com.br/app/graficos

ComprasROASCPACTR

Dezesseis métricas, até quatro sobrepostas, em linha, barra ou área.

Campanhas e anúncios

Os três níveis com o desempenho de cada um, e o resultado somando de baixo para cima. Dá para pausar, reativar, renomear, mudar orçamento e duplicar sem sair da tela.

Campanhas, conjuntos e anúncios

Campanha — Vendas AgostoR$ 980,404,8x

Conjunto — Lookalike 1%R$ 610,105,4x

Anúncio — Vídeo depoimentoR$ 402,006,1x

Anúncio — Carrossel produtoR$ 208,103,9x

O que vale é o status efetivo: um anúncio pode estar ativo dentro de um conjunto pausado — e aí ele não roda. O painel mostra o estado real de entrega, não só a chave liga/desliga do próprio anúncio. Campanha duplicada nasce pausada, de propósito.

Funil e Origens

O Funil mostra quantas pessoas passaram por cada etapa, da visita à compra. A maior queda entre duas etapas seguidas é onde está o dinheiro parado.

Origens agrupa por UTM: campanha, mídia e origem, com visitantes, conversões e receita. É onde se vê qual tráfego paga a conta.

Eventos

A lista crua do que entrou, em tempo real, com o retorno da Meta para cada envio. É a primeira tela a abrir quando algo parece errado: se um evento falhou, o motivo dito pela Meta está ali, em vez de um “deu erro” genérico.

Auto Post

Programa até 30 dias de publicações na sua Página do Facebook de uma vez. Você escreve tudo num dia e não toca mais no assunto no mês. É um produto adicional, contratado à parte em Produtos, e depois de ativo aparece no menu lateral.

Página, não perfil. A Meta permite publicar por API em Página do Facebook e não em perfil pessoal — ela fechou esse caminho de propósito, e não existe volta por fora. Se a sua loja só tem perfil, é preciso criar uma Página antes.

Em Auto Post, clique em Buscar páginas. Usamos a mesma conexão com a Meta que já lê suas campanhas — não há segundo login.

Escolha a página, escreva o texto e marque a data. Aceita link ou imagem. Com imagem, a foto vira o post e o link não é anexado — é assim que o Facebook trata os dois formatos.

O post fica Agendado na fila. Enquanto não sair, dá para cancelar ou publicar na hora. Depois de publicado, aparece o link para ver na página.

A fila é nossa, não da Meta. Isso importa por um motivo prático: cancelar é imediato e nada sai sem o sistema mandar. Se a Meta recusar por limite de chamadas, tentamos de novo sozinhos; se recusar por permissão, o post é marcado como Falhou com a instrução do que fazer, em vez de sumir em silêncio.

O horário é o do seu computador, e o mínimo é 10 minutos à frente — o publicador roda de 2 em 2 minutos, e marcar “daqui a um minuto” só faria parecer que atrasou.

Agente de E-mail: como ligar

O Agente de E-mail responde seus clientes com os dados reais dos pedidos na Shopify. É um produto adicional: contrate em Produtos e ele aparece no menu lateral do painel. A configuração leva uns 10 minutos e tem cinco passos, todos na tela do agente.

Loja. Escolha a sua loja Shopify — a mesma já conectada na aba Loja, sem token novo — e o nome que assina as respostas, que é como o cliente vê o remetente.

Encaminhamento. A tela mostra o seu endereço exclusivo (sualoja@agente.zigtracker.com.br). Ative no e-mail de suporte que seus clientes já usam o encaminhamento automático para ele, mantendo uma cópia na sua caixa. Se o Gmail pedir código de confirmação, o código aparece na própria tela. O botão Enviar e-mail de teste confirma que está chegando.

Telegram (opcional, recomendado). Adicione @ZigSuporte_bot ao grupo da sua equipe, gere o código na tela e envie /parear CÓDIGO no grupo (ou abra o link direto para uma conversa privada). As trocas chegam no celular, com a foto e os botões Aprovar e Recusar. Sem Telegram, você recebe um e-mail na conta do painel e decide na própria tela do agente.

Regras. Prazo de troca e de cancelamento, se exige foto e motivo, e os três textos que o cliente recebe: caso em análise, aprovado e recusado.

Padrão das respostas. Tom, tratamento, tamanho, emojis, instruções e um e-mail modelo. A abertura (Olá, {nome}!) e a assinatura entram em toda resposta exatamente como você escreveu. Use Ver como fica para uma prévia antes de ligar.

Com tudo pronto, clique em Ligar agente. Dá para pausar a qualquer momento, e a lista de conversas mostra o que ele respondeu e o que está com você.

Travou em algum passo? Escreva para support@zigtracker.com.br que a gente te ajuda a configurar.

Agente de E-mail: como ele decide

O agente responde e-mail de cliente sozinho, mas nunca decide troca, devolução ou cancelamento por conta própria. Esses três viram um caso, e caso quem resolve é você, pelo Telegram.

O caminho de um e-mail

01Chega o e-mail. O agente lê, busca os pedidos daquele cliente na Shopify e classifica. Dúvida comum — onde está meu pedido, código de rastreio, status do pagamento — ele responde no seu padrão e pronto.
02Se for troca ou devolução, ele confere a foto e o motivo que as suas regras exigem. Faltando algo, pede ao cliente. Depois de três pedidos sem resposta, passa a conversa para você.
03Com tudo em mãos, o caso aparece em Casos para decidir, no painel, e no seu Telegram se estiver conectado — com as fotos, o pedido, o motivo e o aviso de fora do prazo. O cliente recebe a mensagem de "em análise".
04Você aprova ou recusa, no Telegram ou no painel. O cliente recebe o texto correspondente na hora, e fica registrado quem decidiu, onde e quando. A decisão vale nos dois lugares: decidiu no painel, o botão do Telegram some; um segundo clique não manda outro e-mail.

O agente passa a conversa para você, e para de responder, quando:

o cliente ameaça Procon, processo ou chargeback, ou está muito irritado;
a pergunta depende de algo que não está nos dados do pedido;
a resposta prometeria reembolso, estorno ou aprovação — isso só você decide;
a conversa passa de 8 respostas em 24 horas (proteção contra robô respondendo robô).

Nesses casos você recebe um aviso (no Telegram ou, sem ele, por e-mail) e responde pelo seu próprio e-mail, que continua recebendo tudo. Na lista de conversas, Devolver ao agente faz ele voltar a responder aquela conversa.

Fora do prazo não é recusado sozinho. O caso chega marcado como fora do prazo e a decisão continua sendo sua — às vezes vale abrir exceção para um bom cliente.

Mais de uma loja

Cada loja é uma conexão nova, mesmo que anuncie pela mesma conta de anúncios. São domínios diferentes, chaves diferentes e webhooks diferentes — e cada uma precisa do seu próprio script.

Cadastre a conta de anúncios em uma conexão só. O investimento do painel é a soma das contas cadastradas; a mesma conta em duas conexões contaria o gasto duas vezes e cortaria o ROAS pela metade. Quando duas lojas dividem a conta, deixe-a na principal e use o seletor de campanha para separar o que é de cada uma.

Dúvidas frequentes

Preciso desligar o app da Meta na Shopify?

Não. Ligue o modo "somente Purchase" em Configurações e os dois convivem sem contar a mesma venda duas vezes.

Fiz uma venda e ela não apareceu. O que houve?

Se o pagamento ainda está pendente, é o comportamento esperado — o evento sai quando a Shopify confirmar. Se já consta como pago, confira em Configurações se a chave secreta do webhook está preenchida.

Por que o investimento está zerado?

Ou a conta de anúncios não foi cadastrada, ou o token não tem acesso a ela. O cartão da conta, em Configurações, diz qual dos dois é.

Os números batem com o Gerenciador de Anúncios?

Sim, e é para isso que a coluna existe. Usamos os totais que a própria Meta calcula, no mesmo período e no mesmo fuso. Diferença grande em compras indica perda de rastreamento, não erro de conta.

Preciso de desenvolvedor?

Não. É uma linha no tema e um webhook, os dois copiados prontos do painel. Se você tiver um desenvolvedor, mande este link para ele.

Meus dados ficam guardados para sempre?

Não. IP e user agent são apagados em 30 dias, e o evento inteiro sai depois do prazo de retenção. Guardar dado pessoal além do necessário é justamente o que a LGPD chama de excesso.

Pronto para instalar?

A configuração completa leva cerca de 15 minutos, e a tela de Instalação confirma o primeiro evento em segundos.

Criar minha conta