> 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/unity/installation.md).

# Installing the package

This is the one-time setup. You do it once per project; after that, adding placements takes seconds. No scripting required.

## 1. Add the package

The bxg SDK installs through Unity's Package Manager (UPM).

1. In Unity, open **Window → Package Manager**.
2. Click **+ → Install package from git URL** (or **Add package from tarball** if we sent you a `.tgz`).
3. Enter the URL we provide and confirm. Unity downloads and imports the package.

The package brings its own dependencies, including the model-loading library used for 3D placements, so there's nothing else to install by hand.

## 2. Connect your account

Open **Edit → Project Settings → bxg** and paste the **Project Key** we issued you. That's the only configuration step, and you do it once. It links the SDK to your studio's account so bookings and revenue attribute correctly — and it's why your individual placements never need a key of their own, just a slot ID.

## 3. Verify it's working

Drop one of the included **AdFace** prefabs into a scene (see [Your first ad surface](/documentation/unity/your-first-ad-surface.md)), set its slot ID, and press Play. The surface should fetch and display its booked creative. If you'd like us to walk through it live, we're happy to screen-share.

## Requirements

* **Unity 6.2** or later (the package targets the Unity 6 generation).
* Works with the **Built-in, URP, and HDRP** render pipelines.
* Outbound **HTTPS** to `adp.api.advertise-in.games` (and the asset host creatives are served from). If your build/test environment is locked down, allowlist those hosts. See [Requirements & compatibility](/documentation/requirements.md).

***

**On strict SDK policies:** if your studio has a hard "no third-party SDKs" rule, your engineers are welcome to review the full source on request, and we offer **Managed Integration** — we do the setup on the project with you. See the [FAQ](/documentation/reference/faq.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/unity/installation.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.