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

• 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

Come far apparire mia_label nei report

Perché un parametro personalizzato sia visibile nei report GA4:

• Vai in GA4 > Admin > Proprietà > Definizioni personalizzate
• Clicca su "Crea definizione personalizzata"
• Inserisci:
  • Nome: es. mia_label
  • Ambito: Evento
  • Parametro evento: deve essere esattamente mia_label
  • Salva
• Dopo questa configurazione, mia_label comparirà nei report (es. in Esplorazioni o BigQuery).