Skip to content

Sistema avançado de rastreamento e redirecionamento para links do WhatsApp com captura completa de dados UTM, parâmetros de ads e análise de conversões para provedores de internet.

Notifications You must be signed in to change notification settings

douglasmendescwb/ligga

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

Ligga Fibra - Sistema de Tracking Completo

Sistema avançado de rastreamento e redirecionamento para links do WhatsApp, desenvolvido especificamente para provedores de internet e empresas de telecomunicações.

🚀 Funcionalidades

  • Interceptação automática de links do WhatsApp
  • Captura completa de dados UTM e parâmetros de ads
  • Tracking multi-plataforma (Google Ads, Meta Ads, TikTok Ads, Microsoft Ads)
  • Detecção automática de fonte quando não especificada
  • Dados de dispositivo e sessão para análise completa
  • API JavaScript para uso programático
  • Zero configuração - funciona automaticamente após instalação

📊 Dados Capturados

Parâmetros UTM

  • utm_source, utm_medium, utm_campaign, utm_content, utm_term

Plataformas de Ads

  • Google Ads: gclid, gbraid, wbraid, gclsrc
  • Meta/Facebook: fbclid, fbp, fbc
  • TikTok: ttclid
  • Microsoft: msclkid

Dados Específicos do Negócio

  • plano, velocidade, promo, desconto
  • cidade, bairro

Dados da Sessão

  • URL atual, referrer, título da página
  • Tipo de dispositivo, idioma, timezone
  • ID de sessão único, timestamp

🛠️ Instalação

1. Instalação Básica

Adicione o script antes do </body> em todas as páginas:

<script src="path/to/ligga-tracking.js"></script>

2. Configuração

O sistema funciona automaticamente com as configurações padrão. Para personalizar:

// Modifique as configurações no início do arquivo
const CONFIG = {
    REDIRECT_BASE_URL: 'https://seudominio.com.br/whatsapp',
    AUTO_INTERCEPT: true,
    DEBUG: false, // true para logs detalhados
    TRACK_PARAMS: [/* seus parâmetros personalizados */]
};

📝 Como Usar

Links Automáticos (Interceptados)

Qualquer link do WhatsApp será automaticamente interceptado:

<a href="https://wa.me/5511999999999">Falar no WhatsApp</a>
<a href="https://api.whatsapp.com/send?phone=5511999999999">Contato</a>

Links com Dados Específicos

Use data-attributes para adicionar informações específicas:

<a href="https://wa.me/5511999999999" 
   data-source="planos" 
   data-plano="100mb" 
   data-velocidade="100" 
   data-promo="black-friday"
   data-cidade="sao-paulo"
   data-bairro="centro">
   Contratar Plano 100MB
</a>

Links Diretos ao Sistema

Links que já apontam para sua página de redirecionamento serão automaticamente aprimorados:

<a href="https://liggavendas.com.br/whatsapp?source=homepage&plano=200mb">
    Plano 200MB - R$ 79,90
</a>

🔧 API JavaScript

Capturar Dados Atuais

const dados = LiggaTracking.getData();
console.log(dados);

Criar Link Personalizado

const link = LiggaTracking.createLink({
    source: 'popup',
    plano: '500mb',
    promo: 'desconto50',
    cidade: 'rio-de-janeiro'
});

Redirecionamento Programático

// Redireciona imediatamente com dados personalizados
LiggaTracking.redirect({
    source: 'botao-cta',
    plano: '1gb',
    velocidade: '1000',
    promo: 'primeira-mensalidade-gratis'
});

Forçar Tracking em Link Específico

<a href="https://wa.me/5511999999999" class="ligga-track">
    Este link será sempre interceptado
</a>

🎯 Exemplos Práticos

Landing Page de Planos

<!-- Plano Básico -->
<a href="https://wa.me/5511999999999"
   data-source="landing-planos"
   data-plano="basico"
   data-velocidade="100"
   data-promo="primeira-mensalidade-50off">
   Contratar Plano Básico - 100MB
</a>

<!-- Plano Premium -->
<a href="https://wa.me/5511999999999"
   data-source="landing-planos"
   data-plano="premium"
   data-velocidade="500"
   data-promo="instalacao-gratis">
   Contratar Plano Premium - 500MB
</a>

Popup de Promoção

// Quando usuário clica em "Quero Desconto"
document.getElementById('popup-desconto').addEventListener('click', function() {
    LiggaTracking.redirect({
        source: 'popup-promocional',
        promo: 'black-friday-70off',
        plano: 'escolha-do-usuario',
        urgencia: 'limitado'
    });
});

Página de Cidade Específica

<!-- Para São Paulo -->
<a href="https://wa.me/5511999999999"
   data-source="pagina-cidade"
   data-cidade="sao-paulo"
   data-bairro="vila-madalena"
   data-cobertura="disponivel">
   Verificar Cobertura - Vila Madalena
</a>

📈 Dados Coletados (Exemplo)

{
  "utm_source": "google",
  "utm_medium": "cpc",
  "utm_campaign": "planos-fibra-sp",
  "gclid": "Cj0KCQjw...",
  "source": "google_ads",
  "plano": "200mb",
  "velocidade": "200",
  "promo": "black-friday",
  "cidade": "sao-paulo",
  "current_url": "https://seusite.com.br/planos",
  "referrer": "https://www.google.com/",
  "device_type": "mobile",
  "is_mobile": true,
  "timestamp": "2025-01-15T10:30:00.000Z",
  "session_id": "1642248600abc123",
  "link_text": "Contratar Agora",
  "original_href": "https://wa.me/5511999999999"
}

⚙️ Configurações Avançadas

Debug Mode

const CONFIG = {
    DEBUG: true // Ativa logs detalhados no console
};

Parâmetros Personalizados

const CONFIG = {
    TRACK_PARAMS: [
        // UTMs padrão
        'utm_source', 'utm_medium', 'utm_campaign',
        // Seus parâmetros específicos
        'região', 'vendedor', 'canal_origem'
    ]
};

Interceptação Seletiva

const CONFIG = {
    AUTO_INTERCEPT: false // Desativa interceptação automática
};

// Use class="ligga-track" nos links que quer rastrear

🔍 Troubleshooting

Links não são interceptados

  • Verifique se AUTO_INTERCEPT está true
  • Certifique-se que são links do WhatsApp válidos
  • Use DEBUG: true para ver logs no console

Dados não aparecem

  • Verifique se o script está carregado antes dos links
  • Confirme se a URL de redirecionamento está correta
  • Use LiggaTracking.getData() para testar

Performance

  • O script é leve (~8KB minificado)
  • Usa event delegation (eficiente)
  • Não interfere em outros scripts

📞 Suporte

Para dúvidas ou customizações específicas, entre em contato através do WhatsApp configurado no sistema.


Desenvolvido especificamente para provedores de internet que precisam de tracking avançado e conversões otimizadas via WhatsApp.

About

Sistema avançado de rastreamento e redirecionamento para links do WhatsApp com captura completa de dados UTM, parâmetros de ads e análise de conversões para provedores de internet.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published