Como instalo o pixel do Decisa no meu site?

Crie um pixel em Pixels, depois abra Custom Site (site personalizado) em Integrações e cole o snippet de uma linha no seu site — sua primeira visita aparece como clique em poucos segundos.

Um pixel é o destino para o qual seu site reporta (Meta, TikTok ou Google). O snippet é uma única tag <script> que carrega em todas as páginas, define um cookie first-party e registra cada pageview como um clique — o fio que depois liga os pedidos de volta aos seus anúncios.

Antes de começar

• Acesso a um workspace. Instalar o pixel é uma das ações que ativa o módulo de Atribuição.
• Da sua plataforma de anúncios: a credencial do pixel e o token da API de Conversões (você pode adicionar ou rotacionar o token depois). A credencial varia por plataforma — um Pixel ID para Meta, um Pixel code para TikTok ou um ID de cliente do Google Ads para Google.
• Uma forma de alterar seu site — o HTML, seu tema do Shopify, o Google Tag Manager — ou um assistente de código com IA, como Claude ou ChatGPT, para fazer isso por você.

Passos

1. Crie um pixel

   Use Menu lateral → Atribuição → Pixels e adicione um pixel: escolha a plataforma (Meta, TikTok ou Google), dê um nome fácil de reconhecer e cole as credenciais e o token da API de Conversões da plataforma. A Meta pede um Pixel ID e o TikTok um Pixel code; o Google identifica pelo ID de cliente, então o formulário adiciona um campo Customer ID (o ID de cliente do Google Ads) e deixa o identificador externo opcional. Um workspace pode ter vários pixels — um por site ou por plataforma.

2. Abra Custom Site (site personalizado) e escolha seus pixels

   Use Menu lateral → Integrações → Custom Site (site personalizado — o cartão e o título da página aparecem em inglês). O primeiro passo do assistente lista seus pixels ativos — selecione aqueles para os quais este site deve reportar. O snippet de instalação se atualiza conforme a sua seleção.

3. Instale o snippet

   Escolha um caminho. A opção automática entrega um prompt que manda Claude, ChatGPT ou Cursor ler primeiro o guia Markdown vivo de instalação da Decisa, depois instalar o pixel e configurar conversões/eventos server-side com os pixels selecionados e a chave do servidor. A opção manual mostra a mesma URL do guia técnico e snippets prontos nas abas HTML, Next.js, Shopify e GTM; cole o snippet antes da tag de fechamento </head> em todas as páginas que você quer rastrear.

4. Verifique a instalação

   Abra seu site em um navegador e depois confira Menu lateral → Atribuição → Cliques — sua visita aparece em poucos segundos, e o assistente marca o passo de instalação como concluído. O passo final do assistente também oferece uma opção servidor-a-servidor com um painel Live events (eventos ao vivo) que muda de Waiting (aguardando) para Receiving events (recebendo eventos) e lista os últimos cinco cliques; Send test event (enviar evento de teste) entrega um clique e uma conversão de teste na hora.

O que acontece depois

• Cada visita ao seu site é registrada em Cliques, com a origem, a mídia e a campanha do UTM.
• Compras e cadastros que você rastrear depois aparecem em Conversões, vinculados ao clique que trouxe o visitante.
• A opção servidor-a-servidor também revela sua Site key (chave do site) — o segredo que o seu backend usa para enviar conversões direto para o Decisa. Mantenha-a no servidor, nunca no código da página; só administradores do workspace podem visualizá-la.
• A URL do guia manual em produção é https://api.decisa.ai/v1/docs/attribution-installation.md. Ele cobre pixel.js, /identify, /events, /conversions, continuidade do visitante, sinais de qualidade, CSP e decoração segura de links.

Armadilhas