Bet Placement
Event Key
ootb_sports_bet_placed
This event should be sent each time a sports bet is placed and approved by the operator.
Event Key | Event Name | Type |
---|---|---|
ootb_sports_bet_placed | OOTB Sports Bet Placed | Simple event |
Event Structure
The mandatory properties (tenant
, timestamp
, event
, and customer
) are required for all events and documented in detail on the Mandatory Properties page.Below is the JSON structure for the context-specific properties of the Sports Bet Placed event:
{
"context": {
"ootb_betslip_key": "cniowfh0193duf879cn2",
"ootb_bet_date_time": "2024-05-27T10:30:00Z",
"ootb_betslip_status": "open",
"ootb_platform": "iOS",
"ootb_channel": "mobile",
"ootb_license": "licenseXYZ",
"ootb_bet_key": "selection789",
"ootb_bet_stake": 100.00,
"ootb_bet_bonus": 0.00,
"ootb_bet_sel_stake": 50.00,
"ootb_bet_sel_bonus": 0.00,
"ootb_is_live": 1,
"ootb_odds_num": 5,
"ootb_odds_den": 1,
"ootb_dec_price": 6.00,
"ootb_american_price": -120,
"ootb_selection_key": "3647893264",
"ootb_selection_name": "Manchester United",
"ootb_market_key": "3647893264",
"ootb_market_name": "Match Result",
"ootb_event_date_time": "2024-05-27T10:30:00Z",
"ootb_event_key": "67967899",
"ootb_event_name": "Manchester United vs Liverpool",
"ootb_meeting_key": "67839642",
"ootb_meeting_name": "Premier League",
"ootb_class_key": "67839642",
"ootb_class_name": "English",
"ootb_discipline_key": "13",
"ootb_discipline_name": "football",
"ootb_leg_num": 1,
"ootb_leg_type": "To win",
"ootb_each_way": "Yes",
"ootb_bet_type": "Multiple",
"ootb_is_free": false,
"ootb_num_selections": 2,
"ootb_brand": "skin123"
}
}
Parameters
Parameter Key | Parameter Name | Type | Description |
---|---|---|---|
ootb_betslip_key | Bet Slip Key | String | Identifier for the bet slip or ticket (group of bets). |
ootb_bet_date_time | Bet Date Time | Timestamp | UTC timestamp when the bet was placed. |
ootb_betslip_status | Bet Slip Status | String | Status of the bet slip (open , win , loss ). |
ootb_platform | Platform | String | Platform from which the bet was placed (e.g., iOS, Android). |
ootb_channel | Channel | String | Channel used for the bet (e.g., mobile, web). |
ootb_license | License | String | Regulatory license identifier. |
ootb_bet_key | Bet Key | String | Unique identifier for the individual bet. |
ootb_bet_stake | Bet Stake | Number | Total cash stake amount for the bet. |
ootb_bet_bonus | Bet Bonus | Number | Bonus amount included in the stake (e.g., free bet). |
ootb_bet_sel_stake | Bet Selection Stake | Number | Stake amount allocated to this selection. |
ootb_bet_sel_bonus | Bet Selection Bonus | Number | Bonus amount allocated to this selection. |
ootb_is_live | Is Live | Boolean | 1 if the bet was placed during a live event; 0 otherwise. |
ootb_odds_num | Odds Numerator | Number | Fractional numerator for the selection odds. |
ootb_odds_den | Odds Denominator | Number | Fractional denominator for the selection odds. |
ootb_dec_price | Decimal Odds Price | Number | Decimal (European) price for the selection odds. |
ootb_american_price | American Odds Price | Number | American odds price for the selection odds. |
ootb_selection_key | Selection Key | String | Unique ID for the selection in the operator’s database. |
ootb_selection_name | Selection Name | String | Name of the chosen selection (e.g., Manchester United). |
ootb_market_key | Market Key | String | Unique ID for the market in the operator’s database. |
ootb_market_name | Market Name | String | Name of the market (e.g., Match Result). |
ootb_event_date_time | Event Date Time | Timestamp | UTC timestamp of the scheduled start time of the sporting event. |
ootb_event_key | Event Key | String | Unique ID for the sporting event. |
ootb_event_name | Event Name | String | Name of the sporting event (e.g., Man Utd vs Liverpool). |
ootb_meeting_key | Meeting Key | String | Unique ID for the competition or league. |
ootb_meeting_name | Meeting Name | String | Name of the competition (e.g., Premier League). |
ootb_class_key | Class Key | String | Unique ID for the competition category. |
ootb_class_name | Class Name | String | Name of the competition category (e.g., English). |
ootb_discipline_key | Discipline Key | String | Unique ID for the sport. |
ootb_discipline_name | Discipline Name | String | Name of the sport (e.g., football). |
ootb_leg_num | Leg Number | Number | Position of this selection within a multi-leg bet. |
ootb_leg_type | Leg Type | String | Type of leg (e.g., To win, Handicap, Outright). |
ootb_each_way | Each Way | Boolean | Yes for win & place bets (common in horse racing). |
ootb_bet_type | Bet Type | String | Bet structure (Multiple, Single, System). |
ootb_is_free | Is Free Bet | Boolean | true if the bet was funded solely by bonus credit; false otherwise. |
ootb_num_selections | Number of Selections | Number | Number of selections in the bet (e.g., 2 for a double). |
ootb_brand | Brand | String | Brand or “skin” under which the bet was placed. |
Explanation
- event: Set to
ootb_sports_bet_placed
to indicate a placed & approved sports bet. - context:
ootb_betslip_key
,ootb_bet_key
,ootb_selection_key
,ootb_market_key
,ootb_event_key
,ootb_meeting_key
,ootb_class_key
,ootb_discipline_key
: Link to your operator’s database identifiers for bet slip, individual bet, selection, market, event, competition (meeting), category (class) and sport (discipline).ootb_selection_name
,ootb_market_name
,ootb_event_name
,ootb_meeting_name
,ootb_class_name
,ootb_discipline_name
: Human-readable names corresponding to each of the above keys.ootb_bet_date_time
,ootb_event_date_time
,ootb_betslip_status
: Capture when the bet was placed, when the event starts, and the current status of the bet slip.ootb_bet_stake
,ootb_bet_bonus
,ootb_bet_sel_stake
,ootb_bet_sel_bonus
: Monetary amounts for the overall stake and bonus and per-selection stake and bonus.ootb_odds_num
,ootb_odds_den
,ootb_dec_price
,ootb_american_price
: Provide odds in fractional (numerator/denominator), decimal, and American formats for flexible downstream processing.ootb_leg_num
,ootb_leg_type
,ootb_each_way
,ootb_bet_type
,ootb_num_selections
: Describe complex bet structures (leg ordering, type of leg, each-way bets, bet type, number of selections).ootb_is_live
,ootb_is_free
: Flags indicating whether the bet was placed in-play and whether it was funded solely by bonus credit.ootb_platform
,ootb_channel
,ootb_license
,ootb_brand
: Standard metadata for segmentation and analysis (client platform, channel, regulatory license, brand/skin).
Updated 3 days ago