Trakvo no ar
em 10 minutos.
Tracker server-side completo. Cada conversão chega na Meta CAPI, TikTok Events e Google Ads — sem perder por iOS, AdBlock ou cookies.
Criar projeto
Um projeto isola tracking de um site, loja ou funil. Cada projeto tem seu próprio domínio, pixels e API keys.
- Abra Projetos
- Clique em + Novo projeto
- Siga o stepper de 4 etapas
-
Identificação Nome do projeto e domínio principal onde o tracking será instalado.
-
Fonte de tráfego Meta Ads, TikTok Ads, Google Ads, orgânico — seleção múltipla.
-
Moeda BRL, USD, EUR ou qualquer ISO 4217 — 41 opções disponíveis.
-
Confirmar Revise os dados e finalize a criação.
prj-xxxxxxx) é gerado automaticamente — não é visível no funil pra não vazar.Verificar domínio
Antes de qualquer coisa. Sem domínio verificado, eventos são rejeitados e a API key não funciona — proteção contra uso indevido.
- Ao entrar no projeto, vai cair direto na tela de verificação com hero card
- Expanda o accordion "Verificação DNS TXT" pra ver as instruções
- Crie um registro DNS no seu provedor (Cloudflare, GoDaddy, Registro.br, etc):
- Tipo
- TXT
- Nome / Host
- _trakvo-verify.<seu-dominio>
- Valor
- <token gerado pelo painel>
- TTL
- 300 (5 min) — opcional
Volte ao painel e clique em Verificar agora. Aguarde a propagação DNS (geralmente 1-5 min, pode levar até 24h).
Ativar LIVE
Toda criação começa em TEST mode (eventos chegam mas NÃO são despachados pros canais reais). Ativar LIVE habilita o dispatch pra Meta, TikTok, Google, etc.
- Com domínio verificado, aparece o botão branco "Ativar LIVE" no hero card
- Clique pra disparar a ativação — animação leva ~1.4s
- Sucesso: chip "Em produção" verde com dot pulsante substitui o botão
mas não vão pros canais.
Útil pra desenvolvimento.
pros pixels conectados
em tempo real.
Pra pausar temporariamente (voltar pra TEST), use o botão "Pausar" dentro do chip "Em produção".
Conectar pixels
Pra onde os eventos vão ser despachados. Cada pixel é uma integração técnica (Meta CAPI, TikTok Events API, GA4).
(Events Manager)
(Events API)
(Data Streams)
Dois caminhos pra criar:
- Pelo projeto: dentro do project detail, na seção "Pixels deste projeto", clique + Conectar pixel
- Pelo catálogo global: Pixels → Novo pixel, escolha a loja e plataforma
Pegar a API key
Cada projeto tem uma key única que autentica os requests do snippet/checkout. Copie agora — não verá de novo.
- Abra o projeto (já verificado)
- No header, clique + Nova API key
- Defina um label (ex: "snippet web", "checkout staging")
- Copie e guarde em local seguro — formato
tk_xxxxxxxx
Instalar o snippet
Cole no <head> do seu site. Captura PageView, fbc/fbp, ttclid e UTMs automaticamente.
<script src="https://cdn.trakvo.co/v1/t.js" data-trakvo-key="SUA_KEY" async></script>Webhook do gateway
Captura Purchase com precisão total via S2S — Mangofy, PerfectPay, Pagar.me, Stripe e mais. Funciona mesmo se o cliente fechar a aba antes do thank-you.
- Em Integrações, adicione o gateway
- Copie a URL única gerada (com token assinado HMAC)
- Cole no campo Webhook ou Postback do gateway
https://api.trakvo.co/webhooks/{gateway}/{token}Eventos customizados
Dispare no momento certo do funil. PageView é automático, mas eventos de conversão (ViewContent, Lead, InitiateCheckout) você decide quando.
// Ao visualizar produto
trakvo('track', 'ViewContent', { value: 97, currency: 'BRL' });
// Ao iniciar checkout
trakvo('track', 'InitiateCheckout', { value: 97, currency: 'BRL' });
// Ao capturar lead (email/phone hasheados server-side)
trakvo('track', 'Lead', {
email: '[email protected]',
phone: '+5511999999999'
});Eventos suportados: PageView · ViewContent · AddToCart · InitiateCheckout · AddPaymentInfo · Purchase · Lead · SubmitForm · CompletePayment
Auto-track via HTML NOVO v13.4
Zero JavaScript na landing — marque um data-trakvo-event no botão/link/form e o script dispara sozinho no clique.
<!-- Botão "Adicionar ao carrinho" -->
<button
data-trakvo-event="AddToCart"
data-trakvo-content-ids="SKU-123"
data-trakvo-content-name="Tênis Nike Run"
data-trakvo-value="299.90"
data-trakvo-currency="BRL">Adicionar ao carrinho</button>
<!-- Link "Ver produto" -->
<a href="/produto/sku-123"
data-trakvo-event="ViewContent"
data-trakvo-content-ids="SKU-123">Ver detalhes</a>
<!-- Form de busca → dispara Search no submit -->
<form data-trakvo-event="Search">
<input type="search" name="q">
<button>Buscar</button>
</form>Atributos disponíveis
| Atributo | Vira | Exemplo |
|---|---|---|
data-trakvo-event * | eventName | AddToCart |
data-trakvo-value | value (Number) | 99.90 |
data-trakvo-currency | currency | BRL |
data-trakvo-content-ids | content_ids (vírgula → array) | SKU-1,SKU-2 |
data-trakvo-content-name | content_name | Tênis Nike |
data-trakvo-content-type | content_type | product |
data-trakvo-content-category | content_category | tenis |
data-trakvo-num-items | num_items (Number) | 3 |
data-trakvo-search-string | search_string | tenis nike |
data-trakvo-order-id | externalId | ord_abc123 |
data-trakvo-* (outros) | customData[*] | data-trakvo-tier="vip" |
data-trakvo-skip em qualquer elemento ancestral pra ignorar o disparo nesse subtree. Útil pra preview / admin.trakvo('track', ...) pros que dependem de lógica (Purchase no callback do gateway, Lead após validação de form, etc).Testar
Verifique se está rodando.
Abra seu site, pressione F12 → Console, e rode:
trakvo('track', 'Lead', { email: '[email protected]' });Veja chegar em Eventos em até 5s com status COMPLETED.