Redirecționarea conversiilor

Planificat, încă indisponibil; vezi roadmap-ul. Astăzi nu există POST /v1/conversions, niciun endpoint de configurare /conversion-forwarding, niciun header de răspuns X-Elido-Click-Id și niciun cookie elido_click_id. Ce există acum: conversiile sosesc din webhook-urile Stripe și Shopify și sunt atribuite după link_id (vezi Urmărirea conversiilor), iar click-ingester trimite evenimente de click (nu achiziții) către pixelii și integrările configurate, precum GA4, Mixpanel, Meta și TikTok. Trimiterea server-side a achizițiilor, attribution_model și fila Forwarding descrise mai jos reprezintă designul planificat.

Urmărirea conversiilor ne spune nouă că un click s-a transformat în venit. Redirecționarea conversiilor trimite acel fapt înapoi spre platformele de publicitate - Meta Conversions API, GA4 Measurement Protocol și Mixpanel server-track - astfel încât algoritmii de optimizare îl văd chiar și atunci când pixelul din browser nu s-a declanșat.

De ce să te complici? Atribuirea doar prin pixel pierde 20-40% din conversii din cauza Safari ITP, adblockerelor și bannerelor de consimțământ. Trimiterea server-side închide cea mai mare parte din acest decalaj, fiindcă rulează din backendul tău după ce achiziția s-a produs deja.

Fluxul este:

Capturează click_id returnat de Elido la redirecționarea inițială.
Păstrează-l în înregistrarea comenzii / abonamentului.
Când se produce conversia, trimite-l prin POST la /v1/conversions cu click ID-ul.
Elido retransmite evenimentul de la server la server către destinațiile pe care le-ai conectat.

1. Capturează click ID-ul

Fiecare răspuns de redirecționare poartă un header X-Elido-Click-Id. SDK-urile îl expun pe același obiect de răspuns; HTTP brut funcționează și el:


curl -sI https://elido.me/launch | grep -i click-id
# X-Elido-Click-Id: clk_01HYZ7T8WV6KQX3M

Păstrează acel ID pe pagina de destinație, ideal într-un cookie first-party (elido_click_id, TTL de 90 de zile), ca să îl poți citi din nou la checkout.

2. Conectează endpoint-ul de conversii


curl -X PUT \
  https://api.elido.app/v1/workspaces/1/conversion-forwarding \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "meta_capi": {
      "pixel_id": "1234567890",
      "access_token": "EAA…",
      "test_event_code": null
    },
    "ga4_mp": {
      "measurement_id": "G-ABC123",
      "api_secret": "abc_def_ghi"
    },
    "mixpanel": {
      "project_token": "pm_…",
      "service_account": "sa@team.mixpanel.com"
    }
  }'

Poți conecta orice subset; platformele lipsă sunt omise în tăcere.

3. Trimite conversiile prin POST


curl -X POST \
  https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id":   "clk_01HYZ7T8WV6KQX3M",
    "event_name": "purchase",
    "event_id":   "ord_98231",
    "value":      89.00,
    "currency":   "EUR",
    "user": {
      "email":  "shopper@example.com",
      "phone":  "+4915123456789",
      "external_id": "cust_5128"
    }
  }'

event_id este cheia ta de idempotență - același ID trimis de două ori este deduplicat, atât la Elido, cât și de partea Meta/GA4/Mixpanel. Folosește ID-ul comenzii, ID-ul abonamentului sau orice alt identificator stabil.

Câmpurile de identitate ale utilizatorului sunt hash-uite (SHA-256) înainte de a fi trimise către Meta și GA4. Mixpanel primește doar external_id în formă brută.

4. Ce se trimite

Destinație	Endpoint	Hash-uit	Include UTM-uri
Meta CAPI	`graph.facebook.com/v19.0/{pixel}/events`	email, phone	da (ca `custom_data`)
GA4 MP	`google-analytics.com/mp/collect`	client_id (hash-uit)	da (ca parametri de eveniment)
Mixpanel	`api.mixpanel.com/track`	nu	da (ca proprietăți de eveniment)

UTM-urile sunt preluate din rândul de click care se potrivește cu click_id, deci evenimentul trimis poartă mereu contextul inițial al campaniei - chiar dacă utilizatorul a hoinărit o oră pe site înainte de a finaliza comanda.

5. Verifică circuitul complet

Fila Conversions → Forwarding din dashboard arată un rând pe fiecare eveniment trimis, cu destinația, codul de răspuns, latența și payload-ul upstream brut. Trimiterile eșuate se reîncearcă cu backoff exponențial timp de până la 24 de ore.

Pentru Meta în special, setează test_event_code și confirmă că evenimentele ajung în Events Manager → Test Events înainte de a trece traficul de producție.

6. Cazuri limită

Click negăsit - dacă click_id nu se potrivește cu un click cunoscut (greșeală de scriere, expirat peste retenție, workspace greșit), conversia este totuși înregistrată pe workspace, dar trimisă cu context UTM gol. Util pentru atribuire de tip catch-all.
Rambursări - trimite prin POST același event_id cu event_name: "refund". Meta și GA4 o tratează ca pe o conversie negativă; Mixpanel înregistrează un eveniment separat pe care îl poți scădea în funnel-urile tale.
Multi-touch - Elido păstrează până la 30 de zile de click-uri per utilizator. Atribuirea implicită este last-touch în fereastră; setează attribution_model pe workspace la first_touch sau position_based pentru alternative.

Vezi și

Urmărirea conversiilor - partea de intrare (webhook-uri Stripe / Shopify)
Șabloane UTM - ce se atașează efectiv evenimentului trimis
Webhook-uri - sistemul mai larg de pixeli