@agenus-io/tracker NPM

📦 @agenus-io/tracker

Script modular, escalável e leve para rastreamento de campanhas, redirecionamento comportamental e coleta de dados anônimos de visitas.

Ideal para marketing direto, páginas de vendas, funis e campanhas de mídia paga.

✨ Funcionalidades

Módulo	Descrição
`utm`	Captura UTMs, gera `track_id` e aplica em links e formulários
`backredirect`	Redireciona visitante ao apertar “voltar”, com preservação de parâmetros
`pixel`	Registra visitas, gera `visit_id` único e envia dados anonimizados
`funnel`	Rastreia etapas de funil, abandonos e navegação cronológica
`behavior`	Monitora comportamento: cliques, scroll, tempo de permanência

🚀 Instalação via CDN (modo completo)

✅ Incluir o script principal:

<script
  src="https://cdn.jsdelivr.net/npm/@agenus-io/tracker@latest/dist/index.global.js"
  defer
></script>

✅ Inicializar:

<script>
  window.UTM_CONFIG = {
    plugins: ["utm", "pixel", "backredirect", "funnel", "behavior"],
    pixelConfig: {
      endpoint: "https://api.seudominio.com/pixel",
      useBeacon: true,
    },
    backredirectUrl: "https://sualp.com/saida",
  };

  window.AGT.init();
</script>

⚡ Uso com Lazy Loading (recomendado)

✅ Incluir apenas o lazy loader:

<script
  src="https://cdn.jsdelivr.net/npm/@agenus-io/tracker@latest/dist/lazy/lazyLoader.global.js"
  defer
></script>

✅ Definir config (antes do loader):

<script>
  window.UTM_CONFIG = {
    plugins: ["utm", "pixel", "backredirect"],
    pixelConfig: {
      endpoint: "https://api.seudominio.com/pixel",
      useBeacon: true,
    },
    backredirectUrl: "https://sualp.com/saida",
  };
</script>

O script será carregado automaticamente ao primeiro clique, scroll ou após 5s.

🔧 Config via HTML `data-*`

<body
  data-utm-plugins="utm,pixel,backredirect"
  data-utm-backredirect-url="https://sualp.com/saida"
  data-pixel-endpoint="https://api.seudominio.com/pixel"
  data-pixel-use-beacon="true"
></body>

📦 Instalação via NPM

npm install @agenus-io/tracker
# ou
pnpm add @agenus-io/tracker

Exemplo (TypeScript ou Next.js):

import { init } from "@agenus-io/tracker";

init(); // inicia com base em UTM_CONFIG global

🔍 Plugins disponíveis

utm: captura e aplica parâmetros UTM.
pixel: coleta dados da visita, envia para backend.
backredirect: redirecionamento inteligente ao voltar.
funnel: passos de navegação com abandono.
behavior: scroll, cliques, tempo, foco, etc.

🛠 Build

pnpm build

Estrutura de saída:

dist/
├── index.global.js
├── alias/           ← bundles alternativos (agt.js, agtio.js...)
├── lazy/            ← lazyLoader.global.js, lazyTrigger.global.js