ניהול קידום ובונוסים ברמה האחורית

מאמר מלא

💡 18+. חומר הנדסי ומעשי עבור פלטפורמות/מפעילים וספקים. לא שיחה לשחק. על ידי ”ארנק” אנחנו מתכוונים לדג 'ר/ארנק עם ערבויות ACID, על ידי ”בונוסים” - מקדמים שמשפיעים על האיזון והתנאים של המשחק.

1) מדוע לקחת את הפרומו למקום אחורי נפרד

הזמנות כספיות. בונוס על ”שיווי משקל נוסף”: זהו חוזה עם תנאים (ואגר, תרומה למשחקים, הימור מקסימלי/ניצחון).

קצב השינוי. צוותי שיווק משחררים קמפיינים מדי יום - אתה צריך מנוע כללי הצהרה וחזרה.

נגד ניצול/ציות. KYC/RG/AML, מהירות, קטמנטציה, משימות ארבע עיניים להצעות יקרות.

יכולת תצפית ודיווח. SLO, עלות פרומו, השפעה על GGR/NGR/LTV.

עיקרון: ליבת הפרומו היא שירות נפרד עם מכונות סטטוס משלו, וכסף נע רק דרך הארנק, באופן אידמפוטי.

2) טיפולוגיה בונוס ואינווריאנטים

משחק הפקדה (100% לפני X): נצבר לאחר לכידת ההפקדה, Vager X X.

קשבק: מחושב על ידי חלון זמן/משחקים, יכול להיות דביק/לא דביק.

ספינים חופשיים/הימורים חופשיים: קופונים/אסימונים עם מחיר לספין/הימור, בריכת RTP קבועה.

משימות/משימות: task # progress ach pregime.

טורנירים/אירועי טיסה: תרומה של אירועים, דירוג, פרס כספי.

אינווריאנטים:

דביק: לא ניתן להפיק עד שהתנאים מתקיימים.
מקס הימור/מקס לנצח: מגבלות על ההימור/תשלום מקרנות בונוס.
תרומה: תרומה לפי משחק (למשל: חריצים = 100%, לחיות = 10%).
תקופת תוקף בונוס ואגרטל חלון.

3) ארכיטקטורת שירות בונוס


מנהל ─Promo ─Rules מנוע API/זכאות
│
├─Bonus לדג 'ר (מעמד של הצעות)
מנוע ├─Wagering (התקדמות)
├─Anti abuse (גבולות/הונאה/מהירות)
└─Outbox (אירועים) ─Kafka/Pulsar ─BI/DWH/CRM

Wallet/Ledger── פקודות אידמפוטנטיות ───┘

כללי מנוע - תנאים הצהרתיים (מקטעים, גיאו/רישיון, ערוצים, KYC/RG).

הימור מנוע - ספירת תרומות מ 'bt. התיישב '/' ארנק. חיוב	קרדיט ".
בונוס לדג 'ר הוא מקור של אמת במדינות בונוס/משימה.
בונוס פרסום אמין. הונפקה	התקדמות. מעודכן

4) מודל נתונים (מפושט)

'bonus _ grantfost

גרנט _ id, , , סוג, מטבע, , דביק, , מעמד	פעילה	הפסיק את זה	הושלם	פג תוקף התוקף	בוטל), issued_at, expires_at, brand_id, אזור, idempotency_key'

Wager _ progress &pos

גרנט _ id, , , ,

"contribution _ schema&fos

'shema _ id, כללים: [ _ game _ type: "חריץ", pct: 100), [game _ type: "live", pct: 10 ] "

'bonus _ ledger _ inter' (ביקורת)

entry _ id, grant_id, action (סוגיה)	לצרוך	לבטל את ביטול	לפוג את תוקפו	) amount_minor, הגיון, occurred_at, trace_id'

5) מכונות מצב וסאגות

5. גיליון 1 - סאגה

1. זכאות. בדוק (קטע, RG/KYC, מהירות)

2. גרנט. ליצור (סטטוס = ”מונפק”)

3. ארנק. בונוס [ אשראי ] (אידיאמפוטנטי; בדביקות - בונוס תת איזון)

4. הפעלה (סטטוס = ”פעיל”)

5. פולט בונוס. הוצא &fost

Rollback: כאשר נופל בשלב 3 'ac.grant' מענק. לבטל '+ אירוע' בונוס. בוטל '.

5. 2 ואגר התקדמות

Na 'bet. תרומת ספירה מיושבת = "יתד _ מינור contribution_pct' (או לפי חוקי ניצחון/הפסד).

עדכן את wager _ progress' באופן אטומי; כאשר 100% הוא הגיע - ”שלם”.

5. 3 סיום (לצרוך)

# ארנק שלם. convert_bonus_to_cash' (אם לא דביק) או להסיר הגבלות פלט.

פולט בונוס. נצרך ".

5. 4 תפוגה/החזרה

לפי חוק ההונאה, הפיצויים לפי המדיניות אפשריים.

6) חוזי ארנק (רק באמצעות API, תמיד אידמפוטנטים)

בונוס הצטברות


פוסט/v1/ארנק/קרדיט
כותרות: X-Idempotency-Key: bonus_grant_123
{
"player_id":"p_001," "סכום": ["מינור _ יחידות": 10000 "מטבע": "EUR" balance_type":"bonus, "התייחסות": "grent _ id':" gr _ 123 "," propose _ id': "" של _ 777 "
}
# 200 "סטטוס": "קרדיט", "כניסה _ id':" e _ 9001 "

המרה למטמון כאשר מתקיימים התנאים


פוסט/v1/ארנק/המרה
כותרות: X-Idempotency-Key: bonus_convert_gr_123
{
” ” ” ” ” ”, התייחסות ”: [” grant _ id': ”gr _ 123”]
}
* 200 "סטטוס": "המרה", "כניסה _ id':" e _ 9010 "

בדוק מקס הימור/מקס לנצח - בצד RGS/ארנק משמר:

מבקש הימורים. האישור נדחה על ידי קוד ”BONUS _ MAX _ BET _ חורג”.

7) API של שירות פרומו (תבניות)

צור הצעה (מנהל)


פוסט/v1/מציע
{
”שם”: ”ברוכים הבאים 100% עד 100 אירו”, ”סוג”: ”deposit _ match”, ”params':” fame _ pct ”: 100,” cap _ minor ”: 10000,” wager _ x ”: 20,” dicky ”: נכון,”  ”, זכאות”: ” ”: ”A” ” ”, ”אזורים”:  ”קטע”: ”new _ depositers”), ”לוח זמנים”: ”2025-10-20: 00-00Z”, ”סוף”: ”2025-11-30T23: 59: 59Z”
}
* 201 * "הצעה _ id':" של _ 777 "

הנפקת בונוס (זמן ריצה)


פוסט/v1/בונוס/מענקים
כותרות: X-Idempotency-Key: grant_p001_of777
{
”player_id":"p_001,""offer_id":"of_777,""trigger":"deposit_captured,""amount_minor":10000”
}
* 200 ["grant _ id':" gr _ 123 "," סטטוס ":" פעיל "]

הימור על התקדמות (קרא)


GET/ v1/bonus/grants/gr_123/progress
* 200 "דרושים _ מינור": 200000, "תרם _ מינור": 45000, "נשאר _ מינור": 155000, "pct': 0. 225}

ריק/ביטול


פוסט/ v1/bonus/grants/gr_123/revoke
כותרות: X-Idempotency-Key: revoke_gr_123
”סיבה ”: ”הונאה _ מהירות”
# 200 (”סטטוס ”:” בוטל”)

כל שיחות הכתיבה הן עם "X-Idempotency-Key" ו- "X-Trace-Id'.

8) נגד ניצול לרעה וציות

מגבלות מהירות: בעיות/המרות/ניסיונות הפקדה (רדיס ספונטרס + TTL + Lua).

didup טריגר: הפקדה אחת פי מענק אחד על פי חוק.

קטגמנטציה ו-RG: אל תשלול את עצמך/הגבלה; לפי רישיון מותג/אזור.

בלוק של ניגוד הצעות: רק בונוס אחד רצוי פעיל בכל פעם; סדר עדיפויות.

גלאי אנומליה: מספר חשבונות/התקנים/ASN, מהר ”אפסים” של הבקבוק.

”ארבע עיניים” על מענקים גדולים והתאמות ידניות.

ביקורת תולעת של כל שינויי כלל/גרנט/המרה.

9) יכולת תצפית, מדדים ו ־ SLO

SLO (ציוני דרך):

'גרנט. גיליון p95 '(להוצאת קרדיט) על 300-500 ד'.
עדכן את wager _ progress p95 'value 200ms מאז' bt הסתדר '.
בונוס של אירועים. 'באוטובוס p95 2 דקות ממה שקרה.
”מענקים/שכפולים אבודים/המרות” = 0.

מדדים:

Rate/latency 'Egyption/control', rate-rate (business/4xx/5xx), IDEMPOTENCY _ MISMATCH.
המרת Vager, ממוצע ”זמן להשלמה”, פרופורציה איחור.
עלות פרומו: "promo _ cost' (מינור) ו-" promo _ roi "על קוהורטות.
אנטי-ניצול: מפעיל מהירות נדחה על ידי מקס הימור/win.

מעקב: OpenTelemetry on the chain 'trigger # מענק לארנק. □ התקדמות באשראי. # עדכון המרה '.

10) אינטגרציה עם RGS/games

ספינים חופשיים/קופוני הימורים חופשיים - באמצעות 'entitionals' API: הנפקת אסימונים, פיטורים בזמן ריצה, טלמטריה באמצעות שימוש.

מקס הימור/ניצחון - שולט בהימורים. תאשר הימורים. ליישב '; החזר קודים 'BONUS _ RULE _ הפרה'.

תרומה - תוכנית ברמת ההתערבות. מיושב '(על ידי' game _ type/despect _ id'), סכימה גרסה.

11) DWH/BI ודיווחים

Eutbox Events # Lake (bronze) # Silver (dedup, SCD2) # Gold Showcases:

'fact _ בונוס _ מענקים', 'עובדה _ הימור _ קידמה', 'עובדה _ בונוס _ עלות', 'עובדה _ פרומו _ רוי'.
סלה רעננות: Silver shood 15 min, Gold shood 30-60 min.
פאנלים: המרה על ידי הצעות/מקטעים, זמן להשלמה, תרומה על ידי משחקים, תקריות התעללות.

12) בטיחות ותושבות

MTLS + OAuth2 CC; היקף 'promo: ””, ”promo: להמיר”, ”promo: לבטל”.

מפתחות/אסימונים - לכל מותג/אזור, קצר ימים; סודות בכספת/HSM.

בידוד PII: "שחקן _ id' - שם בדוי; RLS ”מותג/אזור”.

מגבלות קצב ומכסות הוצאה; הגנה מפני סופות מגש.

13) רשימות בדיקה

פלטפורמה/אופרטור

[ ] כל העסקאות הכספיות עוברות דרך ארנק עם 'Idempotency-Key'.

[ ] כללים/זכאות מוגבלים; ”אות כפולה” של אירועים על נדידה.

[ תוכניות התרומה ] מרוכזות, מכוסות במבחנים.

[ מהירות ] ואנטי הונאה מופעלים; ”ארבע עיניים” על סכומים גדולים.

[ ] Outbox/CDC, DLQ והצליח שידור חוזר עבור 'בונוס. '.

[ ] לוחות מחוונים, OpenTelemetry, ביקורת תולעת.

[ ] חנויות DWH עבור ROI וציות (RG/AML).

אינטגרציות (RGS/ארנק/CRM)

[ ] בדיקת מקס הימור/win; מחזיר את קוד הטעות העסקית.

[ ] אני זורק "trace _ id' ו-" idempotency _ key ".

[ ] Deadup מפעיל וערובות משלוח (חתומות באינטרנט).

14) דגלים אדומים (נגד תבניות)

לחייב את הבונוס ”ידנית” ישירות לתוך האיזון, לעקוף את ארנק.

חוסר אידמפוטנטיות = מענקים כפולים/המרות.

ההתערבות נשקלת על-ידי "ב", ולא על-פי התוצאות של "ב.

אין תוכניות תרומה או שהן ”מוגנות” בקוד הספקים.

הצעות סותרות מופעלות בו זמנית.

אין מהירות/אנטי הונאה וביקורת תולעת.

"בונוס. יציאות מתפרסמות תוך עקיפת התיבה/המרכז לבקרת מחלות.

מדדי פרומו לא מסתדרים לדג 'ר/BI (בלי תצוגות ROI).

15) השורה התחתונה

פרומואים אחוריים אמינים הם חוזים ואינווריאנטים, לא "להוסיף איזון. "היא מפרידה בין כללים לכסף, רואה התקדמות בהתאם לתוצאות בפועל, מבטיחה אידמפוטנטיות ויכולת תצפית, מגינה מפני התעללות ומבטיחה ציות. עם ליבה כזו, השיווק נע במהירות, השחקן רואה תנאים ישרים, וכספים ורגולטורים מקבלים תמונה מדויקת של המחיר וההשפעה של כל הצעה.