Google Analytics API

Vantaggi

• Tracciamento lato server (resistente ad AdBlock, iOS, GDPR-friendly se ben fatto)
• Massimo controllo su cosa e come invii
• Puoi automatizzare tutto (linking account, eventi, importazioni)
• Utile per siti headless, app mobile, serverless, backend

Differenza tra eventi standard e eventi personalizzati

• Eventi standard (Google li riconosce e li elabora in automatico):
  • page_view, purchase, login, sign_up, generate_lead

• Eventi personalizzati (appaiono nei report dopo essere stati inviati):
  • video_played, cta_clicked, form_error

Dove vedere i miei eventi

• GA4 > Configura > Eventi → Appaiono qui appena ricevuti
• DebugView → Ottimo per testare in tempo reale
• Conversioni → Puoi promuovere qualsiasi evento a “conversione”

Esempio e requisiti

Si possono aggiungere tutti i parametri personalizzati che vuoi all'interno del tuo evento gtag('event', ...), quindi anche label, mia_label o qualsiasi altro — ma ci sono alcune regole da rispettare.

gtag('event', 'form_error', {
  form_name: 'contatto',
  field: 'email',
  error_type: 'invalid_format',
  label: 'errore email contatto',
  mia_label: 'errore_1'
});

Limiti dei parametri GA4

| Regola | Dettaglio | | ---------------------------------- | --------------------------------------------------------- | | 🔤 **Nome del parametro** | max 40 caratteri, solo lettere, numeri e underscore (`_`) | | 🧾 **Valore del parametro** | max 100 caratteri (stringa o numero) | | 📈 **Max parametri per evento** | Fino a **25 parametri** personalizzati per evento | | 👁️‍🗨️ **Per vederli nei report** | Devi **registrare i parametri** in GA4 (vedi sotto) |