Skip to main content

Gamification & Loyalty

The purpose of these system modules is to enable the Casino Operator to include their user base in a loyalty program. This system provides a fully functional backend, allowing the Operator the flexibility to decide how users earn experience points and virtual currency, as well as how users spend this currency.

Getting Started​

The PEP Gamification & Loyalty modules are designed to work with a minimum bare integration, which means that you don't need to provide extensive integration to implement the Gamanza Gamification & Loyalty Platform. Let's go from the basic to more detailed integration.

Casino & Sports Transactions​

The minimum required data that Gamification & Loyalty requires to work are the Casino Game Transactions or Sports Transactions, once you start streaming these events to our API our platform can start processing those events, and base on your Loyalty contribution rules your players can start earning XP Points, Tokes, complete missions or competing in a tournament.

Casino Game Transactions​

A casino Game Transaction is defined as a round, composed by a bet and a win in the same request. Our API support to receive an array for a game player round, but if your operation doesn't support rounds you can send a separate request for a bet and a win.

tip

You can find the Open API specification for a Casino Game Transaction Round here: Game Transaction Event Round

Important Considerations​

  • The realMoneyAmount and the bonusMoneyAmount are conditional required, which means that at least one of the two needs to be greater than zero. If one is greater than zero the other property can be defined as zero

  • The exchangeRate is computed based on the default currency defined in your PEP instance. If your default currency is EUR and the transaction is defined in that currency you need to set here a constant value as 1. For more details about exchange rates please take a look to the annex document Exchange Rates

  • The transactionStatus that is use for Loyalty and Gamification is APPROVED, the other transaction status are ignored, so you can send only transactions with status APPROVED.

  • If you don't have gameSessionId to group all the transactions for a player game session you can send the value as the transactionId.

  • In the win transactions the betAmount is required because for some gamification rules (missions) you can specify objectives based on multipliers for the win amount, based on the bet amount. If you don't have this value you can sent zero but those kind of gamification rules are not going to work.

  • Regarding game additional properties: gameCategoryId, gameCategoryName, gameProviderId, gameProviderName, gameId, gameName those properties are very important for the PEP Gamification and Loyalty because base on those properties the Casino Operators can define rich mechanics, if you don't have unique identifiers you can send textual values that represent the unique identifier, but you need to ensure that those values never changes. For example

If you have internal unique identifiers for the Game Provider Pragmatic and in your database you have that provider under the id: Q84OTBmVVj and the game provider name is Pragmatic you need to pass those values. But lets imaging that you don't have that information but at least you know that the provider for that game transaction is Pragmatic you can send in the ID the same value as the name, but send always the same value, the system is case sensible, and any change in the ID makes our platform to detect a complete different game provider.

If you want to see all the games metadata generated by the Gamanza PEP please check your Admin website under Settings -> Casino Catalog

Casino CatalogCasino Catalog

Sports Transactions​

In the context of sports betting, the terms BET, SETTLEMENT, and CASHOUT refer to different stages of a betting transaction and its lifecycle. We use those lifecycles to allow you implement Gamification and Loyalty mechanics.

tip

You can find the Open API specification for a Sport Transaction here: Sport Transaction Event

Definitions​

A “bet” is a wager placed by a bettor on the outcome of a specific event, such as a sports game, match, or race. It involves predicting the result of an event and committing a certain amount of money based on the odds provided by the sportsbook.

  • SETTLEMENT:​

“Settlement” refers to the process of determining the outcome of a bet and adjusting the bettor’s account accordingly, based on the result of the event.

“Cashout” is a feature offered by many sportsbooks that allows bettors to settle their bet early, either to lock in a profit or minimize potential losses, before the event concludes.

Important Considerations​

  • transactionId Is the unique identifier for a sport transaction record, and it is required.
  • transactionIdReference Transaction id for reference to the origin bet transaction, required if the transaction type is SETTLEMENT or CASHOUT
  • The exchangeRate is computed based on the default currency defined in your PEP instance. If your default currency is EUR and the transaction is defined in that currency you need to set here a constant value as 1. For more details about exchange rates please take a look to the annex document Exchange Rates
  • When the platform is configured to contribute with Settled Bets, in the SETTLEMENT transaction type the realMoneyBalance needs to be greater than realMoneyBalanceBefore amount to instruct the platform that the player wins and apply properly the contribution rule defined.

Conclusions​

To have the Gamification & Loyalty platform up and running, you only need to implement two API integrations: Casino Game Transactions and Sports Transactions. Once you begin streaming these events to our API, the platform will automatically start processing them according to your loyalty rules, enabling users to earn experience points, virtual currency, and participate in missions or tournaments. The integration is designed to be minimal yet flexible, allowing you to quickly engage your user base in a loyalty program with minimal setup.

Takeaways🤗
  1. Two Simple API Integrations: Implement Casino Game Transactions and Sports Transactions to get the platform up and running.
  2. Minimal Integration Required: A streamlined process with minimal effort needed to start using the Gamification & Loyalty features.
  3. User Engagement: Easily reward users with experience points, virtual currency, and more, based on your loyalty rules.
  4. Flexibility: The system offers flexibility to define how users earn and spend rewards, enhancing customization options.
  5. Quick Setup: The platform is designed for fast deployment, enabling you to engage users right away.

In the next section, you can find more details of how you can send more events for more enrichment Gamification Mechanics