Atribuição multi-touch de leads

O Codewo registra cada interação do contato com seus canais — cada uma vira um touchpoint com origem marcada (anúncio Meta, Google, link direto, etc.). Use o relatório de atribuição pra saber de onde vêm seus leads e quais canais convertem.

O que é multi-touch

Atribuição single-touch diz "o lead veio do Google Ads". Atribuição multi-touch diz "o lead veio do Google Ads na primeira vez, voltou via Instagram orgânico depois, e converteu via WhatsApp na terceira visita".

A diferença importa: muitos leads tocam várias vezes em vários canais antes de fechar. Atribuição single-touch te faz subestimar canais de "início de jornada" e superestimar os de "fechamento".

O Codewo guarda todos os toques.

Como funciona

Cada contato tem uma lista de touchpoints na tabela contact_touchpoints. Cada touchpoint tem:

• Source normalizado — meta_ads, google_ads, meta_organic, google_organic, direct, manual, imported, etc.
• Campaign (quando disponível) — Nome da campanha do anúncio.
• Channel — Por qual canal (WebChat, WhatsApp Cloud, Telegram, Email, etc.).
• Data e hora.

Como o Codewo captura

Cada canal tem seu mecanismo:

• WebChat — Captura UTMs (utm_source, utm_medium, utm_campaign), gclid (Google), fbclid (Facebook), srsltid (Google Shopping) e referrer direto da URL onde o widget abriu.
• WhatsApp Cloud CTWA — Anúncios Meta "Click-to-WhatsApp" passam ctwa_clid automaticamente quando o cliente clica. Codewo captura no primeiro evento.
• WhatsApp Web — Atendente pode colar código [#CW-XXXX] na primeira mensagem. Cliente que mandar mensagem com código tem touchpoint marcado.
• Telegram — Deep link /start CW-XXXX (ver Telegram).
• Email — Source = "direct" (não há jeito padrão de carregar UTM em email).
• Manual — Admin/atendente cria contato manualmente → source = "manual".

Quando nenhuma fonte é identificada → source = "direct". Toda conversa termina com pelo menos um touchpoint — nunca fica vazio.

Códigos de atribuição (CW-XXXX)

Pra rastrear origem em canais que não passam UTMs nativamente (Telegram, WhatsApp Web, link direto), você cria códigos de atribuição em Configurações → Atribuição → Códigos de origem.

• Slug do código (ex: CW-INSTA-VENDAS).
• Descrição (ex: "Vendas via Instagram Stories").
• Source normalizado (ex: meta_organic).
• Campanha (opcional).

Depois você divulga o código em links: https://t.me/seu_bot?start=CW-INSTA-VENDAS. Quem clicar e mandar /start no Telegram tem touchpoint com esse código.

Relatório de atribuição

Em Relatórios → Atribuição:

• KPIs no topo — Total de leads, % de leads pagos, % de leads multi-touch.
• Breakdown por source — Quantos contatos vieram de cada origem (Meta Ads, Google Ads, Direct, Manual, etc.).
• Breakdown por campanha — Quando UTM_campaign disponível, mostra performance por campanha específica.
• Breakdown por canal — Qual canal recebeu mais leads (WebChat, WhatsApp Cloud, etc.).
• Filtros — Período, source, campanha, canal.

Útil pra:

• Decidir orçamento de mídia paga (qual fonte traz mais lead qualificado).
• Identificar canais subaproveitados.
• Provar ROI de anúncios (X reais gastos → Y leads).

Pegadinhas comuns

• Single-touch é tudo que você vê em muitas ferramentas. Aqui é multi-touch. Não compare direto com Google Analytics "Origem" — métricas são diferentes.
• utm_source=facebook vs utm_source=Facebook vs utm_source=fb viram sources diferentes. Normalização não é 100% — padronize seus links.
• CTWA precisa de configuração no Meta Ads Manager. Se você não habilitou "passar parâmetros" no anúncio, o ctwa_clid não chega.
• Direct é a categoria "lixeira". Quando nada é identificado, vira direct. Se Direct é >40% do total, você está perdendo atribuição em algum canal.
• Cliente que limpa cookies aparece como direct. Limitação técnica — sem cookies, sem UTM. WebChat tem essa fragilidade.
• Códigos CW- precisam ser cadastrados antes. Link que aponta pra código inexistente vira direct.
• Telegram /start sem código é normal. Maioria dos cliques no botão "Iniciar" do bot não vem com código. Não trate isso como bug.

Boas práticas

• Padronize naming — utm_source em minúsculas, utm_campaign com prefixo de produto/período (vendas-2025-q1).
• Use códigos CW- em canais sem UTM nativo. Cada anúncio Telegram, cada link Web → um código próprio.
• Cruze atribuição com SLA. Lead que vem de "Meta Ads" e fica 4h sem resposta = perda. Cruze pra priorizar.
• Audite "direct" trimestralmente. Se subir, algo quebrou — talvez UTM sumiu de um anúncio.
• Capacite a equipe a perguntar origem. Se o cliente entra sem UTM, treine o atendente a perguntar "como nos conheceu?" e marcar tag — é fallback humano.

Veja também

• WebChat: chat no seu site
• WhatsApp Cloud: setup completo
• Telegram: conectando um bot