Postback kurulumu

Postback, bir ziyaretçi dönüşüm gerçekleştirdiğinde tracker'ınızın veya arka uç sisteminizin yaptığı sunucudan sunucuya bir çağrıdır. UluMob tıklama ID'sini taşır; böylece dönüşüm, ziyaretçiyi gönderen kampanya, reklam, reklam alanı ve sub-ID ile eşleştirilir.

Adım 1: Tıklama ID'sini aktarın

Her reklamın hedef URL'sine {click_id} ekleyin. UluMob bunu her tıklama veya açılış için benzersiz bir ID ile değiştirir.

https://tracker.example/c?cid={click_id}&zone={zone_id}

{tracking} ve {cid} aynı değerin takma adlarıdır. Bkz. makro listesi.

Adım 2: Postback URL'sini çağırın

Takip bilgileriniz /app/advertiser/tracking adresindedir. Postback uç noktası, çağrının sizden geldiğini kanıtlamak için iki yol kabul eder.

Token ile imzalı (önerilen yol; platformda anahtarlı URL'ler kapalıysa tek yol):

https://ulumob.com/postback?click_id=CLICK_ID&conv_type=A&payout=25.00&tx_id=ORDER-991&token=HMAC

Anahtarınızla sabit URL (her çağrıyı imzalayamayan tracker'lar için):

https://ulumob.com/postback?click_id=CLICK_ID&conv_type=A&payout=25.00&tx_id=ORDER-991&key=YOUR_SECRET

Paneldeki Tracker'lar için sabit URL gizli anahtarınızı zaten içerir. Onu bir sunucu kaydında, bir proxy'nin erişim kaydında veya bir ekran görüntüsünde gören herkes sizin adınıza dönüşüm gönderebilir: kodunuzun veya tracker'ınızın hesaplayabildiği her yerde imzalı biçimi tercih edin, anahtarlı URL'yi gizli tutun ve sızarsa anahtarı yenileyin. UluMob, reddedilen postback listesinde key değerini asla saklamaz. Bir platform anahtarlı URL'leri kapatabilir; bu durumda Takip ekranı bunu belirtir ve yalnızca imzalı postback'ler kabul edilir.

Parametreler

Parametre	Kabul edilen diğer adlar	Anlamı
click_id	cid, clickid, externalid	UluMob tıklama ID'si. Zorunlu
conv_type	type, goal	A ile Z arasında bir dönüşüm türü harfi. Varsayılan A
payout	amount, sum, revenue	Bu dönüşüm için elde ettiğiniz gelir; raporlar içindir
tx_id	txid, transaction_id	Sipariş veya işlem ID'niz, en fazla 128 karakter
token		HMAC imzası, aşağıya bakın
key		token yerine geçen postback gizli anahtarınız
test		1 değeri, çağrıyı kaydetmeden kontrol eder. Bkz. Postback testi
event		CPA teklifleri: conv_type yerine lead, sale, rebill, install, deposit ya da unsub. Varsa diğerleriyle birlikte imzalanır
ip, country		CPA teklifleri: takip aracınız biliyorsa ziyaretçinin IP adresi ya da ülkesi, sahte trafik kontrolleri için

Token ile imzalama

Token, postback gizli anahtarınızla oluşturulmuş onaltılık bir HMAC-SHA256 değeridir. Token'ı click_id, conv_type, payout ve tx_id olmak üzere dört parametreden oluşturun:

1. Bunları ada göre sıralayın.
2. RFC 3986'ya göre kodlanmış bir URL sorgu dizesi olarak birleştirin.
3. Bu dizenin HMAC'ini gizli anahtarınızla hesaplayın ve token olarak gönderin.

$p = ['click_id' => $clickId, 'conv_type' => 'A', 'payout' => '25.00', 'tx_id' => 'ORDER-991'];
ksort($p);
$token = hash_hmac('sha256', http_build_query($p, '', '&', PHP_QUERY_RFC3986), $secret);

Tam olarak gönderdiğiniz değerleri imzalayın. İmzalanan dizeye dört anahtarı da her zaman ekleyin. payout veya tx_id göndermiyorsanız bunları boş değerle imzalayın.

Dönüşüm türleri

Her hesap A türüyle başlar. Dönüşüm türleri altında, her biri bir harfe karşılık gelen, ad, Aktif anahtarı ve Tekrara izin ver anahtarı olan en fazla 26 tür ekleyebilirsiniz.

• Tekrarlar kapalıyken bir tıklama her tür için bir kez sayılır. Aynı tıklama ve tür için gelen sonraki postback'lere ignored yanıtı verilir.
• Tekrarlar açıkken her postback sayılır. Her dönüşüm için farklı bir tx_id gönderin.
• Aktif olmayan veya bilinmeyen bir tür için gelen postback reddedilir.

Atıf penceresi

Bir tıklama varsayılan olarak 7 gün boyunca dönüşüm alabilir. Bundan sonra o tıklama için gelen postback'ler bilinmeyen tıklama olarak reddedilir.

Ne ödersiniz

Postback üzerinden yalnızca CPA kampanyaları ücretlendirilir ve bildirdiğiniz payout değerini değil, kampanyanın CPA açık artırma teklifini öderler. CPM, CPC ve CPV kampanyalarında dönüşümler yalnızca istatistiktir. Sahte trafik olarak işaretlenen tıklamalardaki dönüşümler kaydedilir ancak asla ücretlendirilmez.

Bir CPA teklifi (olay başına ödemeli) olayın tıklamanın ülkesinde ödediği tutarı ücretlendirir. Dönüşümleri ardından teklifin bekletme süresini bekler; bu sürede onları gerekçeyle reddedip ücreti geri alabilirsiniz. Bkz. CPA dönüşümlerini inceleme.

Yanıtlar

HTTP	Gövde	Anlamı
200	{"status":"ok","charged":"4.000000",...}	Kaydedildi. charged değeri CPA dışında 0'dır
200	{"status":"ignored","reason":"duplicate"}	Bu tıklama ve tür için zaten sayıldı
402	reason: budget	CPA ücreti bütçe veya bakiye nedeniyle reddedildi; bakiye yükledikten sonra yeniden deneyin
403	reason: bad_signature	Yanlış token veya anahtar
404	reason: unknown_click	Tıklama ID'si bilinmiyor, hatalı biçimde ya da atıf penceresi dolmuş
422	reason: inactive_type	Dönüşüm türü aktif değil veya kurulmamış
429	reason: rate_limited	Tek bir IP'den çok fazla çağrı

Son 7 günde reddedilen postback'ler, panelde Reddedilen postback'ler (7 gün) altında listelenir.

Gizli anahtarı yenileme

Yeniden oluştur, yeni bir gizli anahtar oluşturur. Eski token'lar ve anahtar içeren URL'ler hemen çalışmayı bırakır; bu yüzden hemen ardından tracker'ınızı ve sunucu kodunuzu güncelleyin.