Идоракунии аксияҳо ва мукофотпулӣ дар сатҳи ақиб

Мақолаи пурра

💡 18+. Маводи муҳандисӣ ва амалӣ барои платформаҳо/операторҳо ва провайдерҳо. На даъват ба бозӣ. Бо "ҳамён" мо маънои Ledger/Wallet-ро бо кафолати ACID, аз ҷониби "бонусҳо" - таблиғгароне, ки ба тавозун ва шароити бозӣ таъсир мерасонанд, дар назар дорем.

1) Чаро промо-ро ба пуштибони алоҳида баред

Инвариантҳои пулӣ. Бонус ≠ "тавозуни иловашуда": ин шартнома бо шартҳо (vager, саҳм ба бозиҳо, ҳадди аксар гарав/бурд).

Меъёри тағирот. Гурӯҳҳои маркетингӣ ҳамарӯза маъракаҳоро мебароранд - ба шумо муҳаррики қоидаҳои декларативӣ ва бозгашт лозим аст.

Анти-сӯиистифода/мувофиқат. KYC/RG/AML, суръат, сегментатсия, вазифаҳои чаҳор чашм барои пешниҳодҳои гарон.

Мушоҳида ва гузоришдиҳӣ. SLO, арзиши promo, таъсир ба GGR/NGR/LTV.

Принсип: ядрои promo як хидмати алоҳида бо мошинҳои ҳолати худ аст ва пул танҳо тавассути ҳамён, бемаънӣ ҳаракат мекунад.

2) Типологияи бонус ва инвариантҳо

Мувофиқати пасандоз (100% пеш аз X): пас аз гирифтани пасандоз ҳисоб карда мешавад, vager X ×.

Cashback: бо равзанаи вақт/бозиҳо ҳисоб карда мешавад, метавонад часпанда/часпанда набошад.

Spins Free/Bets Free: купонҳо/токенҳо бо нархи як чарх/бет, ҳавзи собит RTP.

Супоришҳо/миссияҳо: вазифа → пешрафт → мукофот.

Мусобиқаҳо/чорабиниҳои парвоз: саҳми чорабиниҳо, рейтинг, мукофоти пулӣ.

Инвариантҳо:

Часпанда: то он даме, ки шартҳо иҷро нашаванд, баромад карда намешавад.
Ғолиб Макс Бет/Макс: маҳдудиятҳои гарав/пардохт аз фондҳои бонусӣ.
Саҳм: саҳм аз рӯи бозӣ (масалан, слотҳо = 100%, зинда = 10%).
Мӯҳлати кор: Мӯҳлати эътибори бонус ва равзанаи vager.

3) Меъмории хидматрасонии бонус


Админ ─Promo ─Rules муҳаррики API/мутобиқат
│
├─Bonus китобча (ҳолати пешниҳодҳо)
├─Wagering муҳаррик (пешравӣ)
├─Anti -Абсус (маҳдудиятҳо/қаллобӣ/суръат)
└─Outbox (воқеаҳо) ─Kafka/Pulsar ─BI/DWH/CRM

Wallet/Ledger── Фармонҳои Idempotent ───┘

Қоидаҳои муҳаррик - шартҳои декларативӣ (сегментҳо, гео/литсензия, каналҳо, KYC/RG).

Wagering Engine - саҳмҳоро аз 'bet. ҳал '/' ҳамён. дебет	қарз '.
Bonus Ledger манбаи ҳақиқат дар ҳолати бонус/миссия мебошад.
Outbox/CDC - бонуси нашрияи боэътимод. дода шудааст	пешрафт. навсозӣ

4) Модели маълумот (соддакардашуда)

'bonus _ grant'

'grant _ id, player_id, offer_id, намуд, асъор, amount_minor, часпанда, wager_x, max_bet_minor, max_win_minor, contribution_schema_id, мақом (дода шудааст)	фаъол	таваққуф кард	анҷом ёфт	Мӯҳлати ба охир расида	бозхонд), issued_at, expires_at, brand_id, минтақа, idempotency_key'

'wager _ progress'

'grant _ id, required_minor, contributed_minor, remaining_minor, last_update_at'

'contribution _ schema'

' schema _ id, қоидаҳо: [{game _ type:" слот", pct: 100}, {game _ type:" зинда", pct: 10}]'

'bonus _ ledger _ enter' (аудит)

'entry _ id, grant_id, амал (нашр)	истеъмол кунед	бозхонд	муҳлати ба охир расидани мӯҳлат	танзим), amount_minor, ақл, occurred_at, trace_id'

5) Мошинҳои статусӣ ва сагҳо

5. 1 Масъала - Сага

1. мутобиқат. санҷед (сегмент, RG/KYC, суръат)

2. грант. эҷод кунед (статус = 'дода шудааст')

3. ҳамён. қарз [бонус] (idempotent; дар часпак - ба тавозуни бонус)

4. фаъол (статус = 'фаъол')

5. хориҷ 'бонус. дода шуд '

Бозгашт: ҳангоми афтодани гранти 3 → '. бекор кардани бонуси '+ чорабинӣ'. бозхонд '.

5. 2 Пешрафти Vager

Na 'bet. 'саҳми ҳисобкунӣ =' саҳм _ minor contribution_pct' (ё тибқи қоидаҳои бурд/зиён).

Навсозии 'wager _ progress' атомӣ; вақте ки 100% мерасад - 'пурра'.

5. 3 Анҷом (истеъмол кунед)

пурра → 'ҳамён. convert_bonus_to_cash' (агар часпанда набошад) ё маҳдудиятҳои баромадро хориҷ кунед.

хориҷ 'бонус. истеъмол карда шудааст '.

5. 4 Мӯҳлати истифода/хотиррасонӣ

By 'expires _ at' ё қоидаи қаллобӣ → 'бозхонд' (idempotent), ҷуброн тибқи сиёсат имконпазир аст.

6) Шартномаҳои ҳамён (танҳо тавассути API, ҳамеша idempotent)

Аккредитатсияи бонус


POST/v1/ҳамён/қарз
Сарлавҳаҳо: Калиди X-Idempotency: bonus_grant_123
{
"player_id":"p_001," "миқдор ": {"minor _ vits ": 100000," асъор":" EUR"}, "balance_type":"bonus," "истинод ": {"grant _ id ": "gr _ 123"," offer _ id":" of _ 777"}
}
→ 200 {"статус ": "қарз дода шудааст "," entry _ id":" e _ 9001"}

Табдил додан ба кэш ҳангоми риояи шартҳо


POST/v1/ҳамён/табдил
Сарлавҳаҳо: Калиди X-Idempotency: bonus_convert_gr_123
{
"player_id":"p_001," "from_balance":"bonus," "to_balance":"cash," "amount_minor":100000 ", истинод ": {"grant _ id":" gr _ 123"}
}
→ 200 {"статус ": "табдилшуда "," entry _ id":" e _ 9010"}

Санҷиши максималии бурд/макс - дар паҳлӯи RGS/Wallet Guard:

дархост 'гарав. иҷозат 'бо рамзи' BONUS _ MAX _ BET _ EXCESTED 'рад карда мешавад.

7) API хидмати таблиғотӣ (қолабҳо)

Эҷод кардани пешниҳод (админ)


POST/v1/пешниҳодҳо
{
"ном ": "Хуш омадед 100% то 100 €", "навъи ": "пасандоз _ match", "params ": {"match _ pct ": 100, "cap _ minor": 10000," wager _ x": 20," часпанда": дуруст, "max_bet_minor":200,"max_win_minor":50000,"contribution_schema_id":"c_slot100_live10"} ", мувофиқат ": {"брендҳо ": ["A "], "минтақаҳо": [" EU"]", сегмент":" new _ амонатгузорон"}, "ҷадвал ": {"оғоз":" 2025-10-20T00: 00: 00Z"," end":" 2025-11-30T23: 59: 59Z"}
}
§ 201 "пешниҳод _ id ":" of _ 777"}

Барориши бонус (вақти корӣ)


POST/v1/бонус/грантҳо
Сарлавҳаҳо: Калиди X-Idempotency: grant_p001_of777
{
"player_id":"p_001,""offer_id":"of_777,""trigger":"deposit_captured,""amount_minor":10000
}
→ 200 {"grant _ id ": "gr _ 123"," status":" фаъол"}

Пешрафти Wager (хонед)


GET/ v1/bonus/grants/gr_123/progress
→ 200 {"талаб _ минор ": 200000, "саҳм _ minor": 45000," боқимонда _ minor": 155000," pct": 0. 225}

Бекор кардан/Бекор кардан


POST/ v1/bonus/grants/gr_123/revoke
Сарлавҳаҳо: Калиди X-Idempotency: revoke_gr_123
{"сабаб ": "қаллобӣ _ суръат"}
→ 200 {"статус ":" бозхонд"}

Ҳама зангҳои навиштан бо 'X-Idempotency-Key' ва 'X-Trace-Id' мебошанд.

8) Анти-сӯиистифода ва риояи

Маҳдудияти суръат: масъалаҳо/табдилдиҳӣ/кӯшиши амонатҳо (ҳисобкунакҳои Redis + TTL + Lua).

Тарҳи триггер: як амонат → як грант тибқи қоида.

Сегментатсия ва RG: истисно/маҳдудияти мустақилро истисно кунед; барои як литсензияи бренд/минтақа.

Блоки ихтилофи пешниҳодҳо: танҳо як бонуси истиқбол дар як вақт фаъол аст; афзалиятҳо.

Детектори аномалӣ: ҳисобҳои сершумор/дастгоҳҳо/ASN, зуд "сифр" -и вагон.

"Чор чашм" оид ба грантҳои калон ва тасҳеҳи дастӣ.

Аудити WORM ҳамаи тағиротҳои қоида/грант/табдилдиҳӣ.

9) Мушоҳида, ченакҳо ва SLO

SLO (нишонаҳо):

'грант. барориши p95 '(барориши → ҳисобшуда) ≤ 300-500 мс.
Навсозии 'wager _ progress p95' ≤ 200 м. ҳал '.
Бонуси чорабиниҳо. 'Дар автобуси p95 2 дақиқа аз ҳодиса рӯй дод.
"Грантҳо/табдили гумшуда/такрорӣ" = 0.

Нишондиҳандаҳо:

Меъёри/latency po 'барориш/табдил/бозхонд', сатҳи хатогӣ (business/4xx/5xx), 'IDEMPOTENCY _ MISMATCH'.
Табдили вагерӣ, ба ҳисоби миёна "вақт ба анҷом", мӯҳлати таносуб.
Арзиши Promo: 'promo _ cost' (ноболиғ) ва 'promo _ roi' дар гурӯҳҳо.
Анти-сӯиистифода: триггерҳои суръат аз ҷониби максимум bet/win рад карда мешаванд.

Пайгирӣ: Open-Telemetry дар занҷири 'trigger → grant → ҳамён. пешравии қарз →. навсозӣ → табдил '.

10) Ҳамгироӣ бо RGS/бозиҳо

Купонҳои ройгон Spins/Bets ройгон - тавассути 'entitlements' API: додани нишонаҳо, харошидан дар вақти корӣ, телеметрия бо истифода.

Макс Бет/ғолиб - қоидаҳо дар 'гаравҳо. гарави 'i' -ро тасдиқ кунед. ҳал кунед '; рамзҳои бозгашти 'BONUS _ RULE _ VIOLATION'.

Саҳм - нақша дар сатҳи 'Бет. ҳал карда шуд '(аз ҷониби' game _ type/provider _ id '), версияи схема.

11) DWH/BI ва гузоришҳо

Чорабиниҳои Outbox → Кӯли (биринҷӣ) → нуқра (dedup, SCD2) → Намоишҳои тиллоӣ:

'fact _ bonus _ grants', 'fact _ wager _ progress', 'fact _ bonus _ cost', 'fact _ promo _ roi'.
Тару тозаи SLA: нуқра ≤ 15 дақиқа, тилло ≤ 30-60 дақиқа.
Панелҳо: табдили пешниҳодҳо/сегментҳо, вақти пурра, саҳми бозиҳо, ҳодисаҳои сӯиистифода.

12) Бехатарӣ ва иқомат

MTLS + OAuth2 CC; доираи 'ы' promo: issue ',' promo: translation ',' promo: recoke '.

Калидҳо/нишонаҳо - ба як бренд/минтақа, кӯтоҳмуддат; асрори дар Vault/HSM.

Ҷудокунии PII: 'player _ id' - тахаллус; RLS po 'бренд/минтақа'.

Меъёрҳо ва квотаҳо барои барориш; муҳофизат аз тӯфонҳои бозгашт.

13) Рӯйхати санҷишҳо

Платформа/Оператор

Ҳама амалиётҳои пулӣ тавассути Wallet бо 'Idempotency-Key' мегузаранд.
Қоидаҳо/Мутобиқат санҷида мешаванд; "ҳарфи дукарата" -и рӯйдодҳо оид ба муҳоҷират.
Схемаҳои саҳм мутамарказ карда шуда, бо санҷишҳо фаро гирифта шудаанд.
Суръат ва зидди қаллобӣ имконпазир аст; "чор чашм" ба маблағи калон.
Outbox/CDC, DLQ ва такрори идоракунии 'бонус. '.
Панели панели SLO, Open: Telemetry, аудити WORM.
Дӯконҳои DWH барои ROI ва мувофиқат (RG/AML).

Интегратсия (RGS/ҳамён/CRM)

Санҷиши максимум bet/win; баргардонидани рамзи хатогии тиҷорат.
Ман 'trace _ id' ва 'idempotency _ key' -ро мепартоям.
Триггерҳо ва кафолатҳои таҳвил (webhooks имзо шудаанд).

14) Парчамҳои сурх (зидди намунаҳо)

Пур кардани бонус "дастӣ" мустақиман ба тавозун, аз Wallet гузаштан.

Набудани idempotency → грантҳо/табдили дукарата.

Гарав аз ҷониби 'bet. ҷойгир карда шудааст', ва на аз рӯи натиҷаҳои 'bet. ҳал'.

Схемаҳои саҳмгузорӣ вуҷуд надоранд ё онҳо дар кодекси провайдерҳо "ҳифз карда мешаванд".

Пешниҳодҳои ихтилофӣ ҳамзамон фаъол мешаванд.

Ягон суръат/зидди қаллобӣ ва аудити WORM вуҷуд надорад.

'bonus. 'events берун аз қуттии/CDC ҷойгир карда мешаванд.

Метрикаҳои Promo ба Ledger/BI илова намекунанд (намоиши ROI нест).

15) Сатри поён

Аксияҳои боэътимоди пуштибонӣ шартномаҳо ва ғайривариантҳо мебошанд, на "тавозун илова мекунанд. "Он қоидаҳоро аз пул ҷудо мекунад, пешрафтро аз рӯи натиҷаҳои воқеӣ баррасӣ мекунад, аблаҳӣ ва мушоҳидаҳоро кафолат медиҳад, аз сӯиистифода ҳимоят мекунад ва мувофиқатро таъмин мекунад. Бо чунин як аслӣ, маркетинг зуд ҳаракат мекунад, плеер шароити софдилро мебинад ва молия ва танзимгарон дар бораи хароҷот ва таъсири ҳар як пешниҳод тасаввуроти дақиқ мегиранд.