📺 Veja em vídeo

Este tópico é demonstrado na aula:

O que é

Com a geolocalização ativa, o Mautic mostra de qual país e cidade cada contato navegou — útil
para separar tráfego real de lixo e para entender de onde vêm seus leads. A integração usa a base
MaxMind GeoLite2.

O Mautic instalado pelo GW Server já vem com o cron que baixa e mantém atualizada a base de
geolocalização. Você não precisa mexer em nada no servidor — só conectar sua conta MaxMind
dentro do Mautic.

Passo 1 — Criar a chave no MaxMind

  1. Acesse maxmind.com e faça login (pode ser com o Google).
  2. Vá em Manage License Keys → Generate new key.
  3. Dê um nome à chave (use hífen, não ponto — a maioria das ferramentas não aceita ponto no
    nome). Ex.: mautic-seudominio.
  4. Confirme. O MaxMind mostra o Account ID e a License Key.

A License Key aparece uma única vez — faça o download ou copie na hora. Guarde também o
Account ID.

Passo 2 — Conectar no Mautic

No painel do Mautic, vá em Configurações → Configurações do sistema → IP Lookup:

  1. Em serviço, escolha MaxMind GeoLite2 City (não o Country, nem os serviços pagos).
  2. No campo de autenticação, informe AccountID:LicenseKey — o Account ID, dois-pontos, e a
    License Key.
  3. Clique em Save.
  4. Clique em Fetch para baixar a base agora.

O campo pode dizer “usuário/senha”, mas não é usuário e senha — é o Account ID e a
License Key, no formato AccountID:LicenseKey.

Depois de salvar, a tela passa a mostrar apenas a data da última atualização — o cron do
servidor cuida de manter a base em dia sozinho.

CORS: liberar os domínios de rastreamento

Se você mantém o CORS ativo, só os domínios listados conseguem usar o script de rastreamento do
Mautic. Adicione cada domínio e subdomínio que você rastreia, no formato https://seudominio.

Limpe o cache depois de mexer

Depois de mudanças de configuração, instalação de plugins ou integrações no Mautic, apague o cache:
no gerenciador de arquivos, em var/cache/, remova as pastas
prod e run. A base de geolocalização (.mmdb) fica em var/…/ip data e é mantida pelo cron.

O que você ganha

A partir daí, qualquer contato que navegar no Mautic (ou nas páginas onde você instalou o script
de tracking) é rastreado com localização. Em Contatos → anônimos, você vê os IPs com o país de
origem — dá para separar bot de lead real. E quando o contato já tem e-mail na base, o Mautic
atrela o e-mail ao navegador e mostra exatamente em quais páginas o lead navega.

Veja também