Eventi analytics che servono davvero in un ecommerce

Cinque eventi coprono un ecommerce: vista prodotto, aggiunta al carrello, inizio checkout, acquisto e ricerca senza risultati. Il resto è rumore che costa byte e manutenzione.

I cinque eventi

Cinque eventi danno l'imbuto completo: chi guarda, chi aggiunge, chi inizia il pagamento, chi compra e cosa cerca senza trovare. Ogni evento in più va mantenuto, rinominato e riconciliato con il fatturato: dieci eventi non documentati valgono meno di cinque verificati.

Il codice: un solo punto di invio

const sent = new Set();

export function track(name, params) {
  if (name === "purchase") {
    const id = params.transaction_id;
    if (!id || sent.has(id)) return;
    sent.add(id);
  }
  window.dataLayer = window.dataLayer || [];
  window.dataLayer.push({ event: name, ...params });
}

Il controllo su transaction_id evita il doppio conteggio quando il cliente ricarica la pagina di conferma o torna indietro. Lo stesso controllo serve lato server, se l'acquisto viene inviato anche da lì: l'identificativo unico è la sola difesa contro due acquisti identici nella stessa giornata.

Quanto pesa il tag

# peso del loader GA4, compresso e non compresso
curl -s --compressed -o /dev/null -w "%{size_download}\n" \
  "https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"

curl -s -o /dev/null -w "%{size_download}\n" \
  "https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"

Il peso misurato è quello del loader, non dell'intera strumentazione: le richieste successive partono dopo. Se il loader viene caricato su ogni pagina, la spesa si paga su ogni visita; se lo carichi solo dove serve, il resto del sito resta leggero.

Il limite da dichiarare

I numeri assoluti non sono il fatturato. Blocchi degli script e scelte di consenso tolgono una parte delle visite, e la parte mancante non è distribuita in modo uniforme: chi blocca gli script non è un campione casuale dei tuoi clienti. Per questo gli eventi vanno letti come indicatori di direzione e riconciliati con gli ordini del gestionale.

Dove continuare

I punti di invio stanno nelle pagine reali: product-detail-01 per la vista prodotto, checkout-01 per l'inizio del pagamento, dentro la libreria commerCN. Per il confronto fra analytics ospitato e in casa leggi Vercel Analytics e self-hosted, per la misura lato browser PerformanceObserver e per la reattività INP in pratica.