# Creating Ad Surfaces in the Portal

### :bricks: About Ad Surfaces

**Ad Surfaces** are visual ad placements that exist at the game level. They aren't tied to specific in-game objects, making them simple to manage and ideal for both banner and video ads. These surfaces, once created, can be used across SDKs in Unity, Unreal, and Phaser.

***

### 🧭 Step 1: Access Your Game

* From your **Organization’s game list**, select the game you want to work with.
* Navigate to the **Ad Surfaces** tab.
* Click **+ New Ad Surface**.

<figure><img src="/files/5fX5fo6R1R0gCjeDQ4vz" alt=""><figcaption></figcaption></figure>

***

### ⚙️ Step 2: Configure the Ad Surface

<figure><img src="/files/IOEgrWwuu82Pl46phFVN" alt=""><figcaption></figcaption></figure>

Fill in the following fields:

* **Ad Type** – Choose the type of ad this surface will display:
  * `Banner` (image)
  * `Video` (auto-playing clip)
* **Resolution** – Define the display resolution (e.g., 300x250, 1024x512). This determines how the ad scales in your game.
* **Interactivity** – Choose one of the following:
  * `Static`: Non-clickable
  * `Interactive`: Clickable (opens landing pages or in-game actions)
* **Targeting Tags** – Add keywords that describe where the ad will appear or what kind of gameplay surrounds it (e.g., `"urban"`, `"sci-fi"`, `"puzzle"`). These improve ad targeting and campaign relevance.
* **Placeholder File** – Upload a fallback image or video that will be shown if no active ad is available.

***

### ✅ Step 3: Save & Generate

* Click **Add** to finalize the ad surface.
* A **unique Ad Surface ID** will be generated automatically—used to link this surface to in-game placements through the SDK.

<figure><img src="/files/3ieHDkfyRi4gkZuTuJgY" alt=""><figcaption></figcaption></figure>

***

### 🎮 Step 4: Use It In Your Game

Once created, this Ad Surface will sync automatically to your SDK when you click **Sync Game Assets** inside:

* Unity’s **ReneVerse Settings**
* Unreal’s **ReneVerse API Editor**
* Phaser’s **PhaserHooks setup**

You can now place, serve, and track this ad surface directly from within your game engine.


---

# Agent Instructions: 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://docs.reneverse.io/publisher-flow/defining-placeholders-in-the-portal/creating-ad-surfaces-in-the-portal.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.
