JR&AD INTELIGENCIA DIGITAL LTDA | 68.349.320/0001-95
Documentos atualizados
Para continuar, leia e aceite as versões atuais.
Evento
Guia
⌕
Início
Ambientes da sua conta
Cada operação reúne um produto ou conjunto de dados Meta com seus próprios pedidos, clientes, campanhas e relatórios. A conta e o login continuam os mesmos.
Conheça a Rottads
Suas vendas conectadas às suas campanhas
Carregando recursos…
Sua página
Sua página tem um link próprio que identifica campanha, conjunto e anúncio antes do destino final. Editar a página depois não muda o link que já está no anúncio.
Como colocar no anúncio da Meta (importante)Veja como usar o link no anúncio para identificar a origem das visitas.
Na criação do anúncio, em Destino, escolha Site e cole o link da landing no campo URL. O visitante vê a página, toca no botão e segue para o destino configurado. A campanha, o conjunto, o anúncio e o fbclid ficam registrados no caminho.
Você pode editar a landing depois sem alterar o link que já está no anúncio.
Nova página
Escolha um modelo, personalize sua marca e defina o destino. Sua operação terá um link próprio para levar o visitante ao WhatsApp ou ao checkout.
Rastreamento da campanha
Relacione as vendas à origem, campanha, conjunto e anúncio quando os sinais necessários estiverem disponíveis e o tratamento estiver habilitado.
Como você vende?
Landing rastreada para WhatsApp
Sua página agora fica em Landing page.
Criar e editar páginas mudou de lugar — ganhou menu próprio, com a lista de todas as suas landings. O rastreamento continua igual: cada página tem link individual que identifica campanha, conjunto e anúncio.
Rastreamento para página / checkout
Dois jeitos — use um ou os dois. O bloco pronto para copiar (com o seu domínio e a chave da conta) está na Documentação.
Seus sites e sistemas
Cada site, checkout ou sistema seu vira uma fonte, com chave própria. Assim dá para ligar um destino de cada vez e saber de qual lugar veio cada evento.
Adicionar uma fonte
Guarde esta chave agora
Ela serve para o seu servidor enviar vendas confirmadas. Esta é a única vez que ela aparece — depois disso nem esta tela consegue mostrá-la de novo. Se perder, dá para gerar outra, e a anterior deixa de valer na hora.
Tudo bem — os pedidos continuam entrando pelo webhook e virando Purchase na Meta com telefone, endereço e valor. Você só não vai saber de qual anúncio cada venda veio, e a nota de correspondência fica menor (sem o clique). Dá para mudar de ideia quando quiser.
Primeiros passos
Nenhum pedido ainda. Três coisas colocam o rastreio no ar em menos de 15 minutos.
Gasto do Meta Ads cruzado com a sua receita, campanha →
conjunto → anúncio. O elo é a UTM: use NOME|{{campaign.id}}
nos parâmetros do anúncio para casar exato, ou o nome puro que casa por
igualdade. Receita = entregue — aprovado fica na coluna
Esteira e não infla o ROAS.
0 selecionados
Contas de anúncio
Conectar outra conta de anúncioa Meta é uma conta só — o token da Meta / CAPI já serve
A Meta é uma conta só: o token que você já conectou em Meta / CAPI também lê as campanhas. Clique em buscar — só pedimos um token novo se esse não tiver permissão para anúncios.
Piloto automático
Ao conectar uma conta, o CRM atualiza os gastos a cada 30 minutos e monitora campanhas com ROAS abaixo de 1 após R$ 100 investidos em 7 dias. Primeiro ele só observa; pausas reais exigem sua confirmação e a permissão ads_management.
Regras próprias de automaçãolimites e horários além do piloto automático
Regras em simulação apenas registram o que fariam — nunca alteram a Meta. Tire a simulação só quando confiar no resultado.
Arraste o pedido entre as colunas para mudar a etapa. A mudança passa pelo
mesmo caminho de um webhook — mover para Entregue dispara
o evento na Meta de verdade.
Para vendas fechadas fora da plataforma. A Rottads identifica o pedido para controlar reenvios no seu próprio fluxo.
A deduplicação com o Pixel de um site ou checkout depende da coordenação dos identificadores dessa integração;
não é garantida apenas pelo lançamento aqui.
Você escolhe quem pode ver e administrar suas campanhas. O produtor enxerga
a mídia — campanhas, gasto, ROAS, número de vendas. Seus
clientes e sua conexão com a Meta continuam
só suas: nem os dados dos compradores nem o seu token são compartilhados.
Quer o caminho contrário — acessar campanhas de afiliados?
Está em Sou produtor.
Dar acesso a um produtor
Recebeu o link do produtor? Abra-o logado nesta conta — o convite aparece
aqui pronto para aceitar. Ou cole o código dele (algo como P-ABCD2345):
Quem tem acesso hoje
O que andaram fazendo
Toda alteração feita por um produtor na sua conta fica registrada aqui.
Se você vende com afiliados, gere seu link de convite e mande para
eles. Quem abrir o link aceita com um clique — e só então as campanhas dele aparecem
em Campanhas de afiliados. Você vê a mídia e os números; os clientes
e a conexão com a Meta continuam sendo de cada afiliado.
Meu link de convite
Afiliados que aceitaram
Quem aceitou o convite, e o que cada um liberou.
O que eu fiz nas contas deles
Toda alteração que você faz em uma conta de afiliado fica
registrada — para você e para ele.
Os afiliados que te autorizaram. Você vê a mídia e os números agregados —
gasto, ROAS, quantas vendas. Quem comprou é dado do afiliado e não aparece aqui.
O que mudou no Trackeamento ADS: funções novas, correções e avisos.
As mais recentes primeiro.
A planilha entra pelo mesmo caminho dos webhooks.
Isso significa que uma venda que já chegou pela integração não é
contada de novo, e um pedido que está esperando a sua decisão continua
esperando. Como montar a planilha
1. Escolha o arquivo e a operação
2. Diga o que é cada coluna
3. Confira o que vai acontecer
Nada foi criado ainda. Esta conferência não gera pedido,
não envia conversão e não altera nenhuma venda.
4. Andamento
Importações anteriores
Cole a URL no painel da plataforma (Logzz → Integrações → Webhook; Coinzz →
Integrações → Webhooks; PaguePay → notificações; Braip → Ferramentas → Postback). Plataforma nova: crie com
Detectar automaticamente, dispare um teste e mapeie os campos
na aba Payloads.
API / Postback — os dois contratos
carregando…
Todo webhook é gravado cru antes de ser interpretado. Se um
campo veio errado, corrija o mapeamento e clique em Reprocessar —
nada precisa ser reenviado pela plataforma.
Selecione um payload à esquerda.
Qualidade dos dados enviados
Como rastrear o seu jeito de vender
Vender no WhatsApp, por uma landing daqui ou no seu
próprio site exige coisas diferentes. Escolha o seu caminho: cada
um leva à configuração que ele realmente precisa, e só a ela.
Política de envio — dados autorizados
Define quais dados desta conta podem ser enviados à Meta e qual valor acompanha cada compra. Alterar aqui muda o que sai nos próximos eventos.
Use esta área apenas para testes, suporte técnico ou investigação de eventos.
Fila de eventos
Últimas chamadas à Meta
Tutorial guiado — conectar a API de Conversões
Seis passos, uns 10 minutos. Cada passo marca ✓ sozinho quando o Trackeamento ADS detecta que foi feito.
0 de 6
Consultando GA4…
Auditoria técnica, não parecer jurídico. A base legal do compartilhamento
publicitário e a política de privacidade precisam de advogado —
docs/LGPD.md lista o que levar para ele.
Documentos públicos: Termos de Uso · Política de Privacidade. O titular pode pedir acesso, correção, portabilidade, oposição ou eliminação pelo canal de privacidade publicado.
Retenção de dados
Minha conta
Ao cancelar, o acesso da sua equipe e os novos webhooks param na hora. Os dados remanescentes seguem os prazos da Política de Privacidade; para uma solicitação específica de eliminação, use o canal de privacidade publicado.
Cada conta tem os próprios dados — leads, pedidos, integrações, Meta. Quem se cadastra
na tela de entrada cria uma conta nova; quem você convida aqui entra na
sua conta, já ativo. Só administradores convidam, desativam e mudam papel.
Desativar derruba a sessão da pessoa na hora.
Dados jurídicos da plataforma. Eles aparecem nos Termos, na Política de Privacidade e no cadastro. Só o dono da plataforma pode alterar. Este é um modelo operacional e deve ser revisado pelo seu advogado antes de abrir cadastros públicos.
Guias e atalhos da plataforma
Explore os temas e acesse a página correspondente. Os cartões indicam quando um vídeo ainda não está disponível.
Vídeo em breve
1
Primeiros passos
O tour completo: o que o CRM faz, como os pedidos entram e o que aparece em Operação.
Prefere ler?A documentação tem o passo a passo escrito,
com os detalhes de cada plataforma.
Ficou com dúvida?Chame a gente no WhatsApp — respondemos em horário comercial.
Como funciona a contratação
Sem cobrança automática: você só paga quando escolher um plano.
O Tracking Basic e o Tracking Pro você
contrata aqui mesmo, pagando por Pix, boleto ou cartão.
A cobrança é mensal e não é automática: a cada mês você recebe
uma nova para pagar.
O plano só é liberado depois que a confirmação do pagamento chega ao
nosso servidor — voltar da página de pagamento não basta.
Começando
Conecte as plataformas. Em Integrações,
copie a URL de cada webhook e cole no painel da plataforma:
Logzz → Integrações → Webhook · Coinzz → Integrações → Webhooks ·
Hyppe / PaguePay → notificações. Plataforma que não está na lista:
crie uma integração com adaptador Detectar automaticamente.
Dispare um pedido de teste na plataforma. Ele aparece em
Payloads com o corpo cru
gravado. Se algum campo veio errado, clique no payload, confira o mapeamento
sugerido, salve e use Reprocessar — sem pedir reenvio a ninguém.
Ligue a Meta. No Gerenciador de Eventos → seu dataset →
Configurações → gere o token. Preencha META_DATASET_ID e
META_ACCESS_TOKEN no .env, reinicie
(pm2 restart crm-track) e valide em
Meta / CAPI.
Comece com META_TEST_EVENT_CODE preenchido, confira em
"Testar eventos" no Gerenciador, e apague o código depois —
enquanto ele existir, nada entra em otimização.
Capture o clique do anúncio (é o que mais sobe a nota da Meta):
sem isso o fbclid morre no primeiro redirecionamento e o pedido que
chega por webhook não tem como ser ligado ao anúncio (fica sem fbc).
Dois jeitos, use um ou os dois:
Quando o cliente informar o telefone na sua página, chame
crmTrackIdentify('5531999998888') para casar o clique com o pedido.
Decisões que valem dinheiro (já configuradas)
META_PURCHASE_ON=delivered
No COD, pedido aprovado não é dinheiro — o cliente ainda pode recusar na
porta. O Purchase da Meta só
disparam na entrega confirmada. Otimizar pelo "aprovado" ensina o algoritmo a
trazer quem aceita e não paga. Se a sua operação for de pagamento antecipado
(PIX/cartão), troque a regra da Meta para paid.
Identidade pelo telefone (últimos 8 dígitos)
A mesma pessoa chega da Logzz com 55, da Coinzz sem 55 e do formulário com o
9º dígito. O casamento é pelos últimos 8 — nunca por igualdade. CPF é a segunda
chave, e-mail a terceira.
event_id determinístico
integração.pedido.status — webhook reenviado nunca conta em dobro,
e o mesmo id casa com o eventID do Pixel do site (é assim que a Meta
deduplica navegador × servidor).
Status nunca regride
Webhook chega fora de ordem o tempo todo. Se "pago" chegar depois de
"entregue", o pedido continua entregue. Só cancelamento/estorno/chargeback
vencem um estado mais avançado, porque são fato posterior.
CPF nunca vai para a Meta
Ele existe só para casar a mesma pessoa entre plataformas (minimização,
LGPD Art. 6º III). O que sai é hasheado em SHA256 no padrão exato da Meta.
Rotina do dia a dia
Operação — os números do período: taxa de entrega é a métrica
que decide se a operação COD dá lucro (entregue ÷ aprovado).
Funil — arraste o pedido entre etapas; mover para Entregue
dispara o evento de verdade, igual a um webhook.
Lançar venda — venda que fechou no WhatsApp/telefone não tem
webhook; sem lançar, ela nunca chega na Meta. Use Ver o que vai para a
Meta antes: mostra o evento exato, os campos hasheados e a força do sinal.
Clientes — a gaveta tem o botão Abrir no WhatsApp,
a linha do tempo e as anotações. Os botões de LGPD (exportar, parar de
trackear, eliminar) estão lá também.
Tarefas — "ligar para confirmar a entrega de sábado" com
prazo; atraso fica vermelho no menu.
Quando algo parecer errado
O pedido não apareceu
Olhe Payloads primeiro.
Se o cru está lá com erro, o problema é interpretação (corrija o mapeamento e
reprocesse). Se nem o cru chegou, o problema é a URL colada na plataforma.
Evento não chegou na Meta
Meta / CAPI → fila. Estado
pending = aguardando envio (ou META_ENABLED=false).
failed mostra o motivo devolvido pela Meta e o fbtrace_id —
guarde esse número se abrir chamado com eles.
Conversão duplicada no Gerenciador
Confira se o Pixel do site envia eventID igual ao
event_id daqui (formato integração.pedido.status).
Servidor
pm2 logs crm-track · pm2 restart crm-track ·
banco em data/crm.db (faça backup criptografado — tem CPF).
Referências completas
docs/META-ADS.md — a documentação da Meta compilada: endpoint,
17 eventos padrão, hashing campo a campo, dedupe, webhooks, Lead Ads, limites.
docs/API.md — todas as rotas deste servidor, com exemplos.
docs/LGPD.md — a auditoria de conformidade e o que ainda depende
de você (base legal, política de privacidade, DPO).
README.md — visão geral, instalação e produção.
Compartilhar campanha
O destinatário recebe apenas métricas agregadas: investimento, receita, ROAS, pedidos e entregas. Nenhum cliente, pedido individual, token ou conta de anúncio é exibido.