{"id":30232408,"url":"https://github.com/douglasmendescwb/ligga","last_synced_at":"2026-05-17T15:09:44.011Z","repository":{"id":309442762,"uuid":"1015598923","full_name":"douglasmendescwb/ligga","owner":"douglasmendescwb","description":"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.","archived":false,"fork":false,"pushed_at":"2025-08-11T22:09:52.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-12T00:17:29.812Z","etag":null,"topics":["analytics","conversion-tracking","device-detection","google-ads","internet-provider","javascript","marketing-automation","meta-ads","microsoft-ads","redirect-system","session-tracking","telecom","tiktok-ads","tracking","utm-tracking","whatsapp"],"latest_commit_sha":null,"homepage":"https://shaftmarketing.com.br/#sistema-de-tracking-whatsapp","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/douglasmendescwb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-07T18:42:24.000Z","updated_at":"2025-08-12T00:07:02.000Z","dependencies_parsed_at":"2025-08-12T00:17:50.386Z","dependency_job_id":"b723da77-ea92-45d4-8ed8-f3adf8f6be8a","html_url":"https://github.com/douglasmendescwb/ligga","commit_stats":null,"previous_names":["douglasmendescwb/ligga"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/douglasmendescwb/ligga","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmendescwb%2Fligga","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmendescwb%2Fligga/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmendescwb%2Fligga/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmendescwb%2Fligga/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/douglasmendescwb","download_url":"https://codeload.github.com/douglasmendescwb/ligga/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmendescwb%2Fligga/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33143276,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T09:28:26.183Z","status":"ssl_error","status_checked_at":"2026-05-17T09:27:52.702Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","conversion-tracking","device-detection","google-ads","internet-provider","javascript","marketing-automation","meta-ads","microsoft-ads","redirect-system","session-tracking","telecom","tiktok-ads","tracking","utm-tracking","whatsapp"],"created_at":"2025-08-15T00:00:43.561Z","updated_at":"2026-05-17T15:09:43.995Z","avatar_url":"https://github.com/douglasmendescwb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ligga Fibra - Sistema de Tracking Completo\n\nSistema avançado de rastreamento e redirecionamento para links do WhatsApp, desenvolvido especificamente para provedores de internet e empresas de telecomunicações.\n\n## 🚀 Funcionalidades\n\n- **Interceptação automática** de links do WhatsApp\n- **Captura completa** de dados UTM e parâmetros de ads\n- **Tracking multi-plataforma** (Google Ads, Meta Ads, TikTok Ads, Microsoft Ads)\n- **Detecção automática de fonte** quando não especificada\n- **Dados de dispositivo e sessão** para análise completa\n- **API JavaScript** para uso programático\n- **Zero configuração** - funciona automaticamente após instalação\n\n## 📊 Dados Capturados\n\n### Parâmetros UTM\n- `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`\n\n### Plataformas de Ads\n- **Google Ads**: `gclid`, `gbraid`, `wbraid`, `gclsrc`\n- **Meta/Facebook**: `fbclid`, `fbp`, `fbc`\n- **TikTok**: `ttclid`\n- **Microsoft**: `msclkid`\n\n### Dados Específicos do Negócio\n- `plano`, `velocidade`, `promo`, `desconto`\n- `cidade`, `bairro`\n\n### Dados da Sessão\n- URL atual, referrer, título da página\n- Tipo de dispositivo, idioma, timezone\n- ID de sessão único, timestamp\n\n## 🛠️ Instalação\n\n### 1. Instalação Básica\n\nAdicione o script antes do `\u003c/body\u003e` em todas as páginas:\n\n```html\n\u003cscript src=\"path/to/ligga-tracking.js\"\u003e\u003c/script\u003e\n```\n\n### 2. Configuração\n\nO sistema funciona automaticamente com as configurações padrão. Para personalizar:\n\n```javascript\n// Modifique as configurações no início do arquivo\nconst CONFIG = {\n    REDIRECT_BASE_URL: 'https://seudominio.com.br/whatsapp',\n    AUTO_INTERCEPT: true,\n    DEBUG: false, // true para logs detalhados\n    TRACK_PARAMS: [/* seus parâmetros personalizados */]\n};\n```\n\n## 📝 Como Usar\n\n### Links Automáticos (Interceptados)\n\nQualquer link do WhatsApp será automaticamente interceptado:\n\n```html\n\u003ca href=\"https://wa.me/5511999999999\"\u003eFalar no WhatsApp\u003c/a\u003e\n\u003ca href=\"https://api.whatsapp.com/send?phone=5511999999999\"\u003eContato\u003c/a\u003e\n```\n\n### Links com Dados Específicos\n\nUse `data-attributes` para adicionar informações específicas:\n\n```html\n\u003ca href=\"https://wa.me/5511999999999\" \n   data-source=\"planos\" \n   data-plano=\"100mb\" \n   data-velocidade=\"100\" \n   data-promo=\"black-friday\"\n   data-cidade=\"sao-paulo\"\n   data-bairro=\"centro\"\u003e\n   Contratar Plano 100MB\n\u003c/a\u003e\n```\n\n### Links Diretos ao Sistema\n\nLinks que já apontam para sua página de redirecionamento serão automaticamente aprimorados:\n\n```html\n\u003ca href=\"https://liggavendas.com.br/whatsapp?source=homepage\u0026plano=200mb\"\u003e\n    Plano 200MB - R$ 79,90\n\u003c/a\u003e\n```\n\n## 🔧 API JavaScript\n\n### Capturar Dados Atuais\n\n```javascript\nconst dados = LiggaTracking.getData();\nconsole.log(dados);\n```\n\n### Criar Link Personalizado\n\n```javascript\nconst link = LiggaTracking.createLink({\n    source: 'popup',\n    plano: '500mb',\n    promo: 'desconto50',\n    cidade: 'rio-de-janeiro'\n});\n```\n\n### Redirecionamento Programático\n\n```javascript\n// Redireciona imediatamente com dados personalizados\nLiggaTracking.redirect({\n    source: 'botao-cta',\n    plano: '1gb',\n    velocidade: '1000',\n    promo: 'primeira-mensalidade-gratis'\n});\n```\n\n### Forçar Tracking em Link Específico\n\n```html\n\u003ca href=\"https://wa.me/5511999999999\" class=\"ligga-track\"\u003e\n    Este link será sempre interceptado\n\u003c/a\u003e\n```\n\n## 🎯 Exemplos Práticos\n\n### Landing Page de Planos\n\n```html\n\u003c!-- Plano Básico --\u003e\n\u003ca href=\"https://wa.me/5511999999999\"\n   data-source=\"landing-planos\"\n   data-plano=\"basico\"\n   data-velocidade=\"100\"\n   data-promo=\"primeira-mensalidade-50off\"\u003e\n   Contratar Plano Básico - 100MB\n\u003c/a\u003e\n\n\u003c!-- Plano Premium --\u003e\n\u003ca href=\"https://wa.me/5511999999999\"\n   data-source=\"landing-planos\"\n   data-plano=\"premium\"\n   data-velocidade=\"500\"\n   data-promo=\"instalacao-gratis\"\u003e\n   Contratar Plano Premium - 500MB\n\u003c/a\u003e\n```\n\n### Popup de Promoção\n\n```javascript\n// Quando usuário clica em \"Quero Desconto\"\ndocument.getElementById('popup-desconto').addEventListener('click', function() {\n    LiggaTracking.redirect({\n        source: 'popup-promocional',\n        promo: 'black-friday-70off',\n        plano: 'escolha-do-usuario',\n        urgencia: 'limitado'\n    });\n});\n```\n\n### Página de Cidade Específica\n\n```html\n\u003c!-- Para São Paulo --\u003e\n\u003ca href=\"https://wa.me/5511999999999\"\n   data-source=\"pagina-cidade\"\n   data-cidade=\"sao-paulo\"\n   data-bairro=\"vila-madalena\"\n   data-cobertura=\"disponivel\"\u003e\n   Verificar Cobertura - Vila Madalena\n\u003c/a\u003e\n```\n\n## 📈 Dados Coletados (Exemplo)\n\n```json\n{\n  \"utm_source\": \"google\",\n  \"utm_medium\": \"cpc\",\n  \"utm_campaign\": \"planos-fibra-sp\",\n  \"gclid\": \"Cj0KCQjw...\",\n  \"source\": \"google_ads\",\n  \"plano\": \"200mb\",\n  \"velocidade\": \"200\",\n  \"promo\": \"black-friday\",\n  \"cidade\": \"sao-paulo\",\n  \"current_url\": \"https://seusite.com.br/planos\",\n  \"referrer\": \"https://www.google.com/\",\n  \"device_type\": \"mobile\",\n  \"is_mobile\": true,\n  \"timestamp\": \"2025-01-15T10:30:00.000Z\",\n  \"session_id\": \"1642248600abc123\",\n  \"link_text\": \"Contratar Agora\",\n  \"original_href\": \"https://wa.me/5511999999999\"\n}\n```\n\n## ⚙️ Configurações Avançadas\n\n### Debug Mode\n\n```javascript\nconst CONFIG = {\n    DEBUG: true // Ativa logs detalhados no console\n};\n```\n\n### Parâmetros Personalizados\n\n```javascript\nconst CONFIG = {\n    TRACK_PARAMS: [\n        // UTMs padrão\n        'utm_source', 'utm_medium', 'utm_campaign',\n        // Seus parâmetros específicos\n        'região', 'vendedor', 'canal_origem'\n    ]\n};\n```\n\n### Interceptação Seletiva\n\n```javascript\nconst CONFIG = {\n    AUTO_INTERCEPT: false // Desativa interceptação automática\n};\n\n// Use class=\"ligga-track\" nos links que quer rastrear\n```\n\n## 🔍 Troubleshooting\n\n### Links não são interceptados\n- Verifique se `AUTO_INTERCEPT` está `true`\n- Certifique-se que são links do WhatsApp válidos\n- Use `DEBUG: true` para ver logs no console\n\n### Dados não aparecem\n- Verifique se o script está carregado antes dos links\n- Confirme se a URL de redirecionamento está correta\n- Use `LiggaTracking.getData()` para testar\n\n### Performance\n- O script é leve (~8KB minificado)\n- Usa event delegation (eficiente)\n- Não interfere em outros scripts\n\n## 📞 Suporte\n\nPara dúvidas ou customizações específicas, entre em contato através do WhatsApp configurado no sistema.\n\n---\n\n**Desenvolvido especificamente para provedores de internet que precisam de tracking avançado e conversões otimizadas via WhatsApp.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglasmendescwb%2Fligga","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdouglasmendescwb%2Fligga","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglasmendescwb%2Fligga/lists"}