Skip to Content
Elido is in closed beta — APIs are stable but rate-limits and quotas may change before GA. Request access →
HandleidingenConversion forwarding

Conversies doorsturen

Gepland, nog niet beschikbaar; zie roadmap. Er is vandaag geen POST /v1/conversions, geen configuratie-endpoint /conversion-forwarding, geen responseheader X-Elido-Click-Id en geen cookie elido_click_id. Wat er nu wel is: conversies komen binnen via Stripe- en Shopify-webhooks en worden toegeschreven op link_id (zie Conversietracking), en click-ingester stuurt klikgebeurtenissen (geen aankopen) door naar geconfigureerde pixels en integraties zoals GA4, Mixpanel, Meta en TikTok. Server-side doorsturen van aankopen, attribution_model en het tabblad Forwarding hieronder zijn het geplande ontwerp.

Conversietracking vertelt ons dat een klik omzet werd. Conversies doorsturen duwt dat feit terug naar de advertentieplatforms - Meta Conversions API, GA4 Measurement Protocol en Mixpanel server-track - zodat de optimalisatiealgoritmen het zien, ook als de browserpixel niet is afgegaan.

Waarom zou je dit doen? Attributie met alleen een pixel verliest 20-40% van de conversies aan Safari ITP, adblockers en toestemmingsbanners. Server-side doorsturen dicht het grootste deel van die kloof, omdat het vanuit je backend draait nadat de aankoop al heeft plaatsgevonden.

De flow is:

  1. Leg de click_id vast die Elido bij de oorspronkelijke redirect teruggaf.
  2. Bewaar hem bij je order- of abonnementsrecord.
  3. Wanneer de conversie plaatsvindt, POST je hem naar /v1/conversions met de click-ID.
  4. Elido stuurt de gebeurtenis server-naar-server door naar de bestemmingen die je hebt gekoppeld.

1. De click-ID vastleggen

Elke redirectresponse bevat een header X-Elido-Click-Id. De SDK’s maken hem beschikbaar op hetzelfde responseobject; ruwe HTTP werkt ook:

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

Bewaar die ID op de bestemmingspagina, bij voorkeur in een first-party- cookie (elido_click_id, TTL van 90 dagen), zodat je hem bij de checkout weer kunt uitlezen.

2. Je conversie-endpoint koppelen

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"
    }
  }'

Je kunt een willekeurige subset koppelen; ontbrekende platforms worden stilzwijgend overgeslagen.

3. Conversies POSTen

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 is je idempotentiesleutel - dezelfde ID die twee keer wordt ingediend, wordt ontdubbeld, zowel bij Elido als aan de kant van Meta/GA4/Mixpanel. Gebruik het order-ID, het abonnements-ID of een andere stabiele identifier.

Velden met gebruikersidentiteit worden gehasht (SHA-256) voordat ze naar Meta en GA4 worden doorgestuurd. Mixpanel ontvangt alleen de ruwe external_id.

4. Wat er wordt doorgestuurd

BestemmingEndpointGehashtBevat UTM’s
Meta CAPIgraph.facebook.com/v19.0/{pixel}/eventsemail, phoneja (als custom_data)
GA4 MPgoogle-analytics.com/mp/collectclient_id (gehasht)ja (als gebeurtenisparameters)
Mixpanelapi.mixpanel.com/trackneeja (als gebeurteniseigenschappen)

UTM’s worden gehaald uit de klikrij die bij click_id hoort, dus de doorgestuurde gebeurtenis draagt altijd de oorspronkelijke campagnecontext - ook als de gebruiker een uur over de site dwaalde voordat hij afrekende.

5. De rondreis verifiëren

Het tabblad Conversions → Forwarding van het dashboard toont een rij per doorgestuurde gebeurtenis met bestemming, responscode, latentie en de ruwe upstream-payload. Mislukte doorstuurpogingen worden met exponentiële backoff tot 24 uur herhaald.

Stel voor Meta specifiek test_event_code in en controleer of gebeurtenissen in Events Manager → Test Events aankomen voordat je productieverkeer over de streep trekt.

6. Randgevallen

  • Klik niet gevonden - als click_id niet bij een bekende klik past (typfout, verlopen voorbij de retentie, verkeerde workspace), wordt de conversie toch bij de workspace vastgelegd, maar doorgestuurd met lege UTM-context. Nuttig voor catch-all-attributie.
  • Terugbetalingen - POST dezelfde event_id met event_name: "refund". Meta en GA4 behandelen dit als negatieve conversie; Mixpanel legt een aparte gebeurtenis vast die je in je funnels kunt aftrekken.
  • Multi-touch - Elido bewaart tot 30 dagen aan klikken per gebruiker. Standaardattributie is last-touch binnen het venster; stel attribution_model van de workspace in op first_touch of position_based voor alternatieven.

Zie ook

Conversion trackingLifetime value (LTV)