Connetti Google Analytics 4 a Elido

Elido invia eventi di conversione a GA4 lato server usando il Measurement Protocol. Ciò significa che le conversioni appaiono in 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).
• Accesso al pannello Admin della proprietà.
• Circa 5 minuti.

Step 1 — Trova il tuo Measurement ID#

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

Step 2 — Crea un API secret del Measurement Protocol#

Nella stessa pagina del data stream:

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.

Step 3 — Configura in Elido#

1. Vai su Dashboard → Conversioni → GA4 → Configura inoltro.
2. Incolla il Measurement ID e l'API secret.
3. Fai clic su Salva. Elido invia immediatamente un evento di test (elido_test) a GA4.

Come Elido mappa client_id#

GA4 richiede un client_id per attribuire gli eventi a un utente. Elido lo deriva da:

1. Se la tua pagina di destinazione imposta un cookie _ga e il valore viene restituito tramite il tuo pixel di conversione — Elido lo legge direttamente.
2. Altrimenti, Elido hash il click_id Elido (es. clk_abc123) in una stringa a forma di UUID stabile e la usa come client_id.

Ciò significa che GA4 mostrerà questi eventi sotto un "utente" che potrebbe non corrispondere alle tue sessioni web GA4 esistenti — non si uniranno. Per un completo stitching di sessione, passa il valore del cookie _ga al tuo server e includilo nella chiamata API Conversioni di Elido.

Nomi degli eventi in GA4#

Elido inoltra questi eventi:

Evento Elido	Nome evento GA4
conversion.recorded	purchase (con valore + valuta)
link.clicked (se abilitato)	elido_click
threshold.exceeded	elido_threshold

L'evento purchase viene usato perché GA4 ha report integrati per esso nella sezione Monetizzazione. Tutti gli eventi includono utm_source, utm_medium, utm_campaign come parametri dell'evento.

Risoluzione dei problemi#

Nessun evento appare in Realtime — Controlla il Measurement ID e l'API secret. Un API secret errato restituisce HTTP 204 (nessun contenuto) ma GA4 scarta silenziosamente il payload. 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 appaiono in Realtime ma non nei report regolari — Gli eventi del Measurement Protocol possono richiedere 24–48 ore per apparire nei report GA4 non in tempo reale. Questa è una limitazione di GA4, non di Elido.

Valuta sbagliata negli eventi di acquisto — Elido legge la valuta dal campo currency dell'evento di conversione. Il default è EUR. Impostala esplicitamente nella tua chiamata API di registrazione conversione.

Eventi duplicati — Se il tuo sito invia anche un evento GA4 purchase lato client, vedrai duplicati. Disabilita l'evento lato client o usa un nome evento diverso nelle impostazioni di mapping di Elido.