Ads

Pre-roll

An ad before the game starts. Plays when the player presses Start or first touches the board.

When it plays

The pre-roll fires the first time a player starts a game — whether they press the Start button or begin by interacting with the board. The ad plays in the game area, and the game begins the moment the ad finishes, is skipped, or errors. For a display banner, the game begins when the player taps Continue (or right away if no ad fills). The in-game timer does not start until the ad is over.

Setup

Configure pre-roll on your player in the Hub's Ads tab, then copy the embed snippet — no page-side ad code is needed. See the Ads overview for the full flow.

  1. Open your player → Ads tab → toggle Enable ads.
  2. Under Pre-roll, pick a format and enter your demand: a video ad (a Google Ad Manager network code + ad unit, or a full VAST tag) or a display banner (a network code + ad unit, plus a size like 300×250).
  3. Save and publish, then copy the embed snippet.

Demand

Pick a format, then provide its demand. These are the fields in the Pre-roll section of the Ads tab.

Format
"video" | "display" · default: "video"

Whether the pre-roll is a video ad or a display banner.

Network code
string

Your Google Ad Manager network code. Use together with the ad unit.

Ad unit
string

The ad unit path, without the leading network code (for example homepage or news/scores). Use together with the network code.

VAST tag
string

Video only. A complete VAST ad tag URL, used instead of network code + ad unit. Any pre-existing cust_params on the tag are preserved.

Banner size
string · default: "300x250"

Display only. The banner size to request, as width by height (for example 300x250).

Loading message
string · default: "Your game starts right after this ad"

The message shown over the loading screen while the ad loads.

Notes

  • One per play. A pre-roll can show each time a fresh game is started.
  • Display banners show your banner with a short countdown, then a Continue button to start the game.
  • Never blocks the game. If demand is unfilled or anything errors, the fail-safe lets the game start regardless.