Create Widget
Our ad widget inserts ad content into the code area specified by the publisher. Follow the instructions below and create the widget in your app:
1. Decide how to display the ad
General conditions
You can integrate the ad wherever it fits best in your application’s flow. This could be a screen component, a popup, or any other design element. We provide the ad content (images, text, etc.), while you control placement and styling.
1.1 Choose Ad formats
Сhoose one of these ad formats, or install both to increase your income (each format requires its own widget):
Text-Graphic Block (TGB)
Native text-and-image unit that integrates into app’s content for a seamless user experience. Multiple ads can be shown within one widget.
Fullscreen Banner Telegram-style fullscreen ad that aligns with interface and maximizes user engagement. Only one ad can be shown at a time.
Detailed descriptions of ad formats with examples can be found in our documentation.
1.2 Choose Integration options
Each ad format can be integrated into your app in different ways. It should be natively integrated into the user experience to feel natural and non-intrusive. Choose one option for each widget described below that best meet your app’s needs and objectives:
Rewarded Ad The user should receives a reward for interact with the ad:
for TGB ads — a reward is given for clicking the ad (CPC)
for Fullscreen ads — a reward is given for watching the entire ad (CPM)
Examples of rewards: additional attempts, in-app currency, boosters, or any other bonus suitable for your app.
Non-Rewarded Ad The user does not receive any reward for interacting with the ad:
for TGB ads — the ad should be organically placed within the interface. For example, as a standalone ad block embedded into a content page.
or Fullscreen ads — The ad should appear as a result of user action or at natural breakpoints in the flow. For example, after clicking a “watch ad” button or between game levels.
2. Add widget in the account
In your personal dashboard go to the Publisher section, then to the Widgets subsection. Click the “Create Widget” button and specify the required parameters:

3. Get widget ID
Once the widget is created, a dashboard with a list of widgets will open, displaying the widget ID. You will need this widget ID in the next step — embedding it into your code

Last updated