Platformunuzu RevRake'e bağlayın.

1Programınızı oluşturun

app.revrake.com/signup adresinde e-postanızla kaydolun ve gönderdiğimiz linkle onaylayın. Link bir kez ve 48 saat boyunca çalışır. Onay, programınızı oluşturur ve sizi yöneticisi olarak oturum açmış hale getirir. Ücretsizdir ve kart gerektirmez.

Ardından linklerinizin yönlendirdiği siteyi doğrulayın. Marka sayfasını açın, "Sitenizi doğrulayın" seçeneğini seçin ve gösterileni yayımlayın: host üzerinde veya bir üst alan adında revrake-verify=<token> biçiminde bir DNS TXT kaydı ya da landing sayfasında <meta name="revrake-verify" content="<token>"> etiketi. Sonra kontrol düğmesine basın.

• Site doğrulanana kadar, takip linklerinizden birini açan ziyaretçi önce linkin nereye gittiğini söyleyen kısa bir sayfa görür.

2Anahtarınızı alın

Operatör portalınızın Entegrasyon sayfasını açın. Sayfa endpoint'i, anahtar ID'nizi (pb_ ile başlar) ve gizli anahtarı gösterir. Gizli anahtarı yalnızca bir çalışma alanı yöneticisi görebilir ve anahtarı yalnızca o yenileyebilir.

Her istek üç başlık taşır: anahtar ID'si, saniye cinsinden geçerli Unix zamanı ve gizli anahtarla <timestamp>.<body> değerinin hex HMAC-SHA256'sı. Referansta curl, Node.js, Python, PHP ve Go örnekleriyle tarif ve kodunuzu sınayabileceğiniz bir test vektörü bulunur.

• Anahtarı yenilemek yeni bir anahtar oluşturur ve eskisini hemen durdurur. Platformunuzu hemen yeni anahtara geçirin.
• Gizli anahtarı sunucunuzda tutun. Onu asla bir sayfaya veya uygulamaya koymayın.

3Kayıt anına kadar cid veya btag değerini saklayın

Bir takip linki ziyaretçiyi landing sayfanıza yönlendirir ve iki parametre ekler:

https://track.revrake.com/c/<code>?utm_source=telegram&sub1=<tracker click id>

→ https://your-site.example/landing?cid=<click id>&btag=1001_1&utm_source=telegram

Bunlardan birini ziyaretçiyle birlikte saklayın (bir çerez veya oturumunuz) ve ziyaretçi kaydolduğunda oyuncuya yazın. Oyuncuyu atfeden değer budur.

• cid click ID'dir: 26 harf ve rakam. Onu opak bir dize olarak kabul edin ve metin olarak saklayın. En kesin atfı o verir.
• btag, <affiliate numarası>_<link numarası> biçimindedir, yalnızca rakam; casino platformlarının oyuncuda zaten sakladığı biçim. Platformunuzda bir btag alanı varsa ve click ID için yer yoksa bunu kullanın.
• Marka ayarlarınızdaki landing URL'si {click_id} içeriyorsa click ID, cid olarak eklenmek yerine oraya yazılır.
• Takip linkindeki UTM etiketleri landing sayfanıza aktarılır.

4Kayıtları bildirin

Bir oyuncu kaydolduğunda, oyuncu ID'nizle ve click_id, btag veya ikisiyle birlikte bir registration olayı gönderin. RevRake oyuncuyu bir kez, o anda atfeder; yanıt hangi affiliate'e ve neden atfedildiğini söyler.

{"type":"registration","player_id":"PLR-1001","click_id":"01K6QF3M8Z5T7W9XB2C4D6E8GH","btag":"1001_1"}

{
  "status": "accepted",
  "event_type": "registration",
  "event_id": "0199b2c4-6f1e-7a53-9d0c-2b8f4e1a7c33",
  "attribution": {
    "attributed": true,
    "reason": "click",
    "affiliate_number": 1001,
    "link_number": 1,
    "click_id": "01K6QF3M8Z5T7W9XB2C4D6E8GH",
    "policy_version": 1,
    "window_days": 30,
    "model": "last_click"
  }
}

Bir oyuncu markanızın Entegrasyon sayfasında belirlenen kuralına göre atfedilir: 1 ile 365 gün arası bir atıf penceresi içinde (varsayılan 30 gün) son tıklama (varsayılan) veya ilk tıklama. Kural ikisi uyuşmadığında btag'in kazandığını söylemedikçe önce click ID, sonra btag denenir. Etiketi olmayanlar dahil her kaydı gönderin: bunlar atfedilmemiş olarak kaydedilir ve sonraki yatırımlarının bir affiliate oyuncusunun ilk yatırımı olmadığı bilinir. Politika promosyon kodunun geçerli olduğunu söylediğinde, bir bağlantıyla eşleşen kod ikisinden önce denenir; eşleşmeyen kod onlara geri döner. Bir anlaşma kendi penceresini belirleyebilir; bu, ortaklarının bağlantılarındaki tıklamalar için politikanın penceresinin yerini alır.

• Kendine yönlendirme kontrolünün tıklamadan fazlasına bakmasını istiyorsanız email_hash ve ip gönderin.
• Anlaşmalarınızdan biri bazı ülkeler için ödeme yapmıyorsa, oyuncunun iki harfli ülke kodunu (ISO 3166-1 alpha-2, örneğin GB) country alanında gönderin. Gönderilmezse oyuncuyu getiren tıklamanın ülkesi kullanılır.
• Geç bildirim yaptığınızda ts gönderin; böylece atıf penceresi gerçek kayıt zamanından ölçülür.
• Oyuncu kayıt olurken bir promosyon kodu girdiyse promo_code gönderin. Kod, oyuncuyu yalnızca ne click ID ne de btag atfettiğinde atfeder (bir sonraki adıma bakın).
• Geçici e-posta kuralını açarsanız email_domain gönderin: oyuncunun e-postasında @ işaretinden sonraki kısım. Yalnızca alan adını gönderin: adresin tamamı gelirse oyuncuda yalnızca alan adı tutulur, ancak gelen günlüğü isteği geldiği haliyle göstermeye devam eder.

5Promosyon kodlarını kullanın

Promosyon kodu, bir oyuncuyu tıklama olmadan bir affiliate'e atfeder: oyuncu kodu kayıt olurken girer. Promosyon kodları sayfasında bir yönetici onaylı bir affiliate için kod ekler ve kod, o affiliate'in Linkler sayfasında gösterilen linklerinden biri olur. Aynı kodu platformunuzda oluşturun, ardından kayıtla birlikte promo_code olarak ya da REG dosyasının promo_code sütununda gönderin.

{"type":"registration","player_id":"PLR-1003","promo_code":"GARAGE50"}

{
  "status": "accepted",
  "event_type": "registration",
  "event_id": "0199b2c5-1d40-7e82-b3a1-6c0f2d9e4b17",
  "attribution": {
    "attributed": true,
    "reason": "promo_code",
    "affiliate_number": 1001,
    "link_number": 7,
    "policy_version": 1,
    "window_days": 30,
    "model": "last_click"
  }
}

• Önce click ID ve btag denenir. Promosyon kodu oyuncuyu yalnızca ikisi de atfetmediğinde atfeder ve neden o zaman promo_code olur.
• Kodlarda büyük/küçük harf fark etmez: GARAGE50 ile garage50 aynı koddur. Bir kod 2 ile 40 arası harf, rakam, tire veya alt çizgiden oluşur.
• Bir kodu kullanımdan kaldırmak, yeni oyuncuları atfetmesini durdurur; getirdiği oyuncular affiliate'te kalır. Kullanımdan kaldırılan bir kod programda bir daha asla kullanılamaz.
• Oyuncuyu atfetmek için başka bir şey gönderilmediğinde, RevRake'in bilmediği bir kod unknown_promo_code, kullanımdan kaldırılmış bir kod promo_code_retired nedeniyle yanıtlanır. Onaylı olmayan bir affiliate'in kodu affiliate_inactive verir.

6Yatırımları bildirin

Her para yatırma işlemi için işlem kimliğinizi txn_id alanında taşıyan bir deposit olayı gönderin. Anlaşma, CPA eşiğini ilk yatırımla mı yoksa chargeback tutarları düşülmüş toplam yatırımla mı karşılaştıracağını belirler. Koşul sağlandığında oyuncu başına bir CPA komisyonu beklemede oluşturulur.

{"type":"deposit","player_id":"PLR-1001","txn_id":"TX-88213","amount":"25.00","currency":"KES","first":true}

{
  "status": "accepted",
  "event_type": "deposit",
  "event_id": "0199b2c9-03aa-7e10-b6d2-91c07f5e2a18",
  "commission": {
    "effect": "created",
    "type": "cpa",
    "amount_minor": 4000,
    "status": "hold"
  }
}

• Platformunuz biliyorsa, oyuncunun ilk yatırımında first: true gönderin. Gönderilmezse, RevRake oyuncuya ait daha önceki bir yatırım bilmiyorsa yatırım ilk sayılır.
• Yatırımın kendi para birimini currency alanında gönderin. Anlaşmanınkinden farklı bir para birimindeki yatırım, anlaşmayla o günün kuru üzerinden karşılaştırılır.
• Bir yatırım kaydından önce gelebilir. Saklanır ve kayıt geldiğinde fiyatlandırılır.

7Chargeback'leri bildirin

Kendi txn_id değeriyle bir chargeback olayı gönderin; asıl yatırımın txn_id değerini ref_txn_id alanına yazın. Bu, yatırımın tamamını geri alır. Toplam yatırıma dayalı CPA’da komisyon yalnızca kalan uygun toplam eşiğin altına düşerse geri alınır: bekleyen komisyon iptal edilir; onaylanmış veya ödenmiş komisyon için iade satırı eklenir.

{"type":"chargeback","txn_id":"CB-5001","ref_txn_id":"TX-88213"}

• Yatırım önceden bildirilmiş olmalıdır. Bilinmeyen bir yatırımın chargeback'i saklanmaz, reddedilir.
• Bir yatırım bir kez geri çekilebilir.

8Net oyun gelirini (NGR) bildirin

RevShare anlaşmaları için oyuncu ve dönem başına bir ngr olayı gönderin: oyuncunun bir güne (YYYY-MM-DD) veya bir aya (YYYY-MM) ait net oyun geliri (NGR), oyuncu kazandıysa negatif. Anlaşmada belirlenen payı beklemede olarak kazandırır.

{"type":"ngr","player_id":"PLR-1001","period":"2026-10-03","amount":"118.40","currency":"KES"}

• Oyuncu önceden kayıtlı olmalıdır; bilinmeyen bir oyuncunun geliri reddedilir.
• Bir rakam değişirse, aynı dönem için yeni rakamı gönderin. Fark bir düzeltme olarak kaydedilir; hiçbir şeyin üzerine yazılmaz.
• Gün veya ay seçin ve seçiminizi değiştirmeyin. Bir ay ile ilk günü farklı dönemlerdir: 2026-10, 2026-10-01 değildir. Bir ay, son gününde geçerli olan anlaşma sürümüyle fiyatlanır ve o andan itibaren bekletilir.
• İsteğe bağlı olarak ggr, bonuses, fees ve taxes ekleyin: net gelire nasıl ulaşıldığı. Affiliate bunları komisyonun yanında görür; komisyon her zaman amount üzerinden fiyatlanır.

9Canlı olay, toplu gönderim veya günlük dosya arasında seçim yapın

Üç yöntem de aynı komisyon defterini besler. Canlı olaylar ve toplu istekler tekil işlemleri, SALES dosyaları ise günlük özetleri bildirir. Platformunuzun sağlayabildiği yöntemi seçin.

POST https://app.revrake.com/v1/files?filename=sales-2026-10-03.csv

• Canlı olaylar. Olay gerçekleştiği anda, olay başına bir imzalı istek. Affiliate oyuncuyu saniyeler içinde görür. Platformunuz kayıt ve yatırım anında bir URL çağırabiliyorsa bunu kullanın.
• Toplu gönderim. Aynı olaylar, istek başına en fazla 1.000 olaydan oluşan bir JSON dizisi olarak; örneğin birkaç dakikada bir çalışan bir işten ya da geçmiş verilerin yüklenmesi için. Her olay ayrı yanıtlanır.
• Günlük dosyalar. Platformunuzun bir affiliate sistemi için zaten dışa aktardığı REG ve SALES CSV dosyaları; Entegrasyon sayfasından yüklenir, POST /v1/files adresine gönderilir ya da platformunuzun onları yayımladığı bir adresten RevRake tarafından alınır (sonraki adım). Oyuncu ve gün başına bir satır. Aynı günün REG dosyasını SALES dosyasından önce gönderin: henüz kayıtlı olmayan bir oyuncunun geliri reddedilir.
• SALES özeti, dosya saat dilimine göre oyuncunun etkinlik günü ve para birimindeki yatırımlarını ve chargeback işlemlerini kapsar. Kapsanan postback’ler geliş sırasından bağımsız olarak tekrar eklenmez; işlem kimlikleri chargeback için kullanılabilir kalır. Çelişen toplamlar reddedilir. Farklı işlem kimlikleri, tutarları aynı olsa da farklı yatırımları temsil eder.
• SALES için deposits (FTD dahil günün brüt yatırımları), first_deposit_amount (yalnızca ilk yatırım gününde, brüt toplama zaten dahil) ve chargeback (o günün ayrı chargeback tutarı) zorunludur. Bunlar günlük tutarlardır, tüm zamanların toplamı değildir. Boş hücre sıfırdır; tutarlar negatif olamaz. Marka, oyuncu ve gün başına değiştirilemeyen bir özet saklanır: aynı dışa aktarım tekrar sayılır; tutar veya para birimi değişirse çakışır.
• REG’den önce gelen para verisi saklanır ve kayıt geldiğinde hesaplanır; reddedilen NGR, REG sonrasında yeniden gönderilmelidir. Günlük tutarlar etkinlik tarihinin kurlarını kullanır. Eksik kur veya belirsiz ilk yatırım chargeback’i ödemeyi bekletebilir. Reddedilen olayları ve gelen istek günlüğünü kontrol edin; dışa aktarımı bağlamadan önce SALES sözleşmesinin tamamını okuyun.

10Günlük dosyayı RevRake alsın

Platformunuz her günün dosyasını bir web adresinde yayımlıyorsa RevRake onu kendisi alabilir. Entegrasyon sayfasında bir yönetici bir dosya adresi ekler: bir ad (REG veya SALES gibi), adres, oturum açma biçimi ve günün saati. Her gün o saatte, çalışma alanınızın saat diliminde, RevRake dünün dosyasını birkaç dakika içinde alır ve tam olarak bir yükleme gibi içe aktarır.

https://reports.your-platform.example/affiliates/reg-{date}.csv

→ GET https://reports.your-platform.example/affiliates/reg-2026-10-04.csv

• Adreste {date}, dosyanın günü olarak YYYY-MM-DD biçimine, {yyyymmdd} ise YYYYMMDD biçimine dönüşür. Dosya başına bir adres kullanın: biri REG, biri SALES için.
• Oturum açma: yok, bir kullanıcı adı ve parola (HTTP Basic) ya da Authorization: Bearer olarak gönderilen bir token. Parola veya token yalnızca https:// adresine gönderilir.
• Herhangi bir nedenle dosya içe aktaramayan bir alım (bir 404 ya da 2xx dışındaki her yanıt, bir ağ hatası, çok büyük veya okunamayan bir dosya) ertesi günün alımına kadar saatte bir yeniden denenir. Her adres ayrı alınır; biri başarısız olursa diğerlerini bekletmez. Dosya 3 saat geciktiğinde çalışma alanının yöneticileri tek bir e-posta alır ve Entegrasyon sayfası dosyayı gecikmiş olarak gösterir.
• Ertesi günün alımı bir sonraki güne geçer. Kaçırılan bir günü tamamlamak ya da adresi test etmek için "Şimdi al" düğmesine basın ve günü seçin. İki kez alınan bir dosya hiçbir şeyi iki kez kaydetmez.
• REG dosyasına SALES dosyasından daha erken bir saat verin: henüz kayıtlı olmayan bir oyuncunun geliri reddedilir.
• Bir dosya en fazla 32 MB olabilir. RevRake yalnızca herkese açık adreslerden alır, sertifikaları doğrular ve bir dakika sonra vazgeçer. Her adresin son 30 alımı sonuçlarıyla listelenir.

11Canlıya geçmeden önce test edin

Entegrasyon sayfası bir test olayı gönderebilir: bir kaydı gerçek yoldan geçirir, ne olacağını gösterir ve hiçbir şey kaydetmez. Bunu, takip linklerinizden birine yapılan gerçek bir tıklamanın cid değeriyle kullanın.

Anahtarınızla imzalanan her istek ve içe aktarılan ya da reddedilen her dosya satırı, aynı sayfadaki gelen günlüğünde sonucu, nedeni ve geldiği haliyle gövdesiyle yer alır. Günlük, son 7 günün en yeni 50 girdisini gösterir. Gövdedeki IP adresi asla saklanmaz ve uzun bir gövde 4.000 karakterde kesilir.

• Herhangi bir şey göndermeden önce imza kodunuzu test vektörüyle doğrulayın.
• Aynı olayı iki kez göndermek güvenlidir. İkinci yanıt, "status":"duplicate" ile birlikte ilk yanıttır.

12Fraud kurallarınızı seçin

İşaretler sayfasının Kurallar sekmesinde bir yönetici fraud kurallarını açar ve kapatır. Her kural, yakaladığı bir oyuncuya kendi işaretini koyar. Oyuncu atfedilmiş kalır ve komisyonları, biri inceleme kuyruğunda işareti serbest bırakana veya onaylayana kadar beklemede kalır. Kendine yönlendirme ve tıklama patlamaları baştan açıktır; aşağıdaki kurallar siz açana kadar kapalıdır.

• Ücretli reklam tıklamaları. Oyuncuyu getiren tıklama bir reklam ağının click ID'sini taşıyordu (gclid, wbraid, fbclid, msclkid veya ttclid); bu, affiliate'in marka adınız üzerine teklif verdiği anlamına gelebilir.
• Geçici e-posta. Oyuncunun e-posta alan adı, herkese açık bir geçici e-posta alan adları listesinde yer alıyor. Kayıtta email_domain gerekir.
• Ülke uyuşmazlığı. Kaydın country değeri tıklamanın ülkesinden farklı.
• Tıklamadan hemen sonra kayıt. Oyuncu, tıklamadan sonra belirlediğiniz saniye içinde (en fazla 3.600) kaydoldu; bu kadar hızlı bir kayıt otomatik görünür.
• Paylaşılan ödeme hesabı. Bir affiliate, programın başka bir affiliate'inin zaten kullandığı ödeme bilgilerini kaydeder. Bu işaret hiçbir komisyonu bekletmez, ancak açık kaldığı sürece affiliate'in ödeme satırı aylık kapanışta bekletilir. Hesap numarası ve banka kodu, büyük-küçük harf, boşluk ve noktalama yok sayılarak ikisi de eşleşmelidir; dört harf veya rakamdan kısa bir hesap numarası karşılaştırılmaz. Bir kripto cüzdan adresi veya bir e-cüzdan hesabı hesap numarası sayılır. Yalnızca bilgileri kaydeden affiliate işaretlenir.
• Oyuncu kuralları atfedilmiş oyunculara kayıt anında bir kez uygulanır; ücretli tıklama, ülke ve süre kuralları oyuncuyu getiren tıklamaya ihtiyaç duyar. Bir kural kaydedildiği andan itibaren geçerlidir, önceki oyunculara uygulanmaz.
• Açık işaretler, seçtiğiniz gün sayısından sonra (1 ile 365 arası; varsayılan 0, hiçbir zaman demektir) kendiliğinden serbest bırakılarak veya reddedilerek karara bağlanabilir. İnceleme kuyruğunda tek seferde en fazla 200 işareti serbest bırakabilir veya onaylayabilirsiniz.

13Canlıya geçiş kontrol listesi

• Landing sayfası cid veya btag değerini oyuncu kaydolana kadar saklar; oyuncu aynı tarayıcıda daha sonra geri geldiğinde de.
• İmza kodunuz test vektörünü üretir ve sunucu saatiniz eşitlenmiştir (NTP).
• Gerçek bir tıklama ve ardından onun cid değeriyle yapılan bir test kaydı doğru affiliate'i gösterir.
• Kayıtlar yalnızca etiketli oyuncular için değil, her oyuncu için gönderilir.
• Yatırımlar sabit bir txn_id ve para birimlerini taşır.
• Zaman aşımında veya bir 5xx yanıtında platformunuz olayı yeni bir zaman damgasıyla yeniden gönderir.
• Bir 422 yanıtı sizin tarafınızda günlüğe yazılır ve incelenir: yeniden denemeyle başarılı olmaz.
• Gelen günlüğü, gönderdiğiniz her olay türü için accepted gösterir.

14Raporları ve komisyonları kendi sisteminize çekin

Arka ucunuz, portalın gösterdiğini aynı anahtarla ve aynı üç başlıkla okuyabilir: GET /v1/reports Raporlar sayfasındaki raporu JSON veya CSV olarak, GET /v1/commissions ise komisyon defterini sayfa sayfa verir. Bir okumanın gövdesi yoktur; bu nedenle imza, yolu ve sorguyu tam olarak gönderdiğiniz haliyle kapsar. Referansta her parametre ve alan bulunur.

GET https://app.revrake.com/v1/reports?by=link&days=7

GET https://app.revrake.com/v1/commissions?from=2026-09-01&to=2026-10-01&per_page=500

• Bir komisyonun durumu, satır yazıldıktan sonra değişir: beklemede, sonra onaylandı, sonra ödendi ya da reddedildi. Yalnızca yeni satırları almakla yetinmeyin. Bir dönemi yeniden okuyun, örneğin her gece son 60 günü, ve elinizdeki satırları id değerine göre güncelleyin.
• Tutarlar en küçük birimdedir ve para birimi yanlarında yer alır. Farklı para birimlerindeki tutarları asla toplamayın; raporlama para biriminizdeki toplamlar için reporting_minor alanını kullanın.
• Anahtar başına dakikada en fazla 120 okuma. Her yanıt, kaç okuma kaldığını X-RateLimit-Remaining içinde söyler. Bir 429 yanıtında Retry-After içinde verilen saniye kadar bekleyin ve isteği yeniden gönderin.
• Anahtarınızı asla bir affiliate'e vermeyin: programın tamamını okur ve olay gönderebilir. Her affiliate, yalnızca kendi rakamlarını okuyan kendi anahtarını oluşturur.
• Aynı raporlar ve defter portaldan CSV olarak da indirilebilir.

15Değişikliklerden kendi sistemlerinizde haberdar olun

Webhook'lar programınızda olanları gerçekleştiği anda kendi sistemlerinize (bir CRM, bir veri ambarı, bir sohbet kanalı) gönderir: başvurular ve affiliate'ler hakkındaki kararlar, kayıt olan oyuncular, oluşturulan, onaylanan, reddedilen, ödenen veya geri alınan komisyonlar ve ödemeler. Entegrasyon sayfasında bir yönetici "Endpoint ekle" düğmesine basar, sunucunuzdaki adresi girer ve olayları işaretler. İmza için gizli anahtar yalnızca bir kez gösterilir: o anda kopyalayın.

{
  "id": "0199b2c9-0a11-7c3e-9f20-7d4b1e6a2c58",
  "type": "commission.created",
  "created_at": "2026-10-05T09:12:44.318204Z",
  "data": {
    "player_id": "PLR-1001",
    "occurred_at": "2026-10-05T09:12:40Z",
    "attributed": true,
    "affiliate_number": 1001,
    "affiliate_name": "Odds Garage",
    "commission_id": "0199b2c9-0a0f-7a51-8c3d-5e2f4a6b7c90",
    "commission_type": "cpa",
    "amount": "25.00",
    "amount_currency": "USD",
    "commission": "40.00",
    "commission_currency": "USD"
  }
}

Her olay, bu gizli anahtarla imzalanmış ve gövdesi yukarıdakine benzeyen bir JSON POST isteğidir. Referans her olayı ve alanı, başlıkları ve Node.js ile Python doğrulama kodunu listeler.

• Gövdeyi ayrıştırmadan önce imzayı ham gövde üzerinden doğrulayın ve 5 saniye içinde bir 2xx ile yanıt verin.
• Tekrarları gövdenin id alanına göre ayıklayın: bir olay birden çok kez gelebilir.
• Endpoint'inizi kontrol etmek için "Test gönder" düğmesine basın. Her endpoint'in teslimat günlüğü neyin gönderildiğini ve sunucunuzun ne yanıt verdiğini gösterir.
• Başarısız bir teslimat yaklaşık bir buçuk gün boyunca yeniden denenir. Art arda 20 başarısız denemeden sonra endpoint kapatılır; olaylar sıraya girmeye devam eder ve siz onu yeniden açtığınızda gönderilir.

16Sorun giderme

• bad_signature. Gönderdiğiniz baytların aynısını imzalayın: JSON'un yeniden serileştirilmiş bir kopyasını değil, aynı dizeyi. İmzalanan metin zaman damgası, bir nokta ve ardından gövdedir. İmza küçük harfli hex'tir. Gizli anahtarın sonunda boşluk veya satır sonu olmadığını kontrol edin.
• bad_timestamp. Zaman damgası Unix saniyesi (milisaniye değil) olmalı ve gerçek zamandan en fazla beş dakika sapmalıdır. Sunucu saatini eşitleyin ve her yeniden denemeyi yeni bir zaman damgasıyla imzalayın.
• unknown_key. Anahtar ID'si yanlış yazılmış ya da anahtar yenilenmiş. Geçerli anahtar Entegrasyon sayfasındadır.
• Her şey tekrar sayılıyor. Kayıtlar player_id, yatırımlar ve chargeback işlemleri txn_id kullanır. Kimliği yalnızca aynı isteği tekrarlamak için yeniden kullanın. Yatırım tutarlarının veya chargeback referansının değişmesi çakışır. Her gerçek işlem için farklı kimlik kullanın.
• Oyuncular atfedilmiyor. Yanıttaki veya gelen günlüğündeki reason değerine bakın. no_tag: landing sayfası etiketi kayıttan önce kaybetti. unknown_click veya unknown_btag: değer yolda değişti veya kesildi. outside_window: tıklama atıf penceresinden daha eski. affiliate_inactive: affiliate onaylı değil. unknown_promo_code veya promo_code_retired: promosyon kodu sizinkilerden biri değil ya da kullanımdan kaldırıldı.
• Entegrasyon değiştirirken iki yoldan da bildiriyorum. SALES özeti dosya saat dilimindeki oyuncu, etkinlik günü ve para biriminin postback’lerini kapsar. Tutarlar geliş sırasından bağımsız bir kez sayılır; gerçek txn_id değerleri kullanılabilir kalır. Bilinen işlemlerden düşük özet veya çelişkili ilk yatırım kanıtı reddedilir. Farklı postback işlem kimlikleri ayrı yatırımlar sayılmaya devam eder.
• Bir yatırım kaydından önce geldi. Yanıtta "waiting_for_player": true bulunur. Hiçbir şey kaybolmaz: kaydı gönderin, yatırım o zaman fiyatlandırılır.
• Bir yatırım hiçbir şey kazandırmadı. commission.reason nedenini söyler: unattributed, not_first, below_threshold, country_blocked, no_cpa_in_deal, already_earned veya no_deal_version.
• Bir komisyon "kur eksik" nedeniyle beklemede. Yatırım, o gün için henüz kuru olmayan bir para birimindedir. Kurlar saatte bir yenilenir; o günün kurunu Döviz kurları sayfasından kendiniz de girebilirsiniz. Kur oluştuğu anda komisyon hesaplanır.
• Bir okumada bad_signature. Bir GET için zaman damgasını, bir noktayı ve ardından yolu ve sorguyu tam olarak gönderildiği haliyle, aynı sırada ve aynı kodlamayla imzalayın: /v1/reports?by=link&days=7. Sorgu yoksa yalnızca yolu imzalayın.
• Bir alan reddediliyor. Referansta bulunmayan bir alan reddedilir; böylece bir yazım hatası asla sessizce yok sayılmaz. Yanıt field alanını belirtir ve neyin düzeltileceğini söyler.

Linkler, sub-ID'ler ve UTM etiketleri

Takip linkleri sayfasında her kampanya için bir takip linki oluşturun. Her linkin kendi kısa adresi ve kendi btag değeri vardır; link, programın sitesinde seçtiğiniz bir sayfaya yönlendirebilir.

https://track.revrake.com/c/a8Kq2Zx?sub1={clickid}&utm_source=telegram&utm_campaign=october

Linki yerleştirirken kendi değerlerinizi ekleyin. Bunlar her tıklamayla birlikte saklanır:

• sub1–sub5: her biri en fazla 200 karakter. Tracker'ınızın click ID'sini sub1 içine koyun; postback'lerinizde size geri döner.
• utm_source, utm_medium, utm_campaign, utm_term, utm_content: tıklamayla kaydedilir ve landing sayfasına aktarılır.
• Yerleştirdiğiniz adres kendi değerini taşımıyorsa, portalda linke sabitlenen değer kullanılır.
• Botlar, link önizlemeleri ve tekrar tıklamalar kaydedilir ve işaretlenir; tıklama sayılarınıza dahil edilmez.
• Bir yayında söylemek veya basmak için bir linke kısa bir ad verin: track.revrake.com/go/<name> adresinde de açılır. Her linkin PNG veya SVG olarak indirilebilen bir QR kodu vardır.

Dönüşümleri tracker'ınıza gönderin

Postback'ler sayfasında bir hedef ekleyin: tracker'ınızı seçin, adresteki sunucu adını tracker'ınızınkiyle değiştirin ve haberdar olmak istediğiniz olayları işaretleyin. Süslü parantez içindeki her şey bir makrodur ve her dönüşüm için doldurulur.

Portalda şu ön ayarlar hazır gelir. Her birinde tracker'ınızın click ID'si sub1 içinde taşınır, {status} ise o tracker'ın tanıdığı sözcükleri taşır:

Başka bir tracker için "Diğer / özel" seçeneğini seçin ve adresi ihtiyacınız olan makrolarla yazın.

Tracker bazında adım adım rehberler: Keitaro, Binom, Voluum, RedTrack, BeMob, PeerClick, FunnelFlux Pro.

• Bir hesabın en fazla 10 hedefi olabilir.
• Bir kayıt para taşımaz: {commission} ve {amount} kayıt için boştur.
• RevRake'in tanımadığı bir makro olduğu gibi gönderilir; böylece bir yazım hatası teslimat günlüğünde görünür.

Test edin ve teslimat günlüğünü okuyun

Bir hedefte "Test gönder" düğmesine basın: uydurma bir dönüşüm hemen gönderilir ve tracker'ınızın ne yanıt verdiğini görürsünüz. Her gerçek postback, teslimat günlüğünde her denemesi ve tracker'ın yanıtıyla birlikte bir satırdır.

• Başarısız bir teslimat 1 dakika, 5 dakika, 25 dakika, 2 saat, 10 saat ve 24 saat sonra yeniden denenir. Son denemeden sonra vazgeçildi olarak işaretlenir ve onu elle yeniden gönderebilirsiniz.
• Art arda 5 ve 15 başarısızlıktan sonra bir e-posta alırsınız. 20'de hedef kapatılır; adresi düzeltip hedefi yeniden açın, bu arada kuyruğa giren her postback gönderilir. Kendi kapattığınız bir hedefe yeni bir şey gönderilmez.
• Tracker'ınız herkese açık bir adresten erişilebilir olmalı ve 5 saniye içinde 2xx durumuyla yanıt vermelidir.

Kendi rakamlarınızı API ile okuyun

Kendi raporlamanızı tutuyorsanız affiliate portalınızın API sekmesinde bir anahtar oluşturun. Anahtar ak_ ile başlar. Gizli anahtar yalnızca bir kez, anahtar oluşturulduğunda gösterilir: o anda kopyalayın. Bu anahtarla GET /v1/reports, /v1/commissions, /v1/affiliates, /v1/links ve /v1/deals adreslerini referansta anlatıldığı gibi imzalayarak çağırabilirsiniz; kendi tıklamalarınızı, kayıtlarınızı, ilk yatırımlarınızı ve komisyonlarınızı alırsınız, başkasına ait hiçbir şeyi değil.

GET https://app.revrake.com/v1/reports?by=link&days=7

• Anahtarınız olay gönderemez ve diğer affiliate'leri okuyamaz.
• Yeni bir anahtar oluşturmak eskisini hemen durdurur. Anahtarı iptal edip anahtarsız da kalabilirsiniz.
• Anahtar, hesabınız programda onaylı olduğu sürece çalışır. Onaylı değilse yanıt 403 affiliate_inactive olur.
• Bir komisyonun durumu, satır yazıldıktan sonra değişir (beklemede, onaylandı, ödendi ya da reddedildi). Yalnızca yeni satırları almak yerine bir dönemi yeniden okuyun.
• Operatörden asla anahtarını istemeyin ve kendi anahtarınızı asla paylaşmayın. Anahtar olmadan da aynı rakamlar, CSV indirmeleriyle birlikte portalınızdadır.