Recommendations API
Last updated
Was this helpful?
Last updated
Was this helpful?
Recommendations API is an API for providing recommendations to an Operator for casino lobbies, user lobbies and games based on player's interactions (gameplays) on Hub88 platform.
Casino lobby recommendation: The endpoint provides a list of recommended top games based on overall unique users’ interactions with the games. The list of games returned is sorted and scored from high to low, a higher score indicates an increased possibility of interaction with the game.
/recommendations/lobby
RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.
Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.
The device platform type for which game recommendations are provided. It's the current device platform the user is accessing the Operator's site from.
The unique user name of the player on Operator's side. The parameter is required to reference if a user exists on Hub88 platform, i.e. has launched a game at least once.
The language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.
The currency which has been currently enabled for the wallet on the site. This value can be provided to help improve the quality of recommendations, in a situation where user switches between multiple wallets (currencies) to play games on the site. Optional context parameter.
The country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.
The limits for the count of returned game recommendations. Default limit: 50, Maximum limit: 500.
User personalized lobby: The endpoint provides a predefined and recommended list of games the player is likely to interact with next. The predicted list is based on player's historical interactions on the Hub88 platform. The response of the endpoint is a mixture of games the player has played before and new games the player is likely to play next, based on their historical interactions.
The list of games is scored and ordered from high to low according to the likelihood of the player interacting with them.
Note: For new users with no historical interactions, initially top games based on overall unique users’ interactions are recommended (as in casino lobby recommendation). Subsequently, the player gets recommendations based on their personal playing history.
/recommendations/user_lobby
RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.
Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.
The device platform type for which game recommendations are provided. It's the current device platform the user is accessing the Operator's site from.
The unique user name of the player on Operator's side. The parameter is required to reference if a user exists on Hub88 platform, i.e. has launched a game at least once.
The language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.
The currency which has been currently enabled for the wallet on the site. This value can be provided to help improve the quality of recommendations, in a situation where user switches between multiple wallets (currencies) to play games on the site. Optional context parameter.
The country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.
The limits for the count of returned game recommendations. Default limit: 50, Maximum limit: 500.
Similar games recommendation: Endpoint recommends similar games to the game requested based on co-occurrence of interactions (game plays) on the requested game and other games in all recorded game plays on Hub88 platform.
The response game list contains popular games played by other players, who have also played the game in the request.
/recommendations/similar_games
RSA-SHA256 is used to sign the request body using a private key. The signature is validated using the public key associated with the provided operator_id.
Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.
The platform of the device Game gets recommendations for.
The Game reference code to recommend similar games for.
The language enabled for the user on the site, used to help improve the quality of recommendations. Optional context parameter.
The currency which has been currently enabled for the wallet on the site. This value can be provided to help improve the quality of recommendations, in a situation where user switches between multiple wallets (currencies) to play games on the site. Optional context parameter.
The country location provided to help improve the quality of the recommendation in a situation player plays from multiple locations (countries). Optional context parameter.
Limits the count of returned games in the response. Maximum is 500.