Მისიების ინტეგრაცია ბონუსის სისტემასთან და CRM
მისიები მუშაობენ მხოლოდ მაშინ, როდესაც ჯილდო პროგნოზირებულია და კომუნიკაცია იწვევს მოთამაშეს ნაბიჯიდან ნაბიჯამდე. ეს ნიშნავს, რომ ბირთვი არის Mission Engine - Bonus/Wallet - CRM/CDP, პლუს RG/KYC და ანტიფროდი. ქვემოთ მოცემულია მზა ინტეგრაციის სქემა მონაცემთა შაბლონებთან და დადასტურებულ პრაქტიკებთან.
1) ინტეგრაციის მიზნები
ჩართულობის ზრდა და ARPPU (net): მისიები - პროგრესი, ჯილდოები, განმეორებითი სესიები/ანაბრები.
ზღვრის კონტროლი: ბიუჯეტის აუზები, ქუდები, „ბონუსის ღირებულება“ აქტიურ/გადახდაზე.
პერსონალიზაცია: მისიები და ჯილდოები CRM/CDP სეგმენტებში.
შესაბამისობა: KYC/RG კარიბჭეები, გეო წესები, აუდიტი.
გაზომვა: A/B, პოსტ ეფექტი, კანიბალიზაცია.
2) ნაკადის არქიტექტურა
1. Event Ingest: `bet`, `win`, `deposit`, `mission_progress`, `mission_complete`.
2. მისიის ძრავა: პირობების შემოწმება, ქულების/სტატუსის დათვლა, ჯილდოს გამომწვევი.
3. Reward Orchestrator: ბიუჯეტის შემოწმება, RG/KYC, 'reward _ task' შექმნა.
4. Bonus/Wallet: ქეში, ბონუს ქეში (wager), frispins, კუპონები; ვებჰუკი/SDK.
5. CRM/CDP: სეგმენტები, ტრიგერის კამპანიები, სიხშირის ლიმიტები, მხარდაჭერის ფურცლები.
6. Analytics/DWH: ნედლეული მოვლენები, ფანჯრები, კვალი, დაშბორდები.
7. Anti-Fraud & RG: ქუდი, ევრისტიკა/ML, ჰოლდინგური და მიმოხილვა.
3) მონაცემთა მოდელი და მოვლენები
მოვლენები (მინიმალური):- `mission_view / join / progress / complete`
- `points_awarded {rule_id, amount, caps}`
- `reward_task. created / succeeded / failed / held`
- `wallet_credit / bonus_issued / freespins_issued`
- `kyc_status_changed / rg_event`
- `crm_send / crm_open / crm_click / crm_unsub`
json
{
"event": "mission_complete", "ts": "2025-10-24T10:17:12Z", "user": {"id":"u_123", "geo":"TR", "platform":"ios", "payer_flag":true}, "mission": {"id":"m_4521", "type":"turnover", "segment":"mid_core"}, "progress": {"value": 1000, "window":"2025-10-24"}, "context": {"session_id":"s_778"}
}
4) ჯილდოს რუკა: მისიები და ბონუსის სისტემა
არჩევანის წესი: მასობრივი მისიები - იაფი ჯილდოები (FS/ბონუს ქეში), „ფინიშერები „/ღრმა ჯაჭვები - ნდობის გარეშე ქეშის ნაწილი.
5) Reward Orchestrator: ბიუჯეტი, RG/KYC, imempotence
Idempotence: გასაღები 'reward _ task _ id' + 'X-Request-Id' გარე გამოწვევებისთვის.
ბიუჯეტები: 'season _ sprint', 'onboarding', 'reengage'; soft/hard cap; circuit-breaker 90%.
KYC/RG კარიბჭეები: ქეში>, X - მხოლოდ L2 +, აქტიური 'cool _ off' ჯილდოებით 'held'.
აუდიტი: გამავალი ორგანოების WORM ჟურნალი.
მაგალითი 'reward _ task. created`:json
{
"type":"reward_task. created", "reward_task_id":"rt_9a7", "user_id":"u_123", "origin":{"mission_id":"m_4521","threshold":"final"}, "reward":{"type":"bonus_cash","amount":5,"currency":"EUR","wagering":15,"expiry":"2025-10-27T00:00:00Z"}, "pool_id":"season_sprint", "status":"pending"
}
6) ინტეგრაცია საფულესთან/ბონუს სერვისთან
გამავალი ვებჰუკი (მაგალითი):
POST /wallet/bonus. issue
X-Request-Id: rid_7f5...
X-Timestamp: 1730061700
X-Signature: sha256=...
{
"user_id":"u_123", "bonus": {"type":"bonus_cash","amount":5,"currency":"EUR","wagering":15,"expiry":"2025-10-27T00:00:00Z"}, "reason":"mission:m_4521"
}
პარტნიორის პასუხი: '200 {„bonus _ id“:“ b _ 331“, „status „:“ issued“}' reward _ task. succeeded`.
5xx შეცდომები - იგივე 'X-Request-Id'; 4xx DLQ + სახელმძღვანელო დამუშავება.
7) CRM/CDP კავშირი
7. 1. სეგმენტი
სცენა: D0-D7 (onboarding), R7-R30 (regage), Core P30.
მონეტიზაცია: გადაუჭრელი/NPP/RPP/მაღალი ვალი.
ქცევა: T1/T2/T3, „ჩერდება“, „თითქმის მიაღწია“.
რისკი: RG დროშები, KYC სტატუსი.
7. 2. კამპანიის გამომწვევები
მისიაზე: „დარჩა 120 ქულა“, „+ 2 პოზიცია“ - app/push.
Post-mission: „პრემია გააქტიურებულია/იწურება 12 საათის შემდეგ“.
Winback: მან არ წამოიწყო მისია 48 საათის განმავლობაში პირადი შეთავაზება (თუ ნებადართულია).
Suppression: 'cool _ off '/self-exclusion არ არის პრომო.
7. 3. სიხშირის წესები
Max 1 push/4 სთ, 1 email/24 სთ მისიისთვის; caping არხზე და მთლიანობაში.
ადგილობრივი დროით Quiet hours, ორმაგი საბითუმო.
8) Paypline მონაცემები CRM- ში
CDP ვიტრინა 'mission _ funnel _ daily':- `eligible`, `viewed`, `joined`, `started`, `t1..tn`, `completed`, `rewarded`.
- დრო T1/T2/...; ბონუსის სტატუსი; 'cost _ eur'; 'net _ arppu'.
sql
SELECT user_id
FROM mission_funnel_daily
WHERE mission_id =:m
AND started = true
AND completed = false
AND points_to_next <= 150
AND last_seen_at > now() - interval '24 hour'
AND rg_ok = true;
9) ანტიფროდი და „სამართლიანი თამაში“
ქუდი: სათვალეები/ფსონი, სათვალეები/წთ/საათი/დღე; განმეორებითი მიკროტალღების ლიმიტი.
ეს სიგნალები: headless, მარიონეტული, დუბლიკატები 'device _ fp'.
ქცევითი ფილტრები: განაკვეთების მინიმალური დისპერსია; „იდეალური“ შაბლონები.
პრიზები:> X და ტოპ პოზიციები - გადავადებული გაცემა KYC- ზე.
CRM შეზღუდვები: არ სტიმულირება „ქულების ფერმერებისთვის“; suppression по fraud-score.
10) ჯილდოს ეკონომიკა და ზღვრის კონტროლი
ძირითადი ინდიკატორები:- `Prize & Bonus Cost per Active` / `per Payor`
- `ΔARPPU (net)` = ARPPU − (Prize+Bonus per payor)
- 'Net Uplift' = Incremental შემოსავალი - ღირებულება (პრიზები + ოპერაციები + frode)
sql
SELECT pool_id, SUM(value) AS spent, MAX(budget) AS limit, SUM(value)/MAX(budget) AS fill
FROM reward_ledger
WHERE date(created_at)=current_date
GROUP BY pool_id;
11) A/B ინტეგრაციის ტესტები
ერთეული: მომხმარებელი, sticky-assignment, სტრატიფიკაცია (payer/geo/platform).
Primary: participation_net, completion, `ΔARPPU (net)`.
Guardrails: საჩივრები/1k, fraud-flags, RG მოქმედება, SRM ალერტები.
CUPED: pre-value (ARPU/ქულები გასული კვირის განმავლობაში) დისპერსიის შესამცირებლად.
ჩარევა: ცალკეული ლიდერები/ქულების ნორმალიზაცია.
12) UX ნიმუშები, რომლებიც „შეესაბამება“ მისიებს, პრემიებს და CRM
ერთი ეკრანი არის ერთი მიზანი: მკაფიო წესები, აშკარა პროგრესი.
დაუყოვნებლივი გამოხმაურება: „+ 10 ქულა“ და პროგრესი.
ჯილდოს ხილვადობა: რაც უკვე მიღებულია, რომ დაიწვება, რა მოხდება შემდეგ.
ჰაიდლინი საავტორო უფლებების მიხედვით: ჩვენ „ვიწვევთ“ მონაწილეობის მისაღებად, არ ვაძლევთ დეპოზიტზე.
ლოკალიზაცია: ტექსტები, ვალუტები, ვადები, იურისდიქცია.
13) დაშბორდი (ყოველდღიურად)
1. მისიის ძაბრი: Reach - Join - Start - T1/T2/... - Complete - Rewarded.
2. კომუნიკაციები: send/Open/click, opt-out, per-channel capping.
3. მონეტიზაცია: ARPU (net), Avg Deposit, Paying Share.
4. ღირებულება: Prize/Bonus Cost%, Net Uplift, ბიუჯეტის აუზები.
5. ხარისხი: DLQ, retrai, HMAC შეცდომები, latency p95, frode დროშები, RG გამომწვევები.
6. სეგმენტები: ახალბედა/mid-core/high-value; web/iOS/Android; გეო.
14) გაშვების სია
- ღონისძიების სქემა, ვერსია, ვებჰუკის კონტრაქტები (HMAC, TTL, idempotence).
- Mapping მისიები - ჯილდოს ტიპები + ბიუჯეტები/კაპერები.
- KYC/RG კარიბჭეები, დიდი პრიზების hold and მიმოხილვა.
- საფულის/ბონუსის სერვისის ინტეგრაცია (sandbox), retrai/DLQ.
- CRM/CDP სეგმენტები, ტრიგერები და სუპრესიის წესები, სიხშირის ლიმიტები.
- დაშბორდი SLO და ეკონომიკა; ალერტები SRM/DLQ/ბიუჯეტი.
- A/B გეგმა, CUPED, ცალკეული ლიდერები.
- Runbook ინციდენტები: მოვლენების რეპლიკა, ხელით გაცემა, წესების გაყინვა.
15) მინი შემთხვევა (სინთეზური)
ამოქმედდა: ონბორდინგი 7 დღე, შაბათ სპრინტი, რეტერნი 14 დღე.
ჯილდოები: T1/T2 - FS/ბონუს ქეში; ფინიშერები უიღბლო ქეშის ნაწილია.
CRM: ტრიგერები „თითქმის მიაღწია“, „პრემია იწურება“, quiet-hours, capping.
6 კვირა, 2 ბრენდი, ჰოლდოტი 15%.
შედეგები: participation _ net 24% - 33% (+ 9 პროცენტული პუნქტი), completion 42% - 56% (+ 14 პროცენტული პუნქტი), S ARPPU (net) + 2.8; Prize&Bonus/Active +€0,8; DLQ <0,07%; fraud-flags <1% PF.
გამოსავალი: სკალირება, მიკროპრიზების „გრძელი კუდის“ ზრდა და ადგილობრივი ტექსტები CRM- ში.
მისიების ინტეგრაცია ბონუსის სისტემასთან და CRM არის ერთი მანქანა: მოვლენები და წესები, ბიუჯეტის კონტროლი, საფულე/პრემია, პერსონალიზაცია და უსაფრთხო კომუნიკაციები. ააშენეთ იგი idempotence- ზე, KYC/RG კარიბჭეებზე, CRM სეგმენტებზე და გამჭვირვალე ეკონომიკაზე - და მისიები სტაბილურად მოიტანენ წმინდა შეთქმულებას და არა „ჭამენ“ ზღვარს.