# Bonus Round

> Bonus Round is an ad network for three.js games. Developers add one script tag and one attach line, then `await BonusRound.break('intermission')` at natural breaks; a 15-second branded Bonus Round takes over the game with the player's own character and controls, paired with a branded prop in the world. Developers earn 70% of spend.

Install in three lines:

```html
<script async src="https://bonusround.io/v1/br.js" data-pub="pub_XXXXXXXX"></script>
```
```js
(window.bonusround = window.bonusround || []).push((BR) => BR.attach({ THREE, scene, camera, renderer }));
await window.BonusRound?.break('intermission'); // at a natural break: round end, level complete, death/respawn
```

New games are in test mode and always get the fictional Fizzpop Soda test ad (never billed). Verify an install by loading the game and polling `GET /api/games/:id` until `integration.lastSeenAt` is set. REST auth is `Authorization: Bearer br_sk_…`; money is integer micros (1 USD = 1,000,000).

## For AI coding agents

- [Integration recipe](https://bonusround.io/integrate.md): step-by-step instructions for integrating Bonus Round into a three.js game, verifying it and reporting back. Start here.
- [Integrate with AI agents](https://bonusround.io/docs/agents): MCP server setup for Claude Code, Cursor and Codex, the CLI and the Claude Code skill.
- [Full docs as text](https://bonusround.io/llms-full.txt): every docs page in one file.

## Docs

- [Quickstart](https://bonusround.io/docs/): five minutes to a test Bonus Round.
- [Install](https://bonusround.io/docs/install): script tag, Vite, webpack, React Three Fiber, vanilla, TypeScript types.
- [attach() & host adapter](https://bonusround.io/docs/attach): overlay vs native takeover, the host adapter contract, the full SDK surface.
- [Formats & triggers](https://bonusround.io/docs/formats): intermission `break()`, interval offers and `safe()`, `rewarded({ onReward })`, ambient props, `placeAmbient()` hints, portals.
- [Test mode & Fizzpop](https://bonusround.io/docs/test-mode): the house test ad, `break('test')`, troubleshooting.
- [Going live & ads.txt](https://bonusround.io/docs/going-live): domains, the ads.txt line, turning test mode off, floors.
- [Events & measurement](https://bonusround.io/docs/events): impression, viewable, engagement, complete, click; what's billed; `BonusRound.on()` events.
- [Brand safety & categories](https://bonusround.io/docs/brand-safety): ratings, game categories, blocked advertiser categories, creative review.
- [Payouts](https://bonusround.io/docs/payouts): 70% of net ad revenue (spend minus any disclosed agency commission), net-30, $50 minimum, Stripe Connect Express.

## Reference

- [REST API](https://bonusround.io/docs/api): API keys, games, snippets, verification, settings, stats, earnings, ad serving, the hosted MCP endpoint.
- [FAQ](https://bonusround.io/docs/faq): performance, ad blockers, multiplayer, mobile, iframes, unfilled reasons.

## Optional

- [MCP endpoint](https://bonusround.io/mcp): streamable HTTP MCP server; send `Authorization: Bearer br_sk_…`.
- [Claude Code skill](https://bonusround.io/docs/skill/SKILL.md): the integrate-bonus-round skill file.