Postbackler nedir?

Postback, kullanıcı bir hareket gerçekleştirdiğinde sistemimizden (Affiliate TOP) performansınızı görüntüleme aracına (ör. Keitaro, Voluum, RedTrack) veya CRM’ye gönderilen otomatik bir HTTP talebidir: kayıt, yatırım, para çekimi, uygulamanın yüklenmesi, işlem yapma, vs.

Postbacklerle tüm dönüşüm verileri herhangi bir manual efor olmadan izleme aracınıza gelir.

Postbackler aşağıdakileri yapmanıza olanak verir:

• Trafiği gerçek zamanlı analiz etmenize

• Kampanya sonuçlarını geliştirmek ve kârı artırmak için hızla reklam ve stratejilerinizi düzenlemenize

• Kârlı paketleri ve trafik kaynaklarını daha hızlı bulmanıza ve ölçeklendirmenize

Posback URL’si nedir

Postback URL’si sistemimizin dönüşüm verilerini gönderdiği özel bir bağlantıdır. “Hücreler” denilen ve olay sırasında değerlerle dolan parametreler içerir: tıklama ID’si, yatırım tutarı, yatırımcı ID’si, kampanya ID’si, vs. Olay gerçekleştiğinde sistemimiz otomatik olarak bu URL’ye veriyle talep gönderir.

Postback URL’si nerede bulunur?

Postback URL’sini performan görüntüleme aracınızdan veya CRM’den (Keitaro, Voluum, RedTrack, vs.) alabilirsiniz. Dökümantasyonlarına veya postback / S2S izleme kurulumu altındaki arayüze göz atın.

En iyi 3 izleyiciden Postback URL’si örnekleri

Postback URL’lerinin genelde nasıl göründüklerini öğrenin ve parametre eklemeye alışın.

Keitaro

Postback URL’si örneği: http://your-keitaro.com/postback?clickid={click_id}&status=approved&payout={sumdep}

clickid parametre adı Keitaro dökümantasyonundan gelir
{click_id}, {sumdep} yer tutucumuzdur

Voluum

Postback URL’si örneği: https://your-voluum.com/postback?cid={click_id}&payout={sumdep}

cid parametre adı Voluum izleyicisi için standard Click ID’si adıdır
{click_id}, {sumdep} yer tutucumuzdur

RedTrack

Postback URL’si örneği:

https://your-redtrack.com/postback?clickid={click_id}&revenue={sumdep}&status=approved

clickid ve revenue parametre adları RedTrack dökümantasyonundan gelir
{click_id}, {sumdep} yer tutucumuzdur

Önemli: Parameter adları (clickid, cid, revenue) izleyicinizin gereklilikleriyle tam olarak eşleşmelidir. Küme parantezindeki yer tutucular ({click_id}, {sumdep}) bizimdir.

Postback URL’si ve Parametreler Nasıl Çalışır

Her parametre iki parçadan oluşur:

parametre adı – izleyici / CRM’nizin ne beklediği (dökümantasyonlarından alınır)
cküme parantezinde yer tutucumuz – bizim otomatik olarak yerleştirdiğimiz şeydir.

Örnek – visitor_id={click_id}

Burada:

visitor_id – izleyici dökümantasyonundan parametre adı. Olduğu gibi gönderilir. İzleyiciniz veriyi tam olarak bu adın altında bekler
{click_id} – yer tutucumuzdur. Olay sırasında gerçek Tıklama ID’siyle değiştirilir.

Sol taraf (visitor_id, campaign_id, sub_id) – izleyici gereklilikleri.
Sağ taraf ({click_id}, {campaign_id}) – AffiliateTop verisi.

Postback URL’si ve Parametre Adları Nereden Alınır

Performans görüntüleme aracınıza giriş yapın (izleyici veya CRM)
Postback / Server-to-Server (S2S) tracking bölümünü bulun
Arayüz veya dökümantasyondan ana Postback URL’sini ve parameter adlarını kopyalayın
URL’yi ayarlarımıza yapıştırın ve yer tutucularımızı ekleyin: visitor_id={click_id}, amount={sumdep}, vs.

Tam Postback URL Yapısı Örneği

Olaydan önce (yer tutucularla) – https://your-tracker.com/postback?visitor_id={click_id}&site_id={site_id}&trader={trader_id}&amount={deposit_amount}&campaign_id={campaign_id}

Olaydan sonra (gerçek değerlerle) – https://your-tracker.com/postback?visitor_id=1234567&site_id=4458&trader=902134&amount=23.22&campaign_id=YT_BR_01

Postback Parametreleri: Formatları, Örnekler ve Amaçları

1. Tıklama ID’si

Yer tutucumuz: {click_id}
İzleyici URL’sinde: visitor_id={click_id} → visitor_id=1234567
Amacı: Dönüşümü belli reklam tıklamasına bağlar. İzleyici hangi trafik kaynağının dönüştürüldüğünü bilir
Anlamı: Tıklama gerçekleştiğinde izleyicinizden özel bir tıklama numarası alınır

2. Site ID’si

Yer tutucumuz: {site_id}
URL’de: site_id={site_id} → site_id=4458
Amacı: Hangi sitenin / yerleştirmenin trafik dönüştürme yaptığını gösterir. Trafik satın alımlarını optimize etmeye yardımcı olur
Anlamı: Web sitesinin veya yerleştirmenin reklam ağınızdaki ID’si

3. Trader ID’si

Yer tutucumuz: {trader_id}
URL’de: trader={trader_id} → trader=902134
Amacı: Bir kullanıcının tüm hareketlerini (birden çok hesap, yatırım, işlem) birleştirilmiş istatistiklere bağlar
Anlamı: İlk kayıt ile birlikte kalıcı yatırımcı tanımlayıcısı çıkarılır

4. Hesap ID’niz

Yer tutucumuz: {a}
URL’de: account={a} → account=a182haj2nn
Amacı: Ortaklık bağlantınızı tanımlar. Birden çok hesap yönetiliyorsa kullanışlıdır
Anlamı: Ortak referans kodunuzdur. Genellikle her ortağa bir tane verilir.

5. Yatırım tutarı

Yer tutucumuz: {sumdep}
URL’de: amount={sumdep} → amount=23.22
Amacı: Tam yatırım tutarlarını gösterir (ilk veya tekrarlanan). ROI hesaplaması ve LTV analizi içindir
Anlamı: Seçilen para biriminde yatırım tutarı ($ veya ¢). Sadece FTD veya Yeniden yatırım gibi yatırım olaylarında çıkar

6. İşlem ID’si

Yer tutucumuz: {transaction}
URL’de: tx_id={transaction} → tx_id=81283192873
Amacı: Her dönüşümü özel olarak tanımlar. Çiftleri önler ve isabetli nitelemeyi etkinleştirir
Anlamı: Belli bir olayın dahili ID’si (yatırım, para çekimi, vs.)

7. Reklam kampanyası ID’si

Yer tutucumuz: {ac}
URL’de: campaign_id={ac} → campaign_id=YT_BR_01
Amacı: Farklı kampanyalardaki istatistikleri ayırır (coğrafi, yaratıcı ögeler, iniş)
Anlamı: Yönlendirme bağlantısından reklam kampanyanızın adı veya ID’si

8. Alt hesap postback ID’si

Yer tutucumuz: {sa}
URL’de: sub_id={sa} → sub_id=teaser_01
Amacı: Ek analitikleriniz (trafik türü, yaratıcı öge, webmaster)
Anlamı: Yönlendirme bağlantınızden gelen herhangi bir değer (sub1, sub2, vs.)

9. Kâr

Yer tutucumuz: {profit}
URL’de: profit={profit} → profit=15.75
Amacı: Gerçek işlemler için işlemlerin kâr/zarar tutarını gösterir. Gelir izleme ve performans analizi için önemlidir.
Anlamı: Kullanıcının gerçek işlem aktivitesinden net kâr (pozitif veya negatif). Gerçek işlem olaylarında mevcuttur

Postbackler için Tetikleyici Olaylar

Affiliate TOP aşağıdaki listelenen kullanıcı hareketleri için postbackleri destekler. Bir postback = bir olay. Hangi olayı izlemek istediğinize karar verin ve Postback URL’nize eklemek için gereken parametreyi yazın veya tıklayın.

Kayıt – kullanıcı hesap kaydını tamamlar
Eposta onayı – kullanıcı eposta adresini doğrular
İlk yatırım (FTD) – kullanıcının ilk yatırımı
Yeniden yatırım – sonraki yatırımlar (tekrar yatırımlar)
Uygulama yüklendi – kullanıcı mobil uygulamayı yükler
İlk demo işlemi – kullanıcının demo hesabındaki ilk işlemi
Para çekimi – kullanıcı para çekimini tamamlar
Gerçek işlem – kullanıcı gerçek işlem hesabında işlem gerçekleştirir

Her olay yukarıda değinilen kendi mevcut parametreler setini taşır.

Postback nasıl kurulur (Arayüz Rehberi)

Postback kurulum sürecine başlamak için “Ekle”ye tıklayın ve tercihleriniz doğrultusunda gerekli alanları doldurun

Postback adı – karışmasını önlemek için her postbackinize net ve özel bir isim girin (ör., "FTD_YT_BR")
Olay – açılır menüden seçin (Kayıt, ilk yatırım, vs.)
Postback URL’si – izleyicinizden URL’yi yapıştırın (yukarıdaki örneklere göz atın)
Parametreler – otomatik olarak parametre eklemek için ”Postback URL’si” alanı altındaki mavi ön ayarlara tıklayın ("Tıklama ID’si”, “Yatırım tutarı”)
Yöntem – AL (varsayılan olarak)
Para birimi – tutarlar için $ veya ¢’i seçin

7. Bölme filtreleri

Bu ayar, postbackin hangi kampanya veya alt hesap ile ilişkili olduğuna bağlı olarak ne zaman gönderileceğine karar vermenize olanak verir. Bu alanların birini veya her ikisini de doldurabilirsiniz.

Neden bölme filtreleri kullanılır?

Trafiği daha isabetli şekilde yönetmenize yardımcı olur:

Farklı trafik kaynaklarını bağımsız olarak optimize edin – birden fazla performans görüntüleme aracı kullanıyorsanız, temel olayları birine ve ekstra parametreli olayları diğerine gönderebilirsiniz.
A/B testleri gerçekleştirin – bölme, hangi kaynakların daha fazla dönüşüm getirdiğini ve farklı kampanya, yaratıcı ögeler veya açılış sayfalarının nasıl performans gösterdiğini görmenize yardımcı olur.
Araçları güvenli şekilde test edin veya taşıyın – tamamen geçiş yapmadan önce eski performans görüntüleme aracına paralel şekilde yenisine postbackler göndermeye başlayabilir ve sayıları karşılaştırabilirsiniz.

Sistem postbackin ne zaman gönderileceğine nasıl karar verir:

Ne kampanya ne de alt hesap belirtilmediyse
Postback, kampanya veya alt hesap farketmeksizin seçilen tetikleyen olay için gönderilir.
Sadece kampanya belirtildiyse
Postback yalnızca yatırımcının izleme bağlantısı bu spesifik kampanyayı içeriyorsa tetikleyen olay için gönderilir.
Sadece alt hesap belirtildiyse
Postback, hangi kampanyaya ait olduğu farketmeksizin yalnızca yatırımcının izleme bağlantısı bu spesifik alt hesabı içeriyorsa gönderilir.
Hem kampanya hem de alt hesap belirtildiyse
Postback yalnızca yatırımcının bağlantısındaki her iki değer girdiğiniz kampanya ve alt hesapla eşleşiyorsa gönderilir.

(Etkinleştirme notu: postback etkinleştirildikten sonra, seçilen olay ve koşullar sağlandığında 15 saniye içinde gönderilir.)

8. Gerekli olanları etkinleştirin ve "Ekle"ye tıklayın

Postback Durumları

Postbackler yaşamları boyunca çeşitli durumlardan geçerler. İşte bu durumların her biri ne anlama gelir ve durum değişikliklerini ne tetikler:

Kontrol ediliyor (~15 saniye) – ilk oluşturulduğunda, düzenlendiğinde veya kopyalandığında herhangi bir sorun olup olmadığını kontrol etmek için postbackinizi inceleriz
- Postback doğruysa → Aktif hale gelir
- Hatalar varsa → postback İnaktif duruma geçer ve arayüzde hata mesajı gösterilir.
- Postback düzenlenemez veya duraklatılamaz – sadece silinebilir
Aktif – postback doğru şekilde çalışır ve veri toplar
- Düzenlendiyse → geçici olarak Kontrol ediliyor durumuna döner.
- 10 art arda 3xx/4xx HTTP hatası alırsa → otomatik olarak devre dışı kalır, arayüzde hata gösterilir ve eposta bildirimi gönderilir
İnaktif – postback başarısız doğrulama, manual deaktivasyon ve hata eşiğine ulaşıldığından dolayı devre dışı kalmıştır. Tekrar Aktif hale gelmesi için düzeltilmesi ve yeniden doğrulanması gerekir.

Temel hareketler:

10 başarısız doğrulama girişiminden sonra etkinleştirme yönetici yardımı gerektirir
Aktif postbackler kendilerini görüntüler ve sürekli gönderim hatalarına karşı koruma sağlarlar

Postback Kayıtları

Burada son 30 günde yapılan tüm postbackleri bulabilirsiniz. Bu, kurulum sorunlarını tespit etmenize ve neyin tamir edilmesi gerektiğini anlamanıza yardımcı olur. Örneğin

Olası hataların listesi:

Postbackler başarısız olduğunda durum kodu için Kayıtlar bölümünü kontrol edin.

3xx hatası – Yeniden yönlendirme hataları

Sunucunun söylediği: "Bunun yerine şu diğer adrese gidin.”

Sonuç: Postbackiniz başka bir yere gönderilir.

Ana nedenleri:

- Postback URL’si otomatik olarak yeniden yönlendirilir (HTTP→HTTPS, www/non-www, izleme bağlantıları)

- Sunucu veya izleyici talepleri başka adrese yönlendirir

- Sunucunuz süreçte gizlice URL’yi değiştirir

Nasıl düzeltilir?

1. Postback URL’nizi kopyalayın

2. Tarayıcı adres çubuğuna yapıştırın ve Enter’a basın

3. Yüklenmesini bekleyin (veya yeniden yönlendirmeyi durdurmasını)

4. Şimdi adres çubuğunda gördüğünüzü kopyalayın — bu postback URL’nizdir

4xx hatası – İstemci hataları

Sunucunun söylediği: "Talebinizde yanlış bir şeyler var”.

Sonuç: Genellikle sorun kurulumdadır.

Ana nedenleri:

- 404: Postback URL mevcut değildir (bağlantı, alan veya parametrelerde yazım hatası)

- 400/422: Eksik veya geçersiz parametreler (clickid, durum, tutar)

- 403/401: Sunucu talebi bloklar (güvenlik duvarı, IP beyaz listesi, yetkilendirme gerekli)

Nasıl düzeltilir?

Tam postback URL’nizi kopyalayın (clickid gibi tüm parametrelerle)
Sunucu kurulumunuzda karakter karakter kontrol edin
Tarayıcıda açmayı deneyin — “sayfa bulunamadı” gösteriyor mu?
Yanlış bölümü düzeltin (alan, bağlantı veya eksik bilgi) ve güncelleyin