Urmărirea conversiilor

Elido urmărește două lucruri pentru un link scurt: click-ul (când cineva accesează linkul) și conversia (când aceeași persoană efectuează ulterior o acțiune valoroasă pe site-ul tău). Urmărirea conversiilor le conectează pe cele două, astfel încât să vezi nu doar ce linkuri aduc trafic, ci și care dintre ele aduc rezultate.

Ce se consideră o conversie

O conversie este orice eveniment pe care îl definești — o achiziție, o înregistrare, o trimitere de formular, un început de perioadă de probă (trial). Elido nu impune o definiție specifică. Trimiți un eveniment de conversie când acțiunea are loc; noi îl atribuim înapoi click-ului care a adus utilizatorul.

Dashboard-ul de conversii de la Analytics → Conversions arată:

• Numărul total de conversii și venitul total atribuit.
• Conversii defalcate pe link, campanie, zi și platformă.
• Un tabel cu evenimentele de conversie individuale recente, cu adresa de e-mail a clientului și venitul asociat.

Configurează un eveniment de conversie

Opțiunea 1: apel API server-side

Cea mai fiabilă metodă. Când un utilizator finalizează o acțiune pe backend-ul tău, trimite un POST către endpoint-ul de conversii:

curl -X POST https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 42,
    "platform": "stripe",
    "customer_email": "[email protected]",
    "revenue_cents": 4900,
    "currency": "EUR",
    "converted_at": "2026-05-12T14:30:00Z"
  }'

Include customer_email sau click_id pentru atribuire. Dacă transmiți un click_id (returnat în header-ele răspunsului de redirecționare ca X-Elido-Click-ID), atribuirea este exactă. Dacă transmiți doar customer_email, îl potrivim cu ultimul click de la acea adresă din cadrul ferestrei de atribuire.

Opțiunea 2: pixel client-side

Adaugă pixelul Elido pe pagina ta de confirmare (confirmare comandă, succes înregistrare etc.):

<script>
  window.elidoConvert =
    window.elidoConvert ||
    function (opts) {
      fetch("https://api.elido.app/v1/conversions/pixel", {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({
          workspace_id: opts.workspaceId,
          platform: opts.platform || "web",
          revenue_cents: opts.revenueCents || 0,
          currency: opts.currency || "EUR",
        }),
        credentials: "include",
      });
    };
</script>

Apoi apelează-l pe pagina de confirmare:

<script>
  elidoConvert({
    workspaceId: 42,
    platform: "web",
    revenueCents: 4900,
    currency: "EUR",
  });
</script>

Pixelul folosește un cookie de browser setat în timpul redirecționării, pentru a identifica click-ul care a precedat conversia. Acest lucru funcționează pentru parcursuri în același browser, pe același dispozitiv. Pentru atribuirea cross-device sau cross-browser, metoda server-side cu click_id este mai fiabilă.

Ferestre de atribuire

În mod implicit, o conversie este atribuită celui mai recent click de la același utilizator, în cadrul unei ferestre de 30 de zile. Dacă același utilizator a accesat mai multe linkuri în acea perioadă, conversia este atribuită ultimului click (atribuire last-touch).

Fereastra este configurabilă per workspace, din Settings → Attribution. Opțiunile disponibile includ 1 zi, 7 zile, 30 de zile și 90 de zile.

Cum citești dashboard-ul de conversii

Analytics → Conversions defalcă conversiile după:

• Platform — câmpul platform pe care îl transmiți în apelul API (stripe, shopify, web sau orice etichetă alegi).
• Top links — ce linkuri scurte au adus cele mai multe conversii.
• Top campaigns — ce campanii au convertit cel mai bine.
• Daily revenue — un grafic cu bare al venitului atribuit în timp.

Venitul este afișat ca suma valorilor revenue_cents pe care le-ai transmis. Dacă nu urmărești venitul (de exemplu, pentru generarea de lead-uri), poți lăsa revenue_cents la 0 și te poți baza doar pe numărul de conversii.

Depanare

Conversiile nu apar. Verifică răspunsul API pentru apelul tău POST /v1/conversions — endpoint-ul returnează ID-ul conversiei în caz de succes și un mesaj de eroare detaliat în caz de eșec. Probleme comune: lipsa ID-ului de workspace, cod de monedă invalid (trebuie să fie ISO 4217, de exemplu EUR, nu €), sau o cheie API fără permisiunea conversions:write.

Atribuirea nu se potrivește cu click-urile așteptate. Dacă folosești pixelul (bazat pe cookie), verifică dacă browserul utilizatorului nu blochează cookie-urile terțe. ITP-ul Safari și unele blocante de reclame vor șterge cookie-ul înainte ca pagina de conversie să se declanșeze. Folosește metoda server-side cu click_id pentru o atribuire fiabilă.

Cifrele de venit nu se potrivesc cu procesatorul meu de plăți. Cifrele din Elido sunt exact ceea ce ne trimiți — nu preluăm date direct de la Stripe sau de la orice alt procesator. Dacă există o discrepanță, compară valorile revenue_cents din apelurile tale API de conversie cu înregistrările tale de plată.

O conversie apare sub linkul greșit. Atribuirea folosește implicit last-touch. Dacă un utilizator a accesat mai multe linkuri înainte de a converti, conversia merge la cel mai recent click. Dacă ultimul click a provenit dintr-o campanie diferită, acesta este comportamentul așteptat. Ajustează fereastra de atribuire sau treci la atribuirea first-touch din setări, dacă last-touch nu corespunde nevoilor tale de raportare.