Tráfego de indicação de IA

Meça visitas que chegam ao seu domínio a partir do ChatGPT, Gemini, Claude, Perplexity, Copilot e outros assistentes.

A MencionAI já acompanha se os modelos citam ou recomendam sua marca. O tráfego de indicação responde outra pergunta: alguém clicou e chegou ao site?

Como funciona

1. Crie uma site key em Configurações → Tráfego de IA (ou no acordeão Script de tráfego de IA em Chaves de API).
2. Cole o snippet no site (ou via Google Tag Manager / RD Station).
3. O script envia document.referrer e UTMs opcionais para a API v2 POST /v2/traffic/ingest.
4. O Command Center e a API mostram visitas por fonte de IA.

Importante: ChatGPT e Gemini em geral não adicionam UTMs. A atribuição depende do referrer HTTP quando ele existe. Parte dos cliques chega como Direto (“dark AI traffic”) e fica subcontada.

Snippet de instalação

Copie o snippet pronto em Configurações → Tráfego de IA. Ele se parece com:

<script
  async
  src="https://www.mencionai.com/t.js"
  data-site="YOUR_SITE_KEY"
  data-endpoint="https://api.mencionai.com/v2/traffic/ingest"
></script>

Substitua YOUR_SITE_KEY pela chave completa msk_… das Configurações (ou copie o bloco já preenchido).

Como verificar

1. Abra o site com DevTools → Rede (Network).
2. Confirme um POST para /v2/traffic/ingest com status 200.
3. Em Configurações → Tráfego de IA, use Verificar instalação, ou aguarde o status Recebendo tráfego após o primeiro ping.

---

Google Tag Manager (recomendado para times de marketing)

1. Tags → Nova → HTML personalizado.
2. Cole o snippet das Configurações.
3. Acionador: All Pages (ou as páginas que você quer medir).
4. Envie e publique o container.
5. Use o Preview do GTM para confirmar que a tag dispara.

HTML / header

Cole o snippet antes de </head> em todos os templates relevantes (ou em um partial compartilhado do layout).

Next.js (App Router)

No app/layout.tsx (ou layout raiz):

import Script from 'next/script';

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="pt-BR">
      <body>
        {children}
        <Script
          src="https://www.mencionai.com/t.js"
          strategy="afterInteractive"
          data-site="YOUR_SITE_KEY"
          data-endpoint="https://api.mencionai.com/v2/traffic/ingest"
        />
      </body>
    </html>
  );
}

Se data-* for incômodo com next/script na sua versão, use um <script async …> bruto no layout.

WordPress

Muito comum em sites de conteúdo e geração de leads no Brasil.

• Tema: cole em header.php antes de </head>, ou
• Plugin: use “Insert Headers and Footers” / WPCode / similar, ou
• GTM: carregue via plugin de Tag Manager e siga os passos do GTM acima.

Publique e limpe cache (LiteSpeed, WP Rocket, Cloudflare) depois de instalar.

Shopify

• Loja online → Temas → Editar código → theme.liquid → cole antes de </head>, ou
• Configurações → Eventos do cliente / scripts adicionais, se o plano permitir.

Webflow

Project Settings → Custom Code → Head Code → cole o snippet → Publish.

React / Vite (SPA)

Adicione o snippet em index.html dentro de <head>, ou injete uma vez no bootstrap do app para rodar no primeiro carregamento.

RD Station Marketing

Padrão frequente no Brasil quando o time de marketing já injeta tags.

1. Abra o RD Station → configurações de monitoramento do site / scripts personalizados (ou o container GTM ligado ao RD Station).
2. Adicione um bloco de HTML / script personalizado com o snippet da MencionAI (mesmo padrão de GA4 ou Meta Pixel).
3. Aplique em todas as páginas (ou nas páginas do funil que importam).
4. Publique e verifique em Rede → POST …/traffic/ingest.

Se o RD Station só hospeda o GTM, instale pelo Google Tag Manager.

ActiveCampaign e outros gerenciadores de tag

Mesmo padrão do GTM ou RD Station: HTML personalizado em All Pages. Nunca coloque API keys de organização (mak_…) no navegador.

---

Plataformas de e-commerce no Brasil

Nuvemshop

1. Admin → Loja online → Preferências / Scripts (ou Meus apps → código personalizado, conforme o plano).
2. Cole o snippet no campo de header / scripts do head.
3. Salve e abra a vitrine uma vez para verificar o ingest.

Se o plano só permitir apps: instale via Google Tag Manager conectado à loja.

Loja Integrada

1. Admin → Layout → Código HTML / Scripts (ou Configurações → códigos personalizados).
2. Cole o snippet na seção do head.
3. Salve, limpe cache se houver, e verifique Rede → ingest.

Tray Commerce

1. Admin → Configurações → Códigos e SEO / Scripts personalizados (os rótulos variam conforme a versão Tray).
2. Adicione o snippet no header.
3. Salve e teste na vitrine publicada.

VTEX

1. Prefira Google Tag Manager (o mais comum em VTEX IO / CMS), ou
2. HTML personalizado no head do storefront / CMS nas páginas medidas, ou
3. App de pixels/scripts se a conta já centraliza tags de terceiros.

Use GTM em todo o site para cobrir landing e checkout.

Magento / Adobe Commerce

• Adicione o snippet no tema (default_head_blocks.xml / template do head), ou
• Use uma extensão de scripts / GTM e instale pelo GTM.

Wix e landpages (Hotmart, Eduzz, Braip, etc.)

• Wix: Configurações → Código personalizado → Head → Todas as páginas → cole o snippet.
• Checkouts / landpages de membros: se a plataforma permitir “head / pixels de rastreamento”, cole o mesmo snippet; senão, carregue via GTM nesses domínios (cadastre o domínio da landpage no projeto ou um host permitido correspondente).

---

Privacidade

O snippet do MVP é sem cookies de marketing (só sessionStorage, sem IP bruto no fluxo do produto). Sua política de consentimento/banner ainda se aplica se você combinar com outras tags de marketing.

---

API v2

Método	Path	Auth
POST	/v2/traffic/ingest	Site key (msk_…) no body ou X-MencionAI-Site-Key
GET	/v2/workspaces/{id}/traffic/summary	API key + workspaces:read
GET	/v2/workspaces/{id}/traffic/series	API key + workspaces:read
POST	/v2/workspaces/{id}/traffic/site-key	API key + workspaces:write

Nunca coloque API keys de organização (mak_…) no snippet do navegador.