Uma linha de código – e todo o resto conforme a sua necessidade
O código de rastreamento tem cerca de 5 KB comprimido e funciona em qualquer site. Para eventos, login, e-commerce e dados do lado do servidor, há uma API JavaScript enxuta e uma API de servidor.
<script defer src="https://visualclicks.de/t/fwa.js" data-site="vc_…"></script>Eventos, propriedades e login
Envie seus próprios eventos, como buscas, downloads ou cliques, com fwa.track(), e informações extras com fwa.set() – para o evento, a página, a sessão ou de forma permanente para o usuário. Após o login, fwa.identify() vincula a sessão ao seu número de cliente.
Cada nova propriedade aparece automaticamente no registro de propriedades e fica então disponível em filtros, cards e segmentos.
// evento com propriedades
fwa.track('search', { query: 'barraca', results: 12 });
// propriedade para a sessão inteira
fwa.set('customer_type', 'vip', { scope: 'session' });
// vincular o login, sair
fwa.identify('cust_4711');
fwa.reset();
// consentimento do seu banner de cookies
fwa.consent.grant(['analytics', 'recording']);O processo de compra como eventos
A API de e-commerce segue a estrutura do Google Analytics 4: visualização de produto, carrinho, checkout, envio, pagamento, compra e reembolso, cada um com itens, marca, categorias, preço e quantidade.
Se a sua loja já tem um modelo de dados do GA4, a migração exige pouco esforço.
fwa.ecommerce.viewItem({ item_id: 'ZT-100', item_name: 'Barraca de trekking',
item_brand: 'NordCamp', item_category: 'Barracas', price: 249 });
fwa.ecommerce.addToCart({ item_id: 'ZT-100', price: 249, quantity: 1 });
fwa.ecommerce.beginCheckout(items, { value: 249 });
fwa.ecommerce.purchase(items, { transaction_id: 'A-1001',
value: 249, tax: 39.76, shipping: 0, currency: 'EUR' });Pedidos e crawlers de IA direto do seu servidor
Com uma chave de servidor gerada nas configurações, o seu backend envia eventos diretamente ao VisualClicks – independentemente de navegador, bloqueador de anúncios e consentimento. Os pedidos são unificados com os dados do navegador pelo número do pedido.
Da mesma forma, você informa os acessos de crawlers de IA ou envia um log de acesso no formato “combined”.
- Várias chaves por site, revogáveis uma a uma
- Uma chave é exibida apenas uma vez e armazenada somente como hash
- Exclusão de IPs para tráfego interno
curl -X POST https://visualclicks.de/api/s/v1/events \
-H "Authorization: Bearer vcsk_…" \
-H "Content-Type: application/json" \
-d '{"source":"server","e":[{"t":"ecommerce","n":"purchase",
"u":"https://shop.example/thank-you",
"x":{"transaction_id":"A-1001","value":249}}]}'Assíncrono
Carrega com defer e nunca bloqueia a página
Single-page apps
Mudanças de página via History API automaticamente
Sem programar
Rastreie cliques com data-fwa-event
Vários sites
Código e configurações próprios por site
Perguntas frequentes
Onde instalo o código de rastreamento?
No <head> de todas as páginas – na maioria dos CMS e sistemas de loja, pelo tema ou por um campo para scripts personalizados. O código carrega de forma assíncrona e não bloqueia a página.
Funciona com single-page apps (React, Vue, Next.js)?
Sim. As mudanças de página pela History API são registradas automaticamente como visualizações de página.
Como rastreio cliques em botões sem programar?
Com o atributo data-fwa-event no elemento, por exemplo data-fwa-event="newsletter_click". Adicione propriedades extras com data-fwa-prop-….
Para que serve uma chave de servidor?
Ela permite que o seu servidor envie eventos diretamente: pedidos, reembolsos ou acessos de crawlers de IA. Chaves de servidor nunca devem ficar no código-fonte do seu site e podem ser revogadas uma a uma.
Pronto para a primeira linha de código?
Solicite seu acesso. Depois, basta uma linha de código de rastreamento – as primeiras visitas aparecem em tempo real.