Conectați Google Analytics 4 la Elido

Elido trimite evenimente de conversie către GA4 pe server, folosind Measurement Protocol. Aceasta înseamnă că conversiile apar în GA4 indiferent dacă utilizatorul are un adblocker, fără niciun JavaScript pe pagina dumneavoastră.

De ce aveți nevoie

• O proprietate GA4 (nu Universal Analytics).
• Acces la panoul de administrare al proprietății.
• Aproximativ 5 minute.

Pasul 1 — Găsiți Measurement ID

1. Mergeți la Google Analytics.
2. Faceți clic pe Admin (iconița roată din stânga jos).
3. Sub Property, faceți clic pe Data streams → Web.
4. Faceți clic pe fluxul dumneavoastră de date web.
5. Copiați Measurement ID — începe cu G-, de ex. G-XXXXXXXXXX.

Pasul 2 — Creați o cheie secretă API pentru Measurement Protocol

Pe aceeași pagină a fluxului de date:

1. Derulați în jos la Measurement Protocol API secrets.
2. Faceți clic pe Create.
3. Dați-i un nume („Elido”) și faceți clic pe Create.
4. Copiați valoarea secretă. Este afișată o singură dată. Dacă o pierdeți, creați una nouă — cele vechi continuă să funcționeze până le ștergeți.

Pasul 3 — Configurați în Elido

1. Mergeți la Dashboard → Conversions → GA4 → Set up forwarding.
2. Lipiți Measurement ID și cheia secretă API.
3. Faceți clic pe Save. Elido trimite imediat un eveniment de test (elido_test) către GA4.

Cum mapează Elido client_id

GA4 necesită un client_id pentru a atribui evenimentele unui utilizator. Elido îl derivă astfel:

1. Dacă pagina de destinație a linkului dumneavoastră scurt setează un cookie _ga, iar valoarea este transmisă înapoi prin pixelul dumneavoastră de conversie — Elido îl citește direct.
2. În caz contrar, Elido calculează un hash al click_id-ului Elido (de ex. clk_abc123) într-un șir stabil cu forma unui UUID și îl folosește ca client_id.

Aceasta înseamnă că GA4 va afișa aceste evenimente sub un „utilizator” care poate să nu corespundă sesiunilor web GA4 existente — nu se vor uni. Pentru o unire completă a sesiunilor, transmiteți valoarea cookie-ului _ga către serverul dumneavoastră și includeți-o în apelul API de conversii al Elido.

Numele evenimentelor în GA4

Elido transmite aceste evenimente:

Eveniment Elido	Nume eveniment GA4
conversion.recorded	purchase (cu valoare + monedă)
link.clicked (dacă activat)	elido_click
threshold.exceeded	elido_threshold

Evenimentul purchase este folosit deoarece GA4 are raportare integrată pentru el în secțiunea Monetizare. Toate evenimentele includ utm_source, utm_medium, utm_campaign ca parametri de eveniment.

Depanare

Niciun eveniment nu apare în Realtime — Verificați Measurement ID și cheia secretă API. O cheie secretă API greșită returnează HTTP 204 (fără conținut), dar GA4 renunță silențios la payload. Verificați apelând direct endpoint-ul 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":{}}]}'

Un apel de depanare reușit returnează {"validationMessages":[]}.

Evenimentele apar în Realtime, dar nu în rapoartele obișnuite — Evenimentele Measurement Protocol pot dura 24–48 de ore pentru a apărea în rapoartele GA4 care nu sunt în timp real. Aceasta este o limitare a GA4, nu o problemă a Elido.

Monedă greșită în evenimentele de tip purchase — Elido citește moneda din câmpul currency al evenimentului de conversie. Valoarea implicită este EUR. Setați-o explicit în apelul API de înregistrare a conversiei.

Evenimente duplicate — Dacă site-ul dumneavoastră declanșează și un eveniment purchase GA4 pe partea de client, veți vedea duplicate. Dezactivați evenimentul de pe partea de client sau folosiți un alt nume de eveniment în setările de mapare Elido.