Rastreamento server-side para qualquer site
Adicione uma tag de script ao seu site e envie os pedidos pagos como JSON a partir do seu backend ou de uma ferramenta no-code. O ROASaurus associa cada pedido ao clique no anúncio e o encaminha às suas plataformas de anúncios.
| O site personalizado em resumo | |
|---|---|
| Script | Uma tag de script em todas as páginas: visualizações de página, IDs de clique, o cookie de visitante _tl |
| Orders API | POST /api/v1/orders com uma chave da loja e uma chave de API |
| Webhook JSON | POST para a URL do seu webhook a partir do seu backend, do Zapier, do Make ou do n8n |
| Eventos offline | POST /api/v1/events para leads, demos e recobranças |
| Correspondência de pedidos | visitor_id (o cookie _tl), evento de agradecimento, um e-mail informado antes pelo visitante, ou IP e navegador |
1. Adicione o script
Cole em todas as páginas a tag de script da sua página Tracking & platforms, normalmente em "código personalizado", "injeção de código" ou "scripts de cabeçalho". Ela registra as visualizações de página, captura os IDs de clique de anúncios e as UTMs e cria o cookie de visitante _tl. Envie outros eventos com tlq('track', 'AddToCart', {...}).
2. Envie os pedidos pagos
Orders API. Crie uma chave de API em Settings › Orders API e envie cada pedido pago com POST para /api/v1/orders. O formato da requisição aparece nessa página. Passe o cookie _tl como visitor_id para que o pedido seja associado ao clique no anúncio.
Webhook JSON. Escolha "Other / custom webhook" ao adicionar a loja e envie os pedidos com POST para a URL do seu webhook. Campos: order_id, total, currency, email, phone, first_name, last_name, country, zip, client_ip, user_agent, items (variant_id, quantity, price) e, se puder, visitor_id. Você também pode passar click_ids, landing_url e is_first_order e marcar pedidos de teste com "test": true para que sejam guardados, mas não enviados.
3. Dispare o evento de agradecimento
Na página de confirmação, dispare tlq('track', 'Purchase', ...) com event_id definido como order- mais o ID do seu pedido. Isso liga o pedido ao visitante mesmo quando você não consegue passar o cookie. Depois que o seu servidor passa a enviar pedidos, as compras do navegador apenas ligam visitantes; elas deixam de criar pedidos.
Leads e assinaturas
A API de eventos offline (POST /api/v1/events) recebe leads, demos, MQLs e recobranças de assinaturas, associados a um visitante pelo e-mail com hash. Ela aceita até 1.000 eventos por minuto por loja, de 3 KB cada.
Funis e cookies first-party
Liste os domínios do seu funil e da sua loja em Settings › Linked domains, e os links entre eles levam o ID do visitante e os IDs de clique. Servir o script a partir do seu próprio subdomínio (um CNAME) mantém a coleta no seu domínio e reemite o _tl como um cookie HTTP. O Safari ainda pode limitar esse cookie a 7 dias.
Relacionados
Perguntas respondidas
Preciso de um desenvolvedor?
Nem sempre. O Zapier, o Make ou o n8n podem enviar os pedidos pagos da sua loja ou da sua ferramenta de pagamento para a URL de webhook do ROASaurus. Passar o ID do visitante a partir do cookie _tl normalmente exige uma pequena alteração no seu site.
Como envio pedidos de teste?
Adicione "test": true ao pedido. O ROASaurus o guarda para que você confira o formato, mas não envia nada às plataformas de anúncios.
E se o meu site não tiver backend nenhum?
Dispare a compra do navegador na página de confirmação. Quando uma loja não tem uma fonte de pedidos server-side, esse evento cria o pedido e ele é encaminhado às plataformas de anúncios. Uma fonte no servidor é mais confiável.
Cada venda, rastreada até o anúncio que a gerou
Rastreamento server-side, lucro e valor vitalício em um só app. 14 dias de teste grátis, sem cartão de crédito.
Comece seu teste grátis →