Zahmetsiz postback takibi

Postback, UluMob’a bir ziyaretçinin dönüşüm gerçekleştirdiğini bildiren sunucudan sunucuya bir çağrıdır. CPA kampanyalarını mümkün kılan ve CPM ile CPC kampanyalarında dönüşümlerin maliyetin yanında görünmesini sağlayan budur. Postback sorunlarının çoğu birkaç nedenden kaynaklanır ve hepsi, gerçek para buna bağlanmadan önce bulunabilir.

Click id nasıl yol alır

Tüm sistem tek bir değere dayanır: click id.

1. Bir ziyaretçi reklamınızı görür ve tıklar ya da bir popunder açılır.
2. UluMob bir click id (UUID) oluşturur ve {click_id} yerine bu değeri koyarak ziyaretçiyi hedef URL’nize yönlendirir.
3. Tracker’ınız veya açılış sayfanız click id’yi ziyaretle birlikte saklar.
4. Ziyaretçi dönüşüm gerçekleştirdiğinde sisteminiz aynı click id ile UluMob postback URL’sini çağırır.
5. UluMob tıklamayı bulur, imzayı kontrol eder ve dönüşümü kaydeder. CPA kampanyasında ücretlendirme de bu anda yapılır.

Click id herhangi bir adımda kaybolursa, örneğin bir yönlendirme sorgu parametrelerini düşürdüğü ya da bir form onu taşımadığı için, dönüşüm eşleştirilemez. Tüm yolu bir kez elle kontrol edin: kendi reklamınıza tıklayın, id’nin tracker’a ulaştığını ve dönüşüm adımında hâlâ orada olduğunu doğrulayın.

Bir tıklama varsayılan olarak yedi gün boyunca dönüşüm alabilir. Bundan sonra bildirilen dönüşümler bilinmeyen tıklama olarak reddedilir.

Kimlik doğrulamanın iki yolu: HMAC veya key URL

Her postback sizden geldiğini kanıtlamak zorundadır. Panelde Takip bölümünde gösterilen postback gizli anahtarınız bunu iki yoldan biriyle yapar.

HMAC ile imzalı. click_id, conv_type, payout ve tx_id parametrelerinden oluşan sorgu dizesi üzerinden onaltılık bir HMAC-SHA256 hesaplarsınız. Anahtarlar alfabetik olarak sıralanır ve RFC 3986’ya göre kodlanır, gizli anahtarınız da HMAC anahtarı olarak kullanılır. Sonucu token olarak gönderirsiniz. Gizli anahtar URL’de hiç yer almaz.

/postback?click_id={click_id}&conv_type=A&payout=25.00&tx_id=ORDER-991&token=<hex hmac>

Key URL. Gizli anahtarın kendisini key olarak gönderirsiniz. Tracker’lar her istek için HMAC hesaplayamaz, bu yüzden bir tracker’ın postback alanına yapıştırılacak biçim budur.

/postback?click_id={click_id}&conv_type=A&payout={payout}&tx_id={tx_id}&key=<your secret>

	HMAC token	Key URL
Gizli anahtar URL’de	Hayır	Evet
Kod gerektirir	Evet, sunucunuzda birkaç satır	Hayır
En uygun olduğu yer	Kendi backend’iniz	Tracker’lar

Key URL’yi bir şifre gibi koruyun: tracker’da tutun ve paylaşılan ekran görüntülerinde göstermeyin. Sızarsa gizli anahtarı Takip sayfasından yeniden oluşturun. Eski postback’ler hemen doğrulanmaz hale gelir, bu yüzden anahtarı yeniledikten hemen sonra her tracker’ı güncelleyin.

Tracker şablonları

Takip sayfası Voluum, Keitaro, Binom, RedTrack ve BeMob için hazır postback URL’leri gösterir. Her biri, kampanya URL’niz için bir tıklama parametresini tracker’ın kendi makro adlarını kullanan bir postback ile eşleştirir. UluMob yaygın takma adları kabul eder: click id olarak cid, clickid veya externalid, dönüşüm türü olarak type veya goal, payout olarak amount, sum veya revenue çalışır.

Makro adları tracker tarafında değişebilir. Bu yüzden yayına almadan önce şablonu tracker’ınızın güncel dokümantasyonuyla karşılaştırın. UluMob’un tam listesi makrolar sayfasında, kurulum adımları ise postback kurulumu sayfasında.

Dönüşüm türleri

conv_type tek bir harftir, varsayılanı A’dır. Panelden başka türler ekleyebilirsiniz; örneğin kayıt için A, para yatırma için B ve her birine bir ad verebilirsiniz. Her tür kapatılabilir. Her tür ya tıklama başına bir kez sayılır ya da tekrarlara izin verir; ikincisi tekrarlanan satın almalara uygundur. Bir CPA kampanyası, dönüşüm başına kendi CPA teklifi kadar ücretlendirilir. Gönderdiğiniz payout sizin gelirinizdir, raporlama için kullanılır ve ödediğiniz tutarı değiştirmez.

test=1 ile deneme

Herhangi bir postback’e test=1 ekleyin. UluMob tüm kontrolleri çalıştırır, ardından hiçbir şey kaydetmeden veya ücretlendirmeden ne olacağını yanıt olarak döner. Yanıt, kampanya id’sini ve would_charge değerini, yani gerçek bir çağrının maliyetini içerir. Şu durumlarda kullanın:

1. tracker’ı ilk kurduktan sonra,
2. gizli anahtarı yeniledikten sonra,
3. hedef URL’yi veya tracker kampanyasını değiştirdikten sonra.

Kendi test tıklamanızdan gerçek bir click id alın, postback’i test=1 ile gönderin ve yanıtı okuyun. Test modundaki bir ret kaydedilmez, bu yüzden istediğiniz kadar yeniden deneyebilirsiniz.

Yaygın ret nedenleri

Reddedilen her canlı postback nedeniyle birlikte kaydedilir. Takip sayfası son yedi günün retlerini orijinal sorguyla birlikte listeler; ne yanlış gittiğini görmek için bu genellikle yeterlidir.

Neden	Durum	Ne anlama gelir	Olağan çözüm
bad_signature	403	Token veya key gizli anahtarınızla eşleşmiyor	HMAC’in sıralama ve kodlamasını kontrol edin ya da anahtar yenilendikten sonra key’i güncelleyin
unknown_click	404	Bu id’ye sahip bir tıklama yok ya da atıf süresinden daha eski	Düz {click_id} metninin veya tracker’ın kendi id’sinin değil, gerçek click id’nin iletildiğinden emin olun
inactive_type	422	Dönüşüm türü harfi tanımlı değil veya kapalı	Türü ekleyin ya da etkinleştirin veya doğru harfi gönderin
duplicate	200, yok sayıldı	Bu tıklama bu tür için zaten dönüşüm sağlamış ve tekrarlar kapalı	Yeniden denemelerde beklenen durumdur; tür birden fazla kez sayılmalıysa tekrarlara izin verin
budget	402	Bütçe veya bakiye tükendiği için CPA ücreti alınamadı	Bakiye yükleyin veya bütçeyi artırın; tracker ardından aynı postback’i yeniden deneyebilir
rate_limited	429	Kısa sürede tek bir IP’den çok fazla postback geldi	Yeniden deneme döngüsünü yavaşlatın ve Retry-After başlığına uyun

Bunlardan ikisi daha yakından bakmayı hak ediyor. duplicate alışılmış anlamda bir hata değildir: tracker’lar sık sık yeniden dener ve ikinci çağrının yok sayılması sizi iki kez ücretlendirilmekten korur. budget reddi ise tekrar olarak işaretlenmez; bakiye geri geldiğinde aynı postback işlenebilir.

Yayına almadan önce kontrol listesi

• Hedef URL {click_id} içeriyor ve bir test tıklaması tracker’da gerçek id’yi gösteriyor
• Postback URL’si güncel gizli anahtarınızı HMAC veya key olarak kullanıyor
• Dönüşüm türü harfi tanımlı ve etkin
• Bir test=1 çağrısı beklenen kampanya id’siyle ok döndürüyor
• Reddedilen postback’leri nerede bulacağınızı biliyorsunuz

Bunlar tamamlandığında dönüşümler dakikalar içinde raporlarınızda görünür. Postback gizli anahtarınızı almak için hesap oluşturun.