Como conecto um checkout personalizado ao Decisa?

Se a sua loja ou plataforma de pagamento não tem conexão nativa com o Decisa, abra Site personalizado em Integrações: instale o pixel e faça o backend do seu checkout reportar cada pedido ao Decisa usando a sua chave (Site key) — o assistente de prompt com IA da página escreve esse código para você.

Antes de começar

• Um workspace com o módulo de Atribuição ativo.
• Acesso ao site onde seus compradores chegam (ou alguém — pessoa ou assistente de IA — que possa colar um trecho de código nele).
• Alguém que possa mexer no backend do seu checkout. A página gera um prompt pronto, então um assistente de IA de programação já resolve.
• O papel de Admin caso você precise ver a chave Site key — os demais membros veem um aviso pedindo para falar com um admin.

Passos

1. Abra Site personalizado

   Acesse Menu lateral → Integrações → Site personalizado. A página é um guia em duas etapas: Escolher pixels e Instalar e rastrear.

2. Escolha seus pixels

   Selecione um ou mais pixels — os destinos para os quais este site reporta. Todos os trechos de código e exemplos das etapas seguintes se atualizam conforme a sua seleção.

3. Use Automático para a integração completa

   Mantenha Automático (marcado como Recomendado), clique em Copiar prompt e cole no Claude, ChatGPT ou Cursor. O prompt aponta o assistente para o guia Markdown vivo de instalação da Decisa, inclui os pixels selecionados, API base e chave do servidor, e pede para instalar pixel.js, preservar o visitor id dcs_vid e enviar conversões/eventos reais do backend.

4. Use Manual quando quiser programar por conta própria

   Escolha Manual para ver a URL do guia técnico, snippets de browser, sua Site key, exemplos de conversão e a referência de sinais em /events. Trate a Site key como senha; ela fica apenas no servidor e acompanha toda requisição de conversão/evento que seu backend enviar.

5. Confirme que os eventos estão chegando

   No cartão Live events, clique em Send test event. O status muda para Receiving events e o teste aparece na lista logo abaixo em segundos.

O que acontece depois

• Cada pedido reportado pelo seu checkout aparece na sua lista de conversões, ligado ao clique e à campanha que o gerou.
• O cartão Live events continua mostrando os últimos cinco cliques capturados pelo seu pixel, com atualização automática.
• Seu relatório de ROAS passa a creditar a receita real às campanhas.
• O guia técnico em produção fica em https://api.decisa.ai/v1/docs/attribution-installation.md e é a fonte da verdade para /conversions, /events, /identify, continuidade do visitante e campos de qualidade do evento.

Armadilhas