Una riga di codice – e tutto il resto quando ti serve
Il codice di tracciamento pesa circa 5 KB compresso e funziona su qualsiasi sito web. Per eventi, login, e-commerce e dati lato server ci sono un’API JavaScript leggera e un’API server.
<script defer src="https://visualclicks.de/t/fwa.js" data-site="vc_…"></script>Eventi, proprietà e login
Invia i tuoi eventi, come ricerche, download o clic, con fwa.track() e informazioni aggiuntive con fwa.set() – per l’evento, la pagina, la sessione o in modo permanente per l’utente. Dopo il login, fwa.identify() collega la sessione al tuo numero cliente.
Ogni nuova proprietà compare automaticamente nel registro delle proprietà ed è poi disponibile in filtri, schede e segmenti.
// evento con proprietà
fwa.track('search', { query: 'tenda', results: 12 });
// proprietà per l’intera sessione
fwa.set('customer_type', 'vip', { scope: 'session' });
// collega il login, esegui il logout
fwa.identify('cust_4711');
fwa.reset();
// consenso dal tuo cookie banner
fwa.consent.grant(['analytics', 'recording']);Il processo d’acquisto come eventi
L’API e-commerce segue la struttura di Google Analytics 4: visualizzazione del prodotto, carrello, checkout, spedizione, pagamento, acquisto e rimborso, ciascuno con articoli, marca, categorie, prezzo e quantità.
Se il tuo shop ha già un modello di dati GA4, il passaggio richiede poco lavoro.
fwa.ecommerce.viewItem({ item_id: 'ZT-100', item_name: 'Tenda da trekking',
item_brand: 'NordCamp', item_category: 'Tende', 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' });Ordini e crawler IA direttamente dal tuo server
Con una chiave server presa dalle impostazioni, il tuo backend invia gli eventi direttamente a VisualClicks – indipendentemente da browser, ad blocker e consenso. Gli ordini vengono uniti ai dati del browser tramite il numero d’ordine.
Allo stesso modo comunichi le richieste dei crawler IA, oppure carichi un access log in formato «combined».
- Più chiavi per sito web, revocabili singolarmente
- Una chiave viene mostrata una sola volta e salvata solo come hash
- Esclusione di IP per il traffico 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}}]}'Asincrono
Si carica con defer, non blocca mai la pagina
Single-page app
Cambi di pagina tramite la History API, in automatico
Nessun codice necessario
Traccia i clic con data-fwa-event
Più siti web
Codice e impostazioni propri per ogni sito web
Domande frequenti
Dove inserisco il codice di tracciamento?
Nel <head> di ogni pagina – nella maggior parte dei CMS e delle piattaforme e-commerce tramite il tema o un campo per script personalizzati. Il codice si carica in modo asincrono e non blocca la pagina.
Funziona con le single-page app (React, Vue, Next.js)?
Sì. I cambi di pagina tramite la History API vengono rilevati automaticamente come visualizzazioni di pagina.
Come traccio i clic sui pulsanti senza programmare?
Con l’attributo data-fwa-event sull’elemento, per esempio data-fwa-event="newsletter_click". Aggiungi proprietà extra con data-fwa-prop-….
A cosa serve una chiave server?
Permette al tuo server di inviare eventi direttamente: ordini, rimborsi o richieste dei crawler IA. Le chiavi server non vanno mai inserite nel codice sorgente del tuo sito web e si possono revocare singolarmente.
Pronto per la prima riga di codice?
Richiedi il tuo accesso. Poi basta una riga di codice di tracciamento – le prime visite compaiono in tempo reale.