Modal Customization

The ZBD rewards modal is a WebView delivered inside your game. You control the visual branding — colors, background, graphics, and logo — while ZBD controls the layout and functionality. Customization assets are submitted to your ZBD Customer Success Manager before go-live. The modal is not self-serve configurable from the dashboard.

You can customize colors and graphics. You cannot customize layouts, screen structure, or the cashout flows.

Colors

Eight color parameters control the look of the modal. All accept hex values.

Parameter	What it affects
Background	Main background of the modal. Accepts a color or image.
Primary Font Color	Main body text color.
Primary CTA Color	Background color of primary buttons (e.g. “Cash Out”).
Primary CTA Font Color	Text color on primary buttons.
Secondary Background Color	Background color of cards and panels within the modal.
Secondary Font Color	Secondary and label text color.
Secondary CTA Color	Background color of secondary buttons.
Secondary CTA Font Color	Text color on secondary buttons.

Graphics

Four image assets can be provided. Supply these at the specified dimensions for best results.

Asset	Dimensions	Notes
Background Image	1200 × 1200px	Used as the modal background. Overrides the background color if provided.
Tutorial Image	500 × 500px	Shown in the first-time user experience (FTUE) screen.
Current Balance Coin Graphic	280 × 400px	Displayed on the balance screen alongside the player’s current balance.
Coin Graphic	100 × 100px	Used inline throughout the modal to represent your reward currency.

Copy

Element	Limit	Notes
Tutorial copy	50 characters	Text shown on the FTUE screen introducing the rewards feature to the player.

50 characters is too short for the most important line in your rewards copy — the reason rewards are real (“Game studios share their ad revenue with players…”). Ship that line with a first-open creative instead, and keep the FTUE copy to a short hook. The modal’s built-in button copy (e.g. “Cash Out”) is part of the fixed layout and can’t be customized.

Other

Element	Notes
Logo	Square format. Displayed within the modal header.
Deep link URL	Your game’s URL scheme (e.g. `mygame://`). Used to redirect players back to the game after account linking. See URL Scheme.

How to submit

Send your assets to your ZBD Customer Success Manager using the template they provide. Allow time for the modal to be configured and tested in sandbox before your go-live date. If you haven’t been assigned a Customer Success Manager yet, contact us.

Overview

Concepts

Setup

Sending Rewards

Balances & Limits

Developer Dashboard

Best Practices & Engagement

Go Live

API Reference

Colors

Graphics

Copy

Other

How to submit

​Colors

​Graphics

​Copy

​Other

​How to submit

Colors

Graphics

Copy

Other

How to submit