Conceitos principais

Conceitos principais

O Apointo faz quatro coisas. Entender cada uma evita quase todo problema de configuração.

Captura

Atribuição nasce no primeiro toque. O Capture (WordPress) ou os helpers do SDK guardam gclid, gbraid, wbraid, fbclid e UTMs junto ao lead, com primeiro e último toque distintos (ft_channel / lt_channel). Sem captura não existe conversão offline: só existe um clique e uma venda que ninguém consegue ligar.

Identidade

Um evento precisa cruzar com o clique. A correspondência usa telefone, e-mail ou identificador externo do seu sistema. O payload carrega o mínimo necessário para casar registro com clique; histórico de conversa, notas internas e detalhe clínico não entram.

Eventos canônicos

Todo sistema de origem vira o mesmo vocabulário:

Evento	Significado
lead_captured	Primeiro contato atribuído
quote_requested	Pedido de orçamento
qualified_lead	Lead qualificado pelo seu critério
booking_confirmed	Reserva confirmada
appointment_completed	Comparecimento concluído
sale_paid	Venda paga
subscription_active	Assinatura ativa/renovada
refund_retraction	Reembolso que retira a conversão
client_acquired	Cliente adquirido

Uma reserva marcada não é um comparecimento. Você escolhe qual evento alimenta a otimização de cada plataforma.

Livro-razão de entrega

Cada evento guarda: tentativas de entrega, código de resposta, recibo do destino, agenda de retries e correlação. "Conectado" não é prova; o recibo é.

Consentimento

Eventos sem evidência de consentimento para dados de anúncio ficam retidos. UTMs e contexto de jornada permanecem disponíveis; identificadores de anúncio são removidos antes da entrega.