# ClickTrail – UTM, Click ID & Ad Tracking (with Consent)
[](https://wordpress.org/)
[](https://php.net/)
[](https://www.gnu.org/licenses/gpl-2.0.html)
[](https://github.com/vizuh/click-trail)
**Stop losing campaign data. See what actually converts. Make better marketing decisions.**
[🇧🇷 Português](#português) • [🇺🇸 English](#english)
---
## English
### 🎯 What is ClickTrail?
Most WordPress sites **lose campaign data** the moment a visitor clicks away from the landing page. If they don't convert immediately, your UTM/click ID context is gone forever—leaving you with "Direct / None" conversions and a massive reporting blind spot.
**ClickTrail fixes that.**
It captures **first-touch and last-touch UTMs + click IDs** (gclid, fbclid, ttclid, msclkid, and more), stores them in first-party cookies (with consent), and **automatically injects that attribution into every form submission and WooCommerce order**—even when the buyer journey takes multiple pages or multiple sessions.
**The result?** You can finally prove which campaigns drive real conversions, cut wasted ad spend, and make marketing decisions based on actual data instead of guesswork.
Plus, the built-in consent banner with **Google Consent Mode v2** keeps you GDPR-compliant while preserving the attribution signals you need for GA4, Meta, and other platforms.
### ✨ Key Features
#### 🎯 **Marketing Attribution**
- **Multi-Touch Attribution**: Captures both first-touch and last-touch UTM parameters and click IDs
- **90-Day Cookie Persistence**: Maintains attribution data for up to 90 days
- **Automatic Form Integration**: Seamlessly injects attribution data into Contact Form 7, Fluent Forms, and Gravity Forms
- **WooCommerce Attribution**: Automatically saves attribution metadata to orders at checkout
#### 📈 **Advanced Event Tracking**
- **Client-Side Events**: Automatically tracks Site Searches, File Downloads, **Scroll Depth (25/50/75/90%)** using GTM's built-in variables, and **User Engagement** (10s/30s/1m/2m/5m) with descriptive engagement levels.
- **Server-Side Events**: Tracks User Logins, User Signups, and Comments, pushing them to the dataLayer.
- **GA4-Ready**: All events push to dataLayer in GA4-compatible format for easy GTM integration.
#### 🔒 **Privacy & Consent**
- **Built-in Consent Banner**: Customizable consent management interface
- **Google Consent Mode**: Full integration with Google Consent Mode v2
- **Flexible Consent Rules**:
- **Strict Mode**: Everything denied by default
- **Relaxed Mode**: Everything granted by default
- **Geo-based Mode**: Custom rules for EU/UK/CH vs. rest of world
- **GDPR Ready**: Designed with privacy regulations in mind
#### 📊 **Multi-Platform Click ID Support**
Captures click IDs from all major advertising platforms:
- **Google**: `gclid`, `wbraid`, `gbraid`
- **Meta/Facebook**: `fbclid`
- **TikTok**: `ttclid`
- **Microsoft**: `msclkid`
- **Twitter**: `twclid`
- **LinkedIn**: `li_fat_id`
- **Snapchat**: `ScCid`
- **Pinterest**: `epik`
#### 🛒 **WooCommerce Deep Integration**
- **Source Column**: New admin column showing first-touch attribution at a glance
- **Attribution Meta Box**: Complete first-touch and last-touch data on order pages
- **GA4 Purchase Events**: Enriched, GA4-ready purchase events with campaign data and line items
- **Duplicate Prevention**: Prevents duplicate events on page refresh
#### 💬 **WhatsApp Tracking**
- Automatically tracks clicks on WhatsApp links (`wa.me`, `whatsapp.com`, `api.whatsapp.com`)
- Pushes `wa_click` events to dataLayer with full attribution details
- Perfect for GTM integration
### 🚀 Installation
1. Download the plugin from the [releases page](https://github.com/vizuh/click-trail/releases)
2. Upload to `/wp-content/plugins/click-trail-handler/` directory
3. Activate through the WordPress 'Plugins' menu
4. Navigate to **ClickTrail** in the admin menu to configure settings
### ⚙️ Configuration
Access the **Attribution & Consent Settings** page from the ClickTrail admin menu:
- **Attribution Toggle**: Enable/disable attribution capture
- **Cookie Duration**: Set persistence time (default: 90 days)
- **Consent Requirements**: Choose whether to require user consent
- **Consent Mode**: Select Strict, Relaxed, or Geo-based mode
- **Integration Settings**: Configure form and WooCommerce integrations
### 🧪 Testing Your Setup
1. **Test Attribution Capture**: Visit your site with UTM parameters (e.g., `?utm_source=test&utm_medium=cpc`)
2. **Verify Cookie Storage**: Check browser cookies for `ct_attribution` or `attribution`
3. **Test Form Submission**: Submit a form and verify attribution data is captured
4. **WooCommerce Test**: Complete a test order and check the "Source" column and order meta
### 📖 Documentation
For detailed documentation, visit [vizuh.com/clicktrail-docs](https://vizuh.com)
### 🤝 Support
Need help? Contact us at [support@vizuh.com](mailto:support@vizuh.com)
### 📄 License
This plugin is licensed under the [GPLv2 or later](https://www.gnu.org/licenses/gpl-2.0.html).
### 🌟 About Vizuh
**Vizuh** develops cutting-edge digital solutions for WordPress and WooCommerce. We specialize in marketing attribution, analytics, and privacy-compliant tracking solutions.
Visit us at [vizuh.com](https://vizuh.com)
---
## Português
### 🎯 O que é o ClickTrail?
**ClickTrail** é um plugin WordPress completo que conecta **conformidade com privacidade do usuário** e **atribuição de marketing precisa**. Combina gerenciamento robusto de consentimento com rastreamento poderoso de atribuição para ajudá-lo a entender quais campanhas geram resultados—respeitando a privacidade do usuário.
O plugin captura UTMs de primeiro e último toque e click IDs, armazena em cookies (com consentimento do usuário quando necessário), e anexa automaticamente esses dados às suas entradas de formulários e pedidos WooCommerce. O banner de consentimento integrado com Google Consent Mode garante que seu rastreamento permaneça em conformidade com GDPR e outras regulamentações de privacidade.
### ✨ Recursos Principais
#### 🎯 **Atribuição de Marketing**
- **Atribuição Multi-Touch**: Captura parâmetros UTM e click IDs de primeiro e último toque
- **Persistência de 90 Dias**: Mantém dados de atribuição por até 90 dias
- **Integração Automática com Formulários**: Injeta dados de atribuição em Contact Form 7, Fluent Forms e Gravity Forms
- **Atribuição WooCommerce**: Salva automaticamente metadados de atribuição em pedidos no checkout
#### 📈 **Rastreamento de Eventos Avançado**
- **Eventos Client-Side**: Rastreia automaticamente Buscas no Site, Downloads de Arquivos, **Profundidade de Rolagem (25/50/75/90%)** usando variáveis integradas do GTM, e **Engajamento do Usuário** (10s/30s/1m/2m/5m) com níveis de engajamento descritivos.
- **Eventos Server-Side**: Rastreia Login de Usuário, Cadastro de Usuário e Comentários, enviando-os para o dataLayer.
- **Pronto para GA4**: Todos os eventos são enviados para dataLayer em formato compatível com GA4 para fácil integração com GTM.
#### 🔒 **Privacidade & Consentimento**
- **Banner de Consentimento Integrado**: Interface personalizável de gerenciamento de consentimento
- **Google Consent Mode**: Integração completa com Google Consent Mode v2
- **Regras de Consentimento Flexíveis**:
- **Modo Restrito**: Tudo negado por padrão
- **Modo Relaxado**: Tudo concedido por padrão
- **Modo Geográfico**: Regras customizadas para visitantes da UE/UK/CH vs. resto do mundo
- **Compatível com GDPR**: Desenvolvido pensando em regulamentações de privacidade
#### 📊 **Suporte Multi-Plataforma para Click IDs**
Captura click IDs de todas as principais plataformas de publicidade:
- **Google**: `gclid`, `wbraid`, `gbraid`
- **Meta/Facebook**: `fbclid`
- **TikTok**: `ttclid`
- **Microsoft**: `msclkid`
- **Twitter**: `twclid`
- **LinkedIn**: `li_fat_id`
- **Snapchat**: `ScCid`
- **Pinterest**: `epik`
#### 🛒 **Integração Profunda com WooCommerce**
- **Coluna de Origem**: Nova coluna administrativa mostrando atribuição de primeiro toque
- **Meta Box de Atribuição**: Dados completos de primeiro e último toque nas páginas de pedidos
- **Eventos de Compra GA4**: Eventos de compra enriquecidos e prontos para GA4 com dados de campanha e itens de linha
- **Prevenção de Duplicatas**: Previne eventos duplicados ao atualizar a página
#### 💬 **Rastreamento WhatsApp**
- Rastreia automaticamente cliques em links do WhatsApp (`wa.me`, `whatsapp.com`, `api.whatsapp.com`)
- Envia eventos `wa_click` para dataLayer com detalhes completos de atribuição
- Perfeito para integração com GTM
### 🚀 Installation
1. Download the plugin from the [releases page](https://github.com/vizuh/click-trail/releases)
2. Upload to `/wp-content/plugins/click-trail-handler/` directory
3. Activate through the WordPress 'Plugins' menu
4. Navigate to **ClickTrail** in the admin menu to configure settings
### ⚙️ Configuration
Access the **Attribution & Consent Settings** page from the ClickTrail admin menu:
- **Attribution Toggle**: Enable/disable attribution capture
- **Cookie Duration**: Set persistence time (default: 90 days)
- **Consent Requirements**: Choose whether to require user consent
- **Consent Mode**: Select Strict, Relaxed, or Geo-based mode
- **Integration Settings**: Configure form and WooCommerce integrations
### 🧪 Testing Your Setup
1. **Test Attribution Capture**: Visit your site with UTM parameters (e.g., `?utm_source=test&utm_medium=cpc`)
2. **Verify Cookie Storage**: Check browser cookies for `ct_attribution` or `attribution`
3. **Test Form Submission**: Submit a form and verify attribution data is captured
4. **WooCommerce Test**: Complete a test order and check the "Source" column and order meta
### 📖 Documentation
For detailed documentation, visit [vizuh.com/clicktrail-docs](https://vizuh.com)
### 🤝 Support
Need help? Contact us at [support@vizuh.com](mailto:support@vizuh.com)
### 📄 License
This plugin is licensed under the [GPLv2 or later](https://www.gnu.org/licenses/gpl-2.0.html).
### 🌟 About Vizuh
**Vizuh** develops cutting-edge digital solutions for WordPress and WooCommerce. We specialize in marketing attribution, analytics, and privacy-compliant tracking solutions.
Visit us at [vizuh.com](https://vizuh.com)
---
## Português
### 🎯 O que é o ClickTrail?
**ClickTrail** é um plugin WordPress completo que conecta **conformidade com privacidade do usuário** e **atribuição de marketing precisa**. Combina gerenciamento robusto de consentimento com rastreamento poderoso de atribuição para ajudá-lo a entender quais campanhas geram resultados—respeitando a privacidade do usuário.
O plugin captura UTMs de primeiro e último toque e click IDs, armazena em cookies (com consentimento do usuário quando necessário), e anexa automaticamente esses dados às suas entradas de formulários e pedidos WooCommerce. O banner de consentimento integrado com Google Consent Mode garante que seu rastreamento permaneça em conformidade com GDPR e outras regulamentações de privacidade.
### ✨ Recursos Principais
#### 🎯 **Atribuição de Marketing**
- **Atribuição Multi-Touch**: Captura parâmetros UTM e click IDs de primeiro e último toque
- **Persistência de 90 Dias**: Mantém dados de atribuição por até 90 dias
- **Integração Automática com Formulários**: Injeta dados de atribuição em Contact Form 7, Fluent Forms e Gravity Forms
- **Atribuição WooCommerce**: Salva automaticamente metadados de atribuição em pedidos no checkout
#### 🔒 **Privacidade & Consentimento**
- **Banner de Consentimento Integrado**: Interface personalizável de gerenciamento de consentimento
- **Google Consent Mode**: Integração completa com Google Consent Mode v2
- **Regras de Consentimento Flexíveis**:
- **Modo Restrito**: Tudo negado por padrão
- **Modo Relaxado**: Tudo concedido por padrão
- **Modo Geográfico**: Regras customizadas para visitantes da UE/UK/CH vs. resto do mundo
- **Compatível com GDPR**: Desenvolvido pensando em regulamentações de privacidade
#### 📊 **Suporte Multi-Plataforma para Click IDs**
Captura click IDs de todas as principais plataformas de publicidade:
- **Google**: `gclid`, `wbraid`, `gbraid`
- **Meta/Facebook**: `fbclid`
- **TikTok**: `ttclid`
- **Microsoft**: `msclkid`
- **Twitter**: `twclid`
- **LinkedIn**: `li_fat_id`
- **Snapchat**: `ScCid`
- **Pinterest**: `epik`
#### 🛒 **Integração Profunda com WooCommerce**
- **Coluna de Origem**: Nova coluna administrativa mostrando atribuição de primeiro toque
- **Meta Box de Atribuição**: Dados completos de primeiro e último toque nas páginas de pedidos
- **Eventos de Compra GA4**: Eventos de compra enriquecidos e prontos para GA4 com dados de campanha e itens de linha
- **Prevenção de Duplicatas**: Previne eventos duplicados ao atualizar a página
#### 💬 **Rastreamento WhatsApp**
- Rastreia automaticamente cliques em links do WhatsApp (`wa.me`, `whatsapp.com`, `api.whatsapp.com`)
- Envia eventos `wa_click` para dataLayer com detalhes completos de atribuição
- Perfeito para integração com GTM
### 🚀 Instalação
1. Baixe o plugin da [página de releases](https://github.com/vizuh/click-trail/releases)
2. Faça upload para o diretório `/wp-content/plugins/click-trail-handler/`
3. Ative através do menu 'Plugins' do WordPress
4. Vá para **ClickTrail** no menu administrativo para configurar as definições
### ⚙️ Configuração
Acesse a página **Configurações de Atribuição & Consentimento** no menu administrativo do ClickTrail:
- **Ativar/Desativar Atribuição**: Habilita ou desabilita captura de atribuição
- **Duração do Cookie**: Define tempo de persistência (padrão: 90 dias)
- **Requisitos de Consentimento**: Escolha se deseja exigir consentimento do usuário
- **Modo de Consentimento**: Selecione modo Restrito, Relaxado ou baseado em Geolocalização
- **Configurações de Integração**: Configure integrações com formulários e WooCommerce
### 🧪 Testando Sua Configuração
1. **Teste a Captura de Atribuição**: Visite seu site com parâmetros UTM (ex: `?utm_source=teste&utm_medium=cpc`)
2. **Verifique Armazenamento de Cookie**: Cheque os cookies do navegador por `ct_attribution` ou `attribution`
3. **Teste Envio de Formulário**: Envie um formulário e verifique se os dados de atribuição são capturados
4. **Teste WooCommerce**: Complete um pedido de teste e confira a coluna "Origem" e meta do pedido
### 📖 Documentação
Para documentação detalhada, visite [vizuh.com/clicktrail-docs](https://vizuh.com)
### 🤝 Suporte
Precisa de ajuda? Entre em contato conosco em [support@vizuh.com](mailto:support@vizuh.com)
### 📄 Licença
Este plugin está licenciado sob [GPLv2 ou posterior](https://www.gnu.org/licenses/gpl-2.0.html).
### 🌟 Sobre a Vizuh
**Vizuh** desenvolve soluções digitais de ponta para WordPress e WooCommerce. Somos especializados em atribuição de marketing, analytics e soluções de rastreamento em conformidade com privacidade.
Visite-nos em [vizuh.com](https://vizuh.com)
---
**Made with ❤️ by [Vizuh](https://vizuh.com)**
[](https://vizuh.com)
[](https://github.com/vizuh)
[](mailto:support@vizuh.com)