Xtremepush's Games Hub provides interactive promotional games (Wheels, Slots, Roulette, Bracket Predictor, etc.) that can be embedded into websites and mobile apps via iFrame. Integration involves three main client-side tasks:
1. Asset Pack Preparation
Each game includes a standard asset pack that can be customised with client branding. To customise your game design you can simply replace the default game assets with your own customised versions while retaining the existing game layout. This method is ideal for branding or changing the visual elements of a game without altering its structural design. For Casino type games some layout changes can also be supported via an in-built game editor some example use cases are included in the documentation here. Just updating the asset packs works well for most clients.
2. Authentication Setup
Games use JWT authentication to enable personalisation, prize eligibility, and play frequency controls.
Client Responsibility: Generate and sign JWT tokens server-side using HS256 algorithm. Token payload must include the user's ID (matching the ID used in Xtremepush profiles):
{
"account": "USER_ID_STRING",
"expiration": "2025-01-27T15:31:00Z"
}
Xtremepush provides the shared secret via the platform. Token is appended to the game iFrame URL. Full JWT implementation guide here.
3. Game Configuration and Deployment
Game Configuration (Platform-Side)
Once the asset pack and authentication is set up, other relevant game settings can be configured within the Xtremepush platform to get the game ready for launch. Specific settings will vary per game but some common examples include:
Targeting & segmentation - Control who sees the game
Play frequency limits - Once per day, per campaign, etc.
Winning probabilities - Configure odds per prize tier
Prize configuration - Link to bonus engine or configure codes/vouchers
Game win events can be used to trigger campaigns
Full game launch workflow documentation here.
Note: Segmentation assumes some user data is flowing to Xtremepush and to have automated prize fulfillment this assumes a bonus engine integration is configured.
Game Deployment (iFrame Embedding)
Each game campaign generates a unique iFrame URL for embedding:
Web:
<iframe src="https://gamify.xtremepush.com/game/[GAME_ID]?token=[JWT_TOKEN]"
width="100%" height="600px" frameborder="0">
</iframe>
Mobile (WebView): Standard WebView implementation loading the game URL with token parameter.
Games are responsive and work across desktop/mobile. Documentation here.
4. Platform-Generated Game Events
Once a game campaign is live, Xtremepush automatically generates real-time events for each player interaction. These are platform-side events — no client-side implementation is required. They follow the naming format <game_name>_game_created and <game_name>_prize_won (e.g. wheels_game_created, thunderboard_prize_won) and are available on each user's profile under Data > User Profile > Events.
These events can be used to trigger follow-up campaigns — for example, sending a congratulatory message or bonus offer when a player wins a prize. See the full events reference.