Integração com loja online

Tracking server-side para qualquer site

Adicione uma tag de script ao seu site e envie as encomendas pagas em JSON a partir do seu backend ou de uma ferramenta sem código. A ROASaurus associa cada encomenda ao respetivo clique no anúncio e reencaminha-a para as suas plataformas de anúncios.

Site personalizado em resumo
ScriptUma tag de script em todas as páginas: visualizações de página, IDs de clique, o cookie de visitante _tl
Orders APIPOST /api/v1/orders com uma chave da loja e uma chave de API
Webhook JSONPOST para o URL do seu webhook a partir do seu backend, do Zapier, do Make ou do n8n
Eventos offlinePOST /api/v1/events para leads, demonstrações e renovações
Associação de encomendasvisitor_id (o cookie _tl), evento da página de agradecimento, um email que o visitante indicou antes, ou IP e navegador

1. Adicione o script

Cole a tag de script da sua página Tracking & platforms em todas as páginas, normalmente em “custom code”, “code injection” ou “header scripts”. Regista visualizações de página, capta IDs de clique dos anúncios e UTMs, e define o cookie de visitante _tl. Envie outros eventos com tlq('track', 'AddToCart', {...}).

2. Envie as encomendas pagas

API de encomendas. Crie uma chave de API em Settings › Orders API e envie com POST cada encomenda paga para /api/v1/orders. O formato do pedido é mostrado nessa página. Passe o cookie _tl como visitor_id para que a encomenda seja associada ao clique no anúncio.

Webhook JSON. Escolha “Other / custom webhook” ao adicionar a loja e envie as encomendas com POST para o 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. Pode também passar click_ids, landing_url e is_first_order, e marcar as encomendas de teste com "test": true para que sejam guardadas mas não enviadas.

3. Dispare o evento da página de agradecimento

Na página de confirmação, dispare tlq('track', 'Purchase', ...) com event_id definido como order- mais o ID da sua encomenda. Isso associa a encomenda ao visitante mesmo quando não consegue passar o cookie. Depois de o seu servidor enviar as encomendas, as compras do navegador apenas associam visitantes; já não criam encomendas.

Leads e subscrições

A API de eventos offline (POST /api/v1/events) aceita leads, demonstrações, MQLs e renovações de subscrições, associados a um visitante por email com hash. Aceita até 1000 eventos por minuto por loja, 3 KB cada.

Funis e cookies first-party

Indique os domínios do seu funil e da sua loja em Settings › Linked domains, e as ligações entre eles transportam 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 recolha no seu domínio e volta a emitir o _tl como cookie HTTP. O Safari pode, ainda assim, limitar esse cookie a 7 dias.

Relacionado

FAQ

Perguntas e respostas

Preciso de um programador?

Nem sempre. O Zapier, o Make ou o n8n podem enviar as encomendas pagas da sua loja ou ferramenta de pagamento para o URL do webhook da ROASaurus. Passar o ID do visitante a partir do cookie _tl normalmente exige uma pequena alteração no seu site.

Como envio encomendas de teste?

Adicione "test": true à encomenda. A ROASaurus guarda-a para que possa verificar o formato, mas não envia nada para as plataformas de anúncios.

E se o meu site não tiver qualquer backend?

Dispare a compra do navegador na página de confirmação. Quando uma loja não tem uma origem de encomendas server-side, esse evento cria a encomenda e é reencaminhado para as plataformas de anúncios. Uma origem no servidor é mais fiável.

Cada venda, associada ao anúncio que a gerou

Tracking server-side, lucro e valor vitalício do cliente numa só app. Teste gratuito de 14 dias, sem cartão de crédito.

Comece o seu teste gratuito →