Διαχείριση προαγωγών και πριμοδοτήσεων σε επίπεδο εφεδρείας

Πλήρες άρθρο

💡 18+. Μηχανικό και πρακτικό υλικό για πλατφόρμες/φορείς εκμετάλλευσης και παρόχους. Δεν είναι μια κλήση για να παίξει. Με το «πορτοφόλι» εννοούμε το Ledger/Wallet με εγγυήσεις ACID, με «μπόνους» - προωθητές που επηρεάζουν την ισορροπία και τις συνθήκες του παιχνιδιού.

1) Γιατί να πάρει το promo σε ένα ξεχωριστό backend

Νομισματικές αναλλοίωτες. Bonus ≠ «προστιθέμενη ισορροπία»: πρόκειται για σύμβαση με όρους (vager, συνεισφορά σε παιχνίδια, μέγιστο στοίχημα/νίκη).

Ρυθμός μεταβολής. Οι ομάδες μάρκετινγκ δημοσιεύουν καθημερινά εκστρατείες - χρειάζεστε μια δηλωτική μηχανή κανόνων και rollback.

Καταπολέμηση της κατάχρησης/συμμόρφωσης. KYC/RG/AML, ταχύτητα, κατάτμηση, εργασίες τεσσάρων ματιών για ακριβές προσφορές.

Παρατηρησιμότητα και υποβολή εκθέσεων. SLO, promo cost, αντίκτυπος στην GGR/NGR/LTV.

Αρχή: Ο πυρήνας promo είναι μια ξεχωριστή υπηρεσία με τις δικές του μηχανές κατάστασης, και το χρήμα κινείται μόνο μέσω του πορτοφολιού, ιδανικά.

2) Τυπολογία πριμοδοτήσεων και αναλλοίωτες

Ταίριασμα καταθέσεων (100% πριν από το Χ): δεδουλευμένη μετά τη λήψη της κατάθεσης, vager X ×.

Cashback: υπολογίζεται από το χρονικό παράθυρο/παιχνίδια, μπορεί να είναι κολλώδες/μη κολλώδες.

Δωρεάν περιστροφές/δωρεάν στοιχήματα: κουπόνια/μάρκες με τιμή ανά περιστροφή/στοίχημα, σταθερή ομάδα RTP.

Αναζητήσεις/αποστολές: έργο → πρόοδο → ανταμοιβή.

Τουρνουά/εκδηλώσεις πτήσης: συμβολή εκδηλώσεων, βαθμολογία, χρηματικό έπαθλο.

Αναλλοίωτες:

Sticky: δεν μπορεί να είναι έξοδος μέχρι να εκπληρωθούν οι προϋποθέσεις.
Max στοίχημα/Max νίκη: όρια στο στοίχημα/πληρωμή από bonus κεφάλαια.
Συνεισφορά: συνεισφορά ανά παιχνίδι (π.χ. slots = 100%, live = 10%).
Λήξη: Περίοδος ισχύος πριμοδότησης και παράθυρο ατμού.

3) Αρχιτεκτονική υπηρεσιών πριμοδότησης


Admin ─Promo ─Rules API κινητήρα/επιλεξιμότητα
│
Ledger (κατάσταση των προσφορών)
Κινητήρας (πρόοδος)
- Κατάχρηση (όρια/απάτη/ταχύτητα)
(γεγονότα)  

Εντολή Idempotent

Κανόνες Κινητήρας - δηλωτικοί όροι (τμήματα, geo/άδεια, κανάλια, KYC/RG).

Κινητήρας στοιχηματισμού - μετρά τις συνεισφορές από το πορτοφόλι "bet. setted "/". χρέωση	πίστωση ".
Το Bonus Ledger είναι πηγή αλήθειας για τις καταστάσεις μπόνους/αποστολής.
Outbox/CDC - αξιόπιστη έκδοση 'bonus. εκδοθέν	την πρόοδο. επικαιροποιημένο

4) Υπόδειγμα δεδομένων (απλουστευμένο)

"bonus _ gran

"grant _ id, , , τύπος, νόμισμα, , κολλώδες, , , , καθεστώς (εκδοθέν	ενεργό	παύση	ολοκληρώθηκε	λήγει	ανακλήθηκε), issued_at, expires_at, brand_id, περιφέρεια, idempotency_key'

'wager _ progress'

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

'contribution _ scheme'

' schema _ id, κανόνες: [{game _ type:» slot», pct: 100}, {game _ type:» live», pct: 10}'

'bonus _ ledger _ entry' (έλεγχος)

'entry _ id, grant_id, δράση (θέμα)	κατανάλωση	ανάκληση	λήγει	αναπροσαρμογή), amount_minor, λογική, occurred_at, trace_id'

5) Μηχανές κατάστασης και σάγκα

5. 1 Έκδοση - Saga

1. επιλεξιμότητα. Έλεγχος (τμήμα, RG/KYC, ταχύτητα)

2. επιχορήγηση. δημιουργία (καθεστώς = «εκδοθέν»)

3. πορτοφόλι. πίστωση [bonus] (idempotent; στο κολλώδες - σε υποισοζύγιο πριμοδότησης)

4. ενεργοποιείται (κατάσταση = 'ενεργός')

5. εκπέμπουν μπόνους. εκδοθείσες "

Rollback: όταν πέφτει στο στάδιο 3 της επιχορήγησης των →. ακύρωση πριμοδότησης «+ event». ανακλήθηκε ".

5. 2 Πρόοδος Vager

Να 'μπετ. «εισφορά καταμέτρησης =» μερίδιο _ ήσσονος σημασίας contribution_pct' (ή σύμφωνα με τους κανόνες κέρδους/ζημίας).

Ενημέρωση 'wager _ progress' ατομικά; όταν επιτυγχάνεται το 100% - «πλήρης».

5. 3 Φινίρισμα (κατανάλωση)

πλήρες πορτοφόλι των →. (εάν δεν κολλάει) ή αφαιρέστε τους περιορισμούς εξόδου.

εκπέμπουν μπόνους. καταναλωθείσα ".

5. 4 Λήξη/Ανάκληση

Με το 'expires _ at' ή τον κανόνα της απάτης → 'ανάκληση' (idempotent), είναι δυνατή η αποζημίωση σύμφωνα με την πολιτική.

6) Συμβάσεις με πορτοφόλια (μόνο μέσω API, πάντα ταυτόσημες)

Προσαύξηση


POST/v1/πορτοφόλι/πίστωση
Κεφαλίδες: X-Idempotency-Key: bonus_grant_123
{
«player_id":"p_001,» «ποσό «: {«minor _ units «: 100000», νόμισμα»:» EUR»} «,» balance_type":"bonus, «reference «: {«grant _ id «: «gr _ 123»,» offer _ id»:» of _ 777»}
}
200 {"status": "credited", "entry _ i →:" e _ 9001 "}

Μετατροπή σε κρυφή μνήμη όταν πληρούνται οι προϋποθέσεις


POST/v1/πορτοφόλι/μετατροπή
Κεφαλίδες: X-Idempotency-Key: bonus_convert_gr_123
{
" " " " " " " " , reference ": {"grant _ id":" gr _ 123"}
}
200 {"status": "transformed", "entry _ i →:" e _ 9010 "}

Check max bet/max win - on the RGS/Wallet Guard side:

τα στοιχήματα που ζητούνται. εγκρίνει "απορρίπτεται με τον κωδικό" BONUS _ MAX _ BET _ OVERED ".

7) API υπηρεσιών προώθησης (υποδείγματα)

Δημιουργία προσφοράς (admin)


POST/v1/προσφορές
{
"name": "Welcome 100% up ", "type": "deposit _ match", "param : {" match _ pct ": 100," cap _ minor ": 10000," wager _ x ": 20," sticky ": true", " ," elability ": {" brands ": [" A "]," τμήμα ":" νέο _ καταθέτες "}," πρόγραμμα ": {" έναρξη ":" 2025-10-20T00: 00: 00Z "," τέλος ":" 2025-11-30T23: 59: 59Z "}
}
201 {"προσφορά _ i →:" of _ 777 "}

Έκδοση πριμοδότησης (χρόνος εκτέλεσης)


POST/v1/πριμοδότηση/επιχορηγήσεις
Κεφαλίδες: X-Idempotency-Key: grant_p001_of777
{
"player_id":"p_001,""offer_id":"of_777,""trigger":"deposit_captured,""amount_minor":10000
}
200 {"grant _ i →:" gr _ 123 "," status ":" active "}

Πρόοδος στο στοίχημα (ανάγνωση)


Λήψη/ v1/bonus/grants/gr_123/progress
200 {"απαιτούμενο _ μικρό": 200000, "συνεισέφερε _ μικρό": 45000, "υπόλοιπο _ μικρό": 155000, "pc →: 0. 225}

Κενό/Ανάκληση


ΤΑΧΥΔΡΟΜΕΙΑ/ v1/bonus/grants/gr_123/revoke
Κεφαλίδες: X-Idempotency-Key: revoke_gr_123
{«λόγος «: «απάτη _ ταχύτητα»}
200 {«status «:» revoked»}

Όλες οι κλήσεις εγγραφής είναι με 'X-Idempotency-Key' και 'X-Trace-Id'.

8) Καταπολέμηση των καταχρήσεων και συμμόρφωση

Όρια ταχύτητας: εκδόσεις/μετατροπές/απόπειρες καταθέσεων (Redis counters + TTL + Lua).

Ενεργοποίηση dedup: μία κατάθεση → μία επιχορήγηση κατά κανόνα.

Διαχωρισμός και RG: εξαιρούνται οι αυτοεξαιρούμενες/οριακές τιμές. ανά άδεια εμπορικού σήματος/περιφέρειας.

Αποκλεισμός των συγκρούσεων προσφορών: μόνο ένα επίδομα καλωσορίσματος είναι ενεργό κάθε φορά· προτεραιότητες.

Ανιχνευτής ανωμαλίας: πολλαπλοί λογαριασμοί/συσκευές/ASN, γρήγορος «μηδενισμός» του αεραγωγού.

«Τέσσερα μάτια» για τις μεγάλες επιχορηγήσεις και τις χειρωνακτικές προσαρμογές.

Έλεγχος του WORM για όλες τις αλλαγές κανόνα/επιχορήγηση/μετατροπή.

9) Παρατηρησιμότητα, μετρήσεις και SLO

SLO (ορόσημα):

'grant. έκδοση p95 '(issue→credited) ≤ 300-500 мс.
Ενημέρωση 'stager _ progress p95' ≤ 200ms από το 'bet. setted'.
Πριμοδότηση εκδηλώσεων. "Στο p95 λεωφορείο ≤ 2 λεπτά από ό, τι συνέβη.
«Χαμένες/διπλές επιχορηγήσεις/μετατροπές» = 0.

Μετρήσεις:

Επιτόκιο/καθυστέρηση по «έκδοση/μετατροπή/ανάκληση», επιτόκιο σφάλματος (business/4xx/5xx), «IDEMPOTENCY _ MISMATCH».
Μετατροπή Vager, μέσος όρος 'time-to-complete', αναλογία καθυστέρηση.
Promo κόστος: 'promo _ cost' (minor) και 'promo _ roi' για τις ομάδες.
Κατά της κατάχρησης: η ταχύτητα ενεργοποιεί την απόρριψη με το μέγιστο στοίχημα/νίκη.

Παρακολούθηση: OpenTelemetry on the chain 'trigger → grand → πορτοφόλι. πρόοδος στον τομέα των πιστώσεων. επικαιροποίηση → μετατροπή '.

10) Ενσωμάτωση στα ΣΕΚ/παιχνίδια

Free Spins/Free Bets κουπόνια - μέσω 'entitlement API: έκδοση σημάτων, διάλυση σε χρόνο λειτουργίας, τηλεμετρία με χρήση.

Max στοίχημα/νίκη - κανόνες στα στοιχήματα. έγκριση στοιχημάτων «и». διακανονισμός "· κωδικοί επιστροφής «BONUS _ RULE _ VIOLATION».

Συνεισφορά - σύστημα σε επίπεδο στοιχήματος. settled '(by' game _ type/provider _ id '), schema version.

11) DWH/BI και εκθέσεις

Outbox events → Lake (bronze) → Silver (dedup, SCD2) → Gold showcases:

'fact _ bonus _ grants', 'fact _ stager _ progress', 'fact _ bonus _ cost', 'fact _ promo _ roi'.
SLA φρεσκάδα: Ασήμι ≤ 15 λεπτά, Χρυσό ≤ 30-60 λεπτά.
Ομάδες: μετατροπή από προσφορές/τμήματα, χρονικά ολοκληρωμένη, συμβολή από παιχνίδια, περιστατικά κατάχρησης.

12) Ασφάλεια και διαμονή

mTLS + OAuth2 CC· 'promo: issue', 'promo: convert', 'promo: revoke'.

Κλειδιά/μάρκες - ανά εμπορικό σήμα/περιφέρεια, βραχύβια· μυστικά στο θησαυροφυλάκιο/HSM.

απομόνωση PII: 'player _ id' - ψευδώνυμο; RLS по «εμπορικό σήμα/περιφέρεια».

Όρια συντελεστών και ποσοστώσεις έκδοσης· προστασία από καταιγίδες επανασυσκευής.

13) Κατάλογοι ελέγχου

Πλατφόρμα/Φορέας εκμετάλλευσης

Όλες οι νομισματικές συναλλαγές περνούν από το πορτοφόλι με το «Idempotency-Key».
Οι κανόνες/επιλεξιμότητα έχουν εκδοθεί. «διπλό γράμμα» γεγονότων σχετικά με τη μετανάστευση.
Τα καθεστώτα εισφορών είναι συγκεντρωτικά, καλύπτονται από δοκιμές.
Επιτάχυνση και καταπολέμηση της απάτης· «τέσσερα μάτια» σε μεγάλα ποσά.
Outbox/CDC, DLQ και διαχείριση replay για 'bonus. '.
Ταμπλό SLO, OpenTelemetry, έλεγχος WORM.
Καταστήματα DWH για ROI και συμμόρφωση (RG/AML).

Ενοποίηση (ΣΕΚ/πορτοφόλι/CRM)

Έλεγχος μέγιστου στοιχήματος/νίκης; επιστροφή του κωδικού επιχειρηματικού σφάλματος.
Ρίχνω 'trace _ id' και 'idempotency _ key'.
Σκανδάλες και εγγυήσεις παράδοσης (υπογεγραμμένα webhooks).

14) Κόκκινες σημαίες (αντίγραφα)

Φόρτιση του μπόνους «χειροκίνητα» απευθείας στο ισοζύγιο, παρακάμπτοντας το πορτοφόλι.

Έλλειψη ευελιξίας → διπλές επιχορηγήσεις/μετατροπές.

Το στοίχημα θεωρείται από το «bet. τοποθετημένο» και όχι σύμφωνα με τα αποτελέσματα του «bet. settled».

Δεν υπάρχουν συστήματα εισφοράς ή «προστατεύονται» στον κώδικα των παρόχων.

Ταυτόχρονα ενεργοποιούνται αντικρουόμενες προσφορές.

Δεν υπάρχει ταχύτητα/καταπολέμηση της απάτης και έλεγχος WORM.

"bonus. "Τα events αναρτώνται παρακάμπτοντας outbox/CDC.

Οι μετρήσεις Promo δεν προσθέτουν στο Ledger/BI (χωρίς προβολές ROI).

15) Η τελική γραμμή

Τα αξιόπιστα promos υποστήριξης είναι συμβάσεις και αναλλοίωτες, όχι "προσθέτουν ισορροπία. "Διαχωρίζει τους κανόνες από τα χρήματα, εξετάζει την πρόοδο σύμφωνα με τα πραγματικά αποτελέσματα, εγγυάται την ιδιοτέλεια και την παρατηρησιμότητα, προστατεύει από την κατάχρηση και εξασφαλίζει τη συμμόρφωση. Με έναν τέτοιο πυρήνα, το μάρκετινγκ κινείται γρήγορα, ο παίκτης βλέπει ειλικρινείς συνθήκες, και τα οικονομικά και οι ρυθμιστικές αρχές παίρνουν μια ακριβή εικόνα του κόστους και του αποτελέσματος κάθε προσφοράς.