Collega Google Analytics 4 a Elido

Elido invia lato server un evento GA4 per ogni clic su un link tramite il Measurement Protocol. Gli eventi arrivano a GA4 indipendentemente dal fatto che l'utente abbia un adblocker, senza alcun JavaScript sulla tua pagina.

Cosa ti serve

• Una proprietà GA4 (non Universal Analytics).
• L'accesso al pannello Admin della proprietà.
• Circa 5 minuti.

Passaggio 1 - Trova il Measurement ID

1. Vai su Google Analytics.
2. Fai clic su Admin (icona a ingranaggio in basso a sinistra).
3. Sotto Property, fai clic su Data streams → Web.
4. Fai clic sul tuo flusso di dati web.
5. Copia il Measurement ID: inizia con G-, ad esempio G-XXXXXXXXXX.

Passaggio 2 - Crea un API secret del Measurement Protocol

Nella stessa pagina del flusso di dati:

1. Scorri fino a Measurement Protocol API secrets.
2. Fai clic su Create.
3. Dagli un nome ("Elido") e fai clic su Create.
4. Copia il valore del secret. Viene mostrato una sola volta. Se lo perdi, creane uno nuovo: i vecchi secret continuano a funzionare finché non li elimini.

Passaggio 3 - Configura in Elido

1. Vai su Dashboard → Integrations → Google Analytics 4.
2. Incolla il Measurement ID e l'API secret.
3. Fai clic su Save, poi su Test connection. Elido invia un evento di prova link_click contrassegnato con elido_test e debug_mode.

Come Elido imposta client_id

GA4 richiede un client_id per attribuire gli eventi a un utente. Elido lo imposta su elido-<workspace_id>-<link_id>, quindi tutti i clic su un link compaiono sotto un unico "utente" sintetico in GA4. Questi eventi non si collegano alle tue sessioni web GA4 esistenti e i conteggi degli utenti unici in GA4 riflettono i link, non le persone.

Evento inviato a GA4

Evento Elido	Nome evento GA4
Clic sul link	link_click

Parametri dell'evento: workspace_id, link_id, slug, country, device, destination.

Risoluzione dei problemi

Nessun evento compare in Realtime - Controlla il Measurement ID e l'API secret. Un API secret errato restituisce HTTP 204 (nessun contenuto), ma GA4 scarta il payload in silenzio. Verifica chiamando direttamente l'endpoint del Measurement Protocol:

curl -X POST \
  "https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'

Una chiamata di debug riuscita restituisce {"validationMessages":[]}.

Gli eventi compaiono in Realtime ma non nei report normali - Gli eventi del Measurement Protocol possono impiegare 24–48 ore per comparire nei report GA4 non in tempo reale. È una limitazione di GA4, non un problema di Elido.