Affiliated İdarəetmə Sistemi (AFF modulları)
Giriş
Affiliated Management System (AFF-modul) tərəfdaşlara oyunçuları cəlb etməyə və onların fəaliyyətindən komissiya almağa imkan verir. Platformaya daxil edilmiş AFF modulu istinad linklərinin yaradılmasını, qeydiyyat və depozitlərin izlənməsini, mükafatların avtomatik hesablanmasını, komisyonların multi-tier strukturunu və ətraflı hesabatı təmin edir.
1. Referans linklərinin yaradılması və izlənməsi
Unikal tokenlər: hər bir tərəfdaş üçün 'affiliateId' və növün istinad linkləri dəsti yaradılır
https: //casino. example. com/?aff=abc123
Cookie- və session-tracking: cookies keçidində configurable TTL-də 'aff = abc123' saxlanılır (30-90 gün).
Server-side attribution: oyunçu cookies, IP fallback və UTM reklam etiketləri xaricində qeydiyyatdan keçərsə.
2. Komissiyaların hesablanması modulu
1. Mükafat növləri:- Revenue share: GGR faiz (adətən 20-40%).
- CPA: qeydiyyat üçün sabit ödəniş + ilk depozit.
- HybrID: CPA və RS birləşməsi.
- Tier 1: Birbaşa referanslar.
- Tier 2 +: endirimli komissiya ilə referans referansları (5-10%).
- 3. Hesablaşma müddəti: razılaşmadan asılı olaraq gündəlik/həftəlik/aylıq.
- `POST /affiliate/compute? period = 2025-07 'job hesablama başlayır.
- ACID əməliyyatları: Ledger Service-də hesablama, payout sorğusunun yaradılması.
3. API və Webhook inteqrasiyası
REST API:- `GET /affiliate/{id}/stats? from = & to = '→ qeydiyyat, depozitlər, GGR, komissiya.
- 'POST/affiliate/{ id }/payout' → göstərilən detallara ödəniş yaratmaq.
- Hadisələr: 'player. registered`, `player. deposited`, `affiliate. commission. awarded`.
- Payload 'affiliateId', 'playerId', məbləğlər və dərəcələri ehtiva edir.
4. Hesabat və interfeyslər
Partnyor dashboard:- Real vaxt göstərir: yeni oyunçular, depozit məbləğləri, GGR, hesablanmış komissiyalar, ödəniş statusu.
- Dövrlərə, ölkələrə, trafik mənbələrinə (UTM) görə filtrlər.
- İxrac: CSV/PDF cədvəl və tələb.
- BI üçün API-giriş: secure REST vasitəsilə xarici sistemlərlə inteqrasiya.
5. Anti-fraud və sistem qorunması
Detection:- self-referral kilidi (same IP/device).
- Velocity checks: Bir tokendən dəqiqədə N-dən çox qeydiyyat.
- Manual nəzarət üçün inzibati panel.
- WORM-anbarda bütün izləmə və hesablama hadisələrinin immutable qeydləri.
6. Miqyaslı və pozulma müqaviməti
Mikroservis arxitekturası: AFF-Service core-dən ayrı, izləmə yükü ilə ölçülür.
Message Broker (Kafka):- Qeydiyyat hadisələrinin və real vaxt depozitlərinin işlənməsi.
- Tez lookup 'affiliateId' po 'playerId' və UTM.
- AFF-Service və Leaderboard Service, Sentinel-Redis üçün HPA ilə Kubernetes.
7. Təhlükəsizlik və uyğunluq
Autentifikasiya: tərəfdaşlar üçün OAuth2, IP məhdudiyyəti olan API açarları.
Şifrələmə: Bütün kanallar üçün TLS, gizli saxlama.
GDPR/CCPA: partnyor və oyunçuların məlumatlarını silmək hüququ, anonymize imkanı.
Nəticə
İnteqrasiya olunmuş affiliatlı idarəetmə sistemi tərəfdaşlara trafikin cəlb edilməsi və monetizasiyasına dair tam hüquqlu vasitə təqdim edir: unikal linklərdən və trekinqdən tutmuş multi-tier komissiyalarının avtomatik hesablanmasına, real vaxt daşbordlarına və fırıldaqçılığa qarşı etibarlı müdafiəyə qədər. Miqyaslı mikroservis arxitekturası və API inteqrasiyası partnyor şəbəkəsinin performansını və təhlükəsizliyini itirmədən böyüməsinə zəmanət verir.