Google Analytics API

Da Webmobili Wiki.

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

  • 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 bisogna registrare i parametri in GA4