DecisaDocumentação

Docs · Primeiros passos

Do zero à primeira conversão atribuída.

Reserve dez minutos. Se travar, a cadeia tem exatamente três elos que podem quebrar e mostraremos como depurar cada um deles.

01

Crie um workspace

Cadastre-se em decisa.ai/register. O primeiro workspace fica no plano gratuito — 100 pedidos rastreados por mês, para sempre.

Uma vez dentro, copie o seu ID do workspace da URL (/workspaces/<slug>) e a sua site key em Configurações → Chaves da API. Mantenha a site key fora do código do lado do cliente.

02

Adicione o pixel ao seu site

Adicione uma única linha ao <head> de cada página que você quer rastrear:

<script src="https://api.decisa.ai/pixel.js"
        data-workspace="WORKSPACE_ID" async></script>

O pixel define um cookie first-party dcs_vid, captura os parâmetros UTM e encaminha gclid, fbclid e ttclid para /collect. Sem cookies de terceiros. Sem fingerprinting.

03

Envie sua primeira conversão

A partir do seu back-end — no cadastro, no início do teste, na assinatura ou na compra — faça um POST para /v1/conversions. Abaixo está o formato canônico em curl; snippets idiomáticos em Node, Python, PHP e Ruby estão na referência da API.

curl -X POST https://api.decisa.ai/v1/conversions \
  -H "Authorization: Bearer YOUR_SITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "signup",
    "external_id": "user-1234",
    "visitor_id": "VALUE_OF_dcs_vid_COOKIE",
    "customer_email": "[email protected]"
  }'

external_id é o que o seu sistema já usa para identificar o registro. O Decisa faz deduplicação por (workspace_id, external_id), então repetições seguras saem de graça.

04

Verifique a cadeia

Abra a página Instalação no seu workspace e clique em Enviar evento de teste. Você deve ver o clique e a conversão aparecerem no feed de atividade ao vivo em cerca de 2 segundos. Se o clique nunca aparecer, o pixel não carregou ou o seu CSP está bloqueando api.decisa.ai. Se o clique aparecer mas a conversão não se juntar a ele, o seu visitor_id não corresponde ao valor do cookie — verifique se você está lendo req.cookies.dcs_vid, e não um derivado limitado à sessão.

05

Olhe o painel de ROAS na manhã seguinte

Assim que o seu tráfego real passar pelo pixel, a página de ROAS agrupa a receita atribuída por origem, campanha, mídia e conteúdo. Alterne entre modelos de atribuição na barra de filtros — os resultados anteriores continuam consultáveis, então seus relatórios históricos não mudam silenciosamente.

A seguir