> For the complete documentation index, see [llms.txt](https://brandsxgames.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brandsxgames.gitbook.io/documentation/readme.md).

# bxg SDK

bxg is a managed platform for immersive brand and product placement inside games. We place real-world brands as part of the world — flat surfaces like a poster on a wall or a banner trackside, and full 3D products a player can walk up to, like a branded can on a shelf or an item on a desk. Not pop-ups, not interstitials, nothing that interrupts play; a placement reads as set dressing because that's what it is.

Control stays with you on both sides. You position every placement yourself, so nothing shows up anywhere you didn't put it — and you approve or decline every campaign that runs, down to ruling out whole categories that don't fit your game's tone or audience. A placement you haven't cleared never ships.

The integration is deliberately small: drop one of our placement actors into your scene — a 2D surface or a 3D product — point it at a slot we issue you, and ship, with no changes to your game code or build. Campaigns then rotate on that slot from our side, so a single integration keeps running without you touching the game again.

This documentation is for studios evaluating or running that integration.

## What the SDK actually does

* Fetches the currently booked creative for each ad surface from the bxg API — a 2D image or a 3D model.
* Displays it on a surface or at a placeholder you position (a wall, a billboard, a product on a shelf).
* Measures how long each placement is actually in the player's view and reports that back for billing and reporting.
* Falls back to content you choose whenever there's no active campaign or no connection — so a placement is never blank or broken.

## What it does **not** do

* It does not change your game's code. The integration is an actor you drop into a level and configure in the editor.
* It does not hook into your gameplay, your save system, or your build pipeline.
* It does not insert anything you didn't place. You decide where placements live, how big they are, and which way they face.
* It does not show interstitials, pop-ups, autoplay video, or anything that interrupts play.

## What integration involves, honestly

There are two separate things people tend to blur together:

1. **One-time setup** — installing the plugin, enabling it, and pasting your bxg project key once. Budget a few minutes. See [Installing the plugin](/documentation/unreal-engine/installation.md).
2. **Adding a placement** — placing an ad actor and setting its slot. This is genuinely a matter of seconds, and you repeat it wherever you want a placement. See [Your first ad surface](/documentation/unreal-engine/your-first-ad-surface.md).

If you want the full picture before you touch the editor, start with [How it works](/documentation/how-it-works.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://brandsxgames.gitbook.io/documentation/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.