ESTA DOCUMENTAÇÃO ESTÁ EM DESENVOLVIMENTO E CONSTANTE ATUALIZAÇÃO.

Smart Forms — Captura & Atribuição UTM

Como os formulários inteligentes capturam dinamicamente dados de tráfego (UTMs) e realizam a atribuição no CRM.

Captura de UTMs Automatizada

O script de tracking incorporado em todas as Landing Pages e Smart Forms varre a URL de destino da requisição do lead, capturando e salvando em cookies de sessão as variáveis padrão do Google Analytics:

  • utm_source: Identifica a origem do tráfego (Ex: facebook, google, newsletter).
  • utm_medium: Identifica o tipo de anúncio ou mídia (Ex: cpc, organic, email).
  • utm_campaign: Nome da campanha de marketing ativa.
  • utm_content / utm_term: Variações do anúncio e palavras-chave de busca correspondentes.

Atribuição no Banco de Dados

Quando o Smart Form é submetido, o payload enviado à API inclui o objeto utm. A rota de criação de contatos salva esses metadados associados ao lead:

{`
Processamento de Atribuição no CRM:
1. Lead preenche Smart Form em /lp/oferta?utm_source=facebook
2. Componente React extrai UTMs do cookie/URL
3. POST /api/leads envia o payload contendo o objeto UTM
4. Banco registra LeadActivity com tags de atribuição
5. Atlas analisa as atividades e calcula o ROI por origem
          `}

Cookies e Persistência

Os cookies de UTM são configurados com expiração deslizante de 30 dias. Se o lead navegar por várias páginas do site do tenant antes de preencher o formulário, as UTMs originais do primeiro ponto de entrada (First Touchpoint) são preservadas para garantir a precisão da métrica de ROI.

Próximo: Smart Forms — Segurança & Rate Limits →