Skip to main content

​
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.