> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uptopia.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Advertisements (in development)

> Use UptopiaKit’s advertisement network to show ads from the Uptopia ecosystem in your miniapp and earn income per engagement and click.

# Advertisements (in development)

> **Status:** The Advertisements feature is currently under active development. Behavior, UI, and contracts may change before the final release.

UptopiaKit is built as an ecosystem of **many miniapps, games, and experiences**. As that ecosystem grows, **discovery and promotion** become critical for every developer.

The **Advertisements** feature is designed to:

* Help developers **promote their own apps/games** inside the Uptopia ecosystem.
* Give other apps a way to **monetize via curated ads** from Uptopia and other developers.
* Grow the overall ecosystem on Base by **cross-promoting** great products.

## What the Ads system is

UptopiaKit maintains a **list of ads** registered by:

* The **Uptopia team** (official campaigns).
* Other **developers** in the ecosystem who want to promote their apps.

Each ad entry can include:

* **Title** — short text explaining the ad/campaign.
* **Image/creative** — the visual shown in your app.
* **Placement configuration** — information about where/how it can be displayed.
* **Payout model** — income per **engagement** and/or **click** that your app can earn.

When you enable ads for your app, UptopiaKit will surface this list so that you can decide **which ads to show and where**.

## Ad placements in your app

For every app built on UptopiaKit, there are up to **three standard positions** where ads can be displayed:

* **Upper center**
* **Center**
* **Lower center**

Developers can:

* Choose whether to **enable or disable ads** entirely for their app.
* For each placement, **decide whether to show an ad**.
* **Pick specific ads** from the list provided by UptopiaKit (Uptopia + other dev campaigns).

From the user’s perspective:

* Ads are shown in the selected positions within your app.
* **Users can always close the ad** to avoid hurting the core experience.
* You remain in control of **how ads are integrated into your UI/UX** (e.g., when to show them, what screens to use, etc.), within the allowed placement types.

## Earnings from engagements and clicks

When your app shows ads:

* UptopiaKit tracks **engagements** and **clicks** for the ads displayed in your app.
* Based on the configured payout model for each ad, UptopiaKit **calculates income** for your app.
* Earnings are **credited clearly to your developer wallet** and surfaced in the UptopiaKit dashboard (for example, in income and history views).

In short:

* You opt in to show ads.
* Users interact with these ads (engagements, clicks).
* UptopiaKit measures those interactions and **rewards you transparently**.

## Building the ecosystem together

UptopiaKit encourages developers to:

* **Run their own campaigns** to promote their apps across the ecosystem.
* **Opt in to show ads from others**, earning income while helping grow the network.
* Treat Ads as a way to **discover new games/miniapps** and **support each other** on Base.

By combining:

* Many high-quality apps built on UptopiaKit, and
* A shared Ads system with fair rewards,

the goal is to create a **healthy, self-reinforcing ecosystem** for everyone.

## Current status and limitations

* The Advertisements feature is **still in development** and is **not yet finalized**.
* Details such as:
  * Exact configuration flows in the dashboard,
  * Supported payout models,
  * How often ads can be shown,
  * And how income appears in analytics,
    may change as the feature evolves.
* Until the feature is fully launched, **you should treat this documentation as a preview** of how Ads will work rather than a stable API contract.

As the feature rolls out, UptopiaKit will update this page with:

* Concrete configuration steps in the dashboard.
* Any App Events or APIs related to Ads (if exposed).
* More details on how income and history are displayed to developers.