Dönüşüm iletimi

Planlandı. Henüz kullanılamaz; yol haritasına bakın. Bugün POST /v1/conversions, /conversion-forwarding yapılandırma uç noktası, X-Elido-Click-Id yanıt başlığı ve elido_click_id çerezi yoktur. Şu anda olanlar: dönüşümler Stripe ve Shopify webhook’larından gelir ve link_id ile atfedilir (Dönüşüm izleme’ye bakın); click-ingester ise yapılandırılmış piksellere ve GA4, Mixpanel, Meta ve TikTok gibi entegrasyonlara tıklama olaylarını (satın almaları değil) iletir. Sunucu taraflı satın alma iletimi, attribution_model ve aşağıda anlatılan Forwarding sekmesi planlanan tasarımdır.

Dönüşüm izleme bize bir tıklamanın gelire dönüştüğünü söyler. Dönüşüm iletimi bu bilgiyi reklam yüzeylerine (Meta Conversions API, GA4 Measurement Protocol ve Mixpanel sunucu izleme) geri iter; böylece tarayıcı pikseli tetiklenmemiş olsa bile optimizasyon algoritmaları bunu görür.

Neden uğraşmalı? Yalnızca piksele dayalı ilişkilendirme, dönüşümlerin %20-40’ını Safari ITP’ye, reklam engelleyicilere ve onay bantlarına kaptırır. Sunucu taraflı iletim, satın alma zaten gerçekleştikten sonra arka ucunuzdan çalıştığı için bu açığın çoğunu kapatır.

Akış şöyledir:

1. Elido’nun ilk yönlendirmede döndürdüğü click_id’yi yakalayın.
2. Onu sipariş / abonelik kaydınızda saklayın.
3. Dönüşüm gerçekleştiğinde tıklama kimliğiyle birlikte /v1/conversions adresine POST edin.
4. Elido olayı, bağladığınız hedeflere sunucudan sunucuya yansıtır.

1. Tıklama kimliğini yakalayın

Her yönlendirme yanıtı bir X-Elido-Click-Id başlığı taşır. SDK’lar bunu aynı yanıt nesnesinde sunar; ham HTTP de çalışır:

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

Bu kimliği hedef sayfada, ödeme sırasında geri okuyabilmeniz için tercihen birinci taraf bir çerezde (elido_click_id, 90 gün TTL) saklayın.

2. Dönüşüm uç noktanızı bağlayın

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

Herhangi bir alt kümeyi bağlayabilirsiniz; eksik yüzeyler sessizce atlanır.

3. Dönüşümleri POST edin

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 sizin idempotency anahtarınızdır: aynı kimlik iki kez gönderilirse hem Elido’da hem de Meta/GA4/Mixpanel tarafında tekilleştirilir. Sipariş kimliğini, abonelik kimliğini veya herhangi bir kararlı tanımlayıcıyı kullanın.

Kullanıcı kimliği alanları Meta ve GA4’e iletilmeden önce hash’lenir (SHA-256). Mixpanel yalnızca ham external_id’yi alır.

4. Neler iletilir

UTM’ler click_id ile eşleşen tıklama satırından alınır; böylece kullanıcı ödemeden önce sitede bir saat dolaşmış olsa bile iletilen olay her zaman özgün kampanya bağlamını taşır.

5. Gidiş-dönüşü doğrulayın

Panonun Conversions → Forwarding sekmesi, iletilen her olay için hedefi, yanıt kodunu, gecikmeyi ve ham üst akış yükünü içeren bir satır gösterir. Başarısız iletimler 24 saate kadar üstel geri çekilmeyle yeniden denenir.

Özellikle Meta için, canlı trafiğe geçmeden önce test_event_code ayarlayın ve olayların Events Manager → Test Events altına düştüğünü doğrulayın.

6. Uç durumlar

• Tıklama eşleşmemesi: click_id bilinen bir tıklamayla eşleşmezse (yazım hatası, saklama süresini aşmış, yanlış çalışma alanı) dönüşüm yine de çalışma alanı adına kaydedilir ancak boş UTM bağlamıyla iletilir. Kapsayıcı ilişkilendirme için kullanışlıdır.
• İadeler: Aynı event_id’yi event_name: "refund" ile POST edin. Meta ve GA4 bunu negatif dönüşüm olarak ele alır; Mixpanel, hunilerinizde çıkarabileceğiniz ayrı bir olay kaydeder.
• Çoklu temas: Elido kullanıcı başına 30 güne kadar tıklama saklar. Varsayılan ilişkilendirme, pencere içindeki son temastır; alternatifler için çalışma alanında attribution_model değerini first_touch veya position_based yapın.

Ayrıca bakın

• Dönüşüm izleme: gelen taraf (Stripe / Shopify webhook’ları)
• UTM şablonları: iletilen olaya gerçekte eklenenler
• Webhook’lar: daha geniş piksel sistemi