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

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).
Cole o snippet no site (ou via Google Tag Manager / RD Station).
O script envia document.referrer e UTMs opcionais para a API v2 POST /v2/traffic/ingest.
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

Abra o site com DevTools → Rede (Network).
Confirme um POST para /v2/traffic/ingest com status 200.
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)

Tags → Nova → HTML personalizado.
Cole o snippet das Configurações.
Acionador: All Pages (ou as páginas que você quer medir).
Envie e publique o container.
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.

Abra o RD Station → configurações de monitoramento do site / scripts personalizados (ou o container GTM ligado ao RD Station).
Adicione um bloco de HTML / script personalizado com o snippet da MencionAI (mesmo padrão de GA4 ou Meta Pixel).
Aplique em todas as páginas (ou nas páginas do funil que importam).
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

Admin → Loja online → Preferências / Scripts (ou Meus apps → código personalizado, conforme o plano).
Cole o snippet no campo de header / scripts do head.
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

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

Tray Commerce

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

VTEX

Prefira Google Tag Manager (o mais comum em VTEX IO / CMS), ou
HTML personalizado no head do storefront / CMS nas páginas medidas, ou
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.